Uw migratie implementeren

Uw agent in fasen migreren

Benader uw migratie in fasen, zodat u deze later gemakkelijker kunt stabiliseren en oplossen.

1. Migreer uw agent zoals deze is.

   Begin met een baselinemigratie van alle subagenten, instructies en acties. Zet het verouderde agentontwerp op in de nieuwe samensteller en controleer of het end-to-end werkt.

2. Identificeer en herstel eventuele regressies.

   Als u regressies wilt identificeren, controleert u de syntaxis van het Agent-script van uw agent en controleert u op fouten in de samensteller. Voer vervolgens dezelfde handmatige en batchtests uit die u eerder hebt uitgevoerd om de baseline van uw agent vóór de migratie vast te stellen.

   • Alles wat in de agent in de verouderde samensteller werkte en niet in de nieuwe samensteller, is een regressie.
   • Al het andere is een verbetering of een uitbreiding.

   Corrigeer eventuele regressies voordat u andere wijzigingen aanbrengt, zodat u problemen kunt isoleren en oplossen. Als er iets kapot is na de basismigratie, weet u dat dit het resultaat is van de migratie en niet van een wijziging die u hebt aangebracht.

   

   Tip Agentforce gebruiken om uw agent te upgraden maakt problemen zoals validatiefouten minder waarschijnlijk. Elke wijziging in redenering kan echter van invloed zijn op de prestaties van agenten. Het is belangrijk om uw agent end-to-end te testen vanwege de verschillen in het gegevensmodel en de onderliggende redeneerengine tussen de oudere en de nieuwe samensteller.
3. Verhard en verbeter uw agent met Agent-script.

   Nadat uw baselineagent stabiel is in de nieuwe samensteller, kunt u wijzigingen aanbrengen om de betrouwbaarheid en prestaties van uw agent te verbeteren. Op dit punt kunt u de mogelijkheden van Agent Script benutten om dingen te corrigeren die nooit echt hebben gewerkt in de verouderde samensteller en strategisch determinisme introduceren om voorspelbaarheid en consistentie toe te voegen.

4. Breid uw agent uit.

   Op een bepaald moment in uw agentmigratie kunt u de sirenezang van uw agentverlanglijst horen en overwegen om de mogelijkheden van uw agent uit te breiden naar nieuwe subagenten, gebruikscases of integraties. Weersta de drang om te vroeg uit te breiden. Focus op uw agentmigratie voordat u nieuwe functionaliteit introduceert. Als u te veel tegelijk doet, vooral voordat uw agent stabiel is in de nieuwe samensteller, riskeert u dat de architectuur van uw agent vervuild raakt en dat problemen moeilijker te traceren, isoleren en op te lossen zijn.

Wijzigingen aanbrengen in kleine batches en testen na elke batch

Of u nu regressies corrigeert of uw agent verhardt met Agent-script, voorkom dat u in één keer veel wijzigingen aanbrengt. Dit kan het moeilijker maken om eventuele problemen die uw wijzigingen kunnen veroorzaken (bijvoorbeeld een compileerfout) te isoleren en te testen, vooral als u externe AI-coderingstools gebruikt. Benader uw wijzigingen iteratief om verbeteringen te meten, resultaten te documenteren en regressies te minimaliseren.

• Breng eerst structurele en architectonische wijzigingen aan en pas daarna de aanpassingen aan.
• Test na elke wijziging en houd uw meetgegevens bij ten opzichte van uw baseline.
• Verbied uw agent en maak nieuwe versies na belangrijke wijzigingen, geen kleine correcties. Lees meer over de levenscyclus van versiebeheer en bewerking van agenten in de nieuwe samensteller.

Tips voor testen

Testen is essentieel voor het vaststellen van een baseline, het objectief meten van resultaten en verbeteringen, en het minimaliseren van regressies. Wanneer u migreert, zijn er wijzigingen in de redenering en instructies van uw agent, die van invloed kunnen zijn op het gedrag van agenten. Welke migratietool of -tools u ook gebruikt, plan zorgvuldig te testen, aan te passen en opnieuw te testen om ervoor te zorgen dat uw agent presteert zoals verwacht.

• Test aan het begin van elke fase van uw agentmigratie en opnieuw na elke batch wijzigingen. Plan om vroeg en vaak te testen, inclusief:
  • Voordat u migreert, stelt u een eerste baseline vast en identificeert u problemen.
  • Na uw initiële migratie stelt u een baseline vast in de nieuwe samensteller en identificeert u regressies.
  • Na elke grote wijziging of batch kleine wijzigingen
• Maak een testplan dat handmatig testen in Agentforce Builder en batchtesten in Agentforce-testcentrum omvat. Voer hetzelfde plan uit om bij te houden ten opzichte van uw baseline. Een goed testplan omvat minimaal:
  • Kernfunctionaliteit van agenten, zoals het maken van cases, het boeken van afspraken, het bijhouden van orders of veelgestelde vragen met de actie Vragen beantwoorden met Knowledge.
  • Identiteiten die zijn gebaseerd op echt gebruikersgedrag, zoals geauthenticeerde gebruikers, niet-geauthenticeerde gebruikers, ongeduldige of ongelukkige gebruikers, gebruikers die veel met elkaar praten.
  • Een reeks eenvoudige en complexere scenario's, waaronder gesprekken met meerdere beurten, gebruikscases voor meerdere subagenten en randcases.
• Als u klantenverificatie hebt geïmplementeerd, inclusief filteren op basis van de variabelen verifiedCustomerId of isVerified, test u expliciet het gedrag van uw agent als een niet-geverifieerde eindgebruiker en als een geverifieerde eindgebruiker. Bekijk in de nieuwe samensteller een voorbeeld van uw agent in de live testmodus. Als u geverifieerde en niet-geverifieerde gebruikers wilt simuleren, overschrijft u op het tabblad Variabelen de waarden van alle variabelen die u gebruikt om de resultaten van klantverificatie of geverifieerde klant-ID's op te slaan.
• Test expliciet op abrupte wijzigingen in het gesprek tussen agenten. Gebruikers kunnen overschakelen van verzoeken naar koetjes en kalfjes, nieuwe verzoeken indienen voordat hun huidige verzoek is voltooid, of anderszins van gespreksonderwerp veranderen. Hoewel agenten zich kunnen aanpassen, kunt u problemen met wisselen van onderwerp snel over het hoofd zien als u er niet naar op zoek bent. Als u effectief wilt testen, wijzigt u het onderwerp drie of vier keer in een voorbeeldgesprek om betrouwbaar gedrag van agenten te verifiëren.
• Testmogelijkheden verschillen tussen de oudere samensteller en de nieuwe samensteller, zowel voor handmatig testen als voor batchtesten. Maak kennis met de testtools die voor elke tool beschikbaar zijn. Plan om dezelfde functionaliteit, identiteiten en scenario's te testen voor alle bestaande en nieuwe tools, zodat u meetgegevens zo nauwkeurig mogelijk kunt vergelijken.

Tips voor het werken met externe AI-tools

Agenten zijn metagegevens en Agent Script is zeer draagbaar, dus u hebt de flexibiliteit om tools met weinig code, pro-code en externe tools te gebruiken voor het migreren en verbeteren van uw agent. Gebruik een combinatie van de tools die het beste voor u werken, maar houd deze tips voor het werken met tools van derden in gedachten.

• Externe AI-coderingstools hebben niet altijd de juiste syntaxis voor Agent-scripts, zelfs niet met Agentforce vaardigheden geladen. Download de officiële Agent Script-documentatie en deel deze met uw codeeragent. Controleer door AI gegenereerde wijzigingen altijd handmatig voordat u ze accepteert en neem wijzigingen indien nodig opnieuw op in de geldige syntaxis van Agent-script. Raadpleeg bij twijfel de Agent Script-documentatie in de Agentforce Developer Guide en gebruik AI voor een second opinion.
• Haal het maximale uit Claude, Cursor en andere AI-tools door duidelijke beperkingen en doelen te definiëren. Duidelijkheid over succescriteria helpt deze tools navolgbare resultaten te bieden. Zo zullen algemene verzoeken zoals "mijn agent verbeteren" op zichzelf waarschijnlijk geen effectieve resultaten opleveren. De kans is groter dat u een beter resultaat krijgt als u een specifieker verzoek doet (bijvoorbeeld "zorg ervoor dat de agent altijd de aanspraak op orders controleert voordat deze een retour probeert te verwerken"). En het delen van deze migratiehandleiding als context kan de AI-tools helpen uw vereisten te begrijpen en effectieve benaderingen voor te stellen.
• Er is meer dan één manier om met AI-tools te werken en u hoeft niet uw gehele agent in één keer te optimaliseren. Als u niet de gewenste resultaten behaalt of het moeilijk vindt om grote veranderingen in het ontwerp en gedrag van uw agent te begrijpen, behandelt u de AI-tools meer als strategische partners en bijdragers dan als onafhankelijke contractanten. U kunt ze herhalend gebruiken om specifieke, afzonderlijke problemen te diagnosticeren, benaderingen te valideren en oplossingen te implementeren. Hier zijn enkele voorbeelden van effectieve, hapklare werkstromen.
  • Wanneer u een AI-coderingstool met vooraf geladen vaardigheden gebruikt om een wijziging aan te brengen, controleert u de wijziging in de planmodus. Vraag het bedrijf om uit te leggen waarom het specifieke wijzigingen heeft aangebracht om ontwerpbeslissingen aan te vechten en te valideren, en om te bepalen wat het beste pad voorwaarts is. Voer vervolgens de wijziging in de agentmodus uit.
  • Controleer een instructie handmatig en noteer aanbevolen wijzigingen. Vraag in de vraagmodus naar een AI-perspectief op uw wijzigingen. Is AI het daarmee eens, wat zou het anders doen en waarom? Gebruik dit proces om te bepalen welke wijzigingen moeten worden behouden. Voer de wijzigingen in de agentmodus vervolgens in kleine batches uit.

Tips voor het werken in teams

Het wordt momenteel afgeraden om tegelijkertijd aan dezelfde agent in de samensteller samen te werken. Maar er zijn manieren om effectief samen te werken aan uw agentmigratie.

• Beschouw naast AI-beoordeling van alle wijzigingen peer review als een kwaliteitscontrole voordat u wijzigingen aan agenten doorvoert.
• Beperk samenwerking voor meerdere spelers tot eenvoudige, op zichzelf staande problemen en oplossingen.
• Elke samensteller moet in zijn eigen kopie van de agent werken. Diffueer en voeg de kopieën vervolgens handmatig samen. Net als vele andere stappen in deze handleiding kunt u AI gebruiken om hierbij te helpen.