Implementera din migrering

Migrera din agent i faser

Närma dig din migrering stegvis så att det blir enklare att stabilisera och felsöka senare.

1. Migrera din agent som den är.

   Börja med en grundläggande migrering av alla underagenter, instruktioner och åtgärder. Stå upp för den äldre agentdesignen i den nya byggaren och bekräfta att den fungerar från början till slut.

2. Identifiera och åtgärda eventuella regressioner.

   För att identifiera regressioner, verifiera din agents Agent Script-syntax och kontrollera om det finns några fel i byggaren. Kör sedan samma manuella tester och batchtester som du körde tidigare för att fastställa din agents baslinje innan migreringen.

   • Allt som fungerade i agenten i den äldre byggaren och inte fungerar i den nya byggaren är en regression.
   • Allt annat är en förbättring eller en förbättring.

   Åtgärda eventuella regressioner innan du gör andra ändringar, så att du kan isolera och felsöka problem. Om något är trasigt efter den grundläggande migreringen vet du att det är ett resultat av migreringen och inte en ändring du har gjort.

   

   Tips Att använda Agentforce för att uppgradera din agent gör problem som valideringsfel mindre troliga. Alla ändringar i resonemanget kan dock påverka agenters resultat. Det är viktigt att testa din agent från början till slut på grund av skillnaderna i datamodellen och den underliggande resonemangsmotorn mellan den äldre och den nya byggaren.
3. Härda och förbättra din agent med Agentskript.

   När din baslinjeagent är stabil i den nya byggaren kan du börja göra ändringar för att förbättra din agents pålitlighet och prestanda. Här kan du dra nytta av de kapaciteter som Agent Script har att erbjuda för att åtgärda saker som aldrig riktigt fungerade i den äldre byggaren och strategiskt introducera determinism för att lägga till förutsägbarhet och enhetlighet.

4. Utöka din agent.

   Någon gång i din agentmigrering kanske du hör sirenlåten från din agents önskelista och funderar på att utöka din agents kapacitet till nya underagenter, användningsfall eller integreringar. Motstå lusten att expandera för tidigt. Fokusera på din agentmigrering innan du introducerar ny funktionalitet. Att göra för mycket på en gång, särskilt innan din agent är stabil i den nya byggaren, riskerar att söndra din agents arkitektur och göra problem svårare att spåra, isolera och felsöka.

Gör ändringar i små satser och testa efter varje sats

Oavsett om du åtgärdar regressioner eller härdar din agent med Agentskript, undvik att göra många ändringar samtidigt. Detta kan göra det svårare att isolera och testa problem som dina ändringar kan skapa (till exempel ett kompileringsfel), särskilt om du använder AI-kodningsverktyg från tredje part. Närma dig dina ändringar iterativt för att mäta förbättringar, dokumentera resultat och minimera regressioner.

• Gör strukturella och arkitektoniska ändringar först, och anpassa sedan ändringarna efter.
• Testa efter varje ändring och följ dina mått mot din baslinje.
• Lämna in din agent och skapa nya versioner efter betydande ändringar, inte små fixar. Läs mer om livscykeln för agentversioner och -redigering i den nya byggaren.

Tips för test

Tester är viktiga för att etablera en baslinje, objektivt mäta resultat och förbättringar och minimera regressioner. När du migrerar sker ändringar av din agents resonemang och instruktioner, vilket kan påverka agenters beteende. Oavsett vilket eller vilka migreringsverktyg du använder, planera att noggrant testa, justera och testa igen för att se till att din agent presterar som förväntat.

• Testa i början av varje fas i din agentmigrering och igen efter varje sats med ändringar. Planera att testa tidigt och ofta, inklusive:
  • Innan du migrerar, för att etablera en inledande baslinje och identifiera problem.
  • Efter din inledande migrering, för att etablera en baslinje i den nya byggaren och identifiera regressioner.
  • Efter varje större ändring eller sats av små ändringar
• Skapa en testplan som inkluderar manuella tester i Agentforce Builder och batchtester i Agentforce Testcenter. Kör samma plan för att jämföra med din baslinje. En bra testplan omfattar minst:
  • Huvudfunktioner för agenter, som att skapa kundcase, besöksbokning, orderspårning eller vanliga frågor med åtgärden Svara på frågor med Knowledge.
  • Personas baserade på verkligt användarbeteende, till exempel inloggade användare, ej inloggade användare, otåliga eller olyckliga användare, användare som ägnar sig åt mycket småprat.
  • En rad enkla och mer komplexa scenarion, inklusive flergångskonversationer, användningsfall för flera underagenter och kundcase med kanter.
• Om du har implementerat kundverifiering, inklusive filtrering baserad på verifiedCustomerId eller isVerified, testa uttryckligen din agents beteende som en ej verifierad slutanvändare och som en verifierad slutanvändare. I den nya byggaren, förhandsgranska din agent i livetestläget. För att simulera verifierade och ej verifierade användare, åsidosätt värdena för alla variabler du använder för att lagra resultaten av kundbekräftelse eller verifierade kund-ID:n på fliken Variabler.
• Uttryckligen testa för plötsliga ändringar i agentkonversationen. Användare kan växla från begäranden till småprat, göra nya begäranden innan deras aktuella begäran är klar, eller på annat sätt byta samtalsämne. Även om agenter är anpassningsbara kan problem med ämnesväxling vara lätta att missa om du inte letar efter dem. För att effektivt testa, byt ämne tre eller fyra gånger i en förhandsvisningskonversation för att verifiera pålitligt agentbeteende.
• Testkapaciteten skiljer sig åt mellan den äldre byggaren och den nya byggaren, för både manuella tester och batchtester. Bekanta dig med de testverktyg som finns för varje. Planera att testa samma funktionalitet, personas och scenarion i de äldre och nya verktygen så att du kan jämföra mått så korrekt som möjligt.

Tips för att arbeta med AI-verktyg från tredje part

Agenter är metadata och Agentskript är mycket portabelt, så du har flexibiliteten att använda verktyg med låg kod, prokod och tredjepartsverktyg för att migrera och förbättra din agent. Använd en kombination av de verktyg som fungerar bäst för dig, men tänk på dessa tips för att arbeta med tredjepartsverktyg.

• Verktyg för AI-kodning från tredje part får inte alltid Agent Script-syntaxen rätt, även om Agentforce är inlästa. Ladda ner den officiella Agent Script-dokumentationen och dela den med din kodningsagent. Granska alltid manuellt AI-skapade ändringar innan du accepterar dem och refaktorisera ändringar till giltig Agent Script-syntax om det behövs. Om du är osäker, se Agent Script-dokumentationen i Agentforce Developer Guide och använd AI för en andra åsikt.
• Få ut det mesta av Claude, Markör och andra AI-verktyg genom att definiera tydliga begränsningar och mål. Tydlighet om framgångskriterier hjälper dessa verktyg att ge användbara resultat. Till exempel är det inte troligt att allmänna förfrågningar som "förbättra min agent" ger dig effektiva resultat på egen hand. Det är troligare att du får ett bättre resultat om du gör en mer specifik begäran (till exempel "se till att agenten alltid kontrollerar om en order är berättigad innan den försöker bearbeta en retur"). Att dela denna migreringsguide som sammanhang kan hjälpa AI-verktygen förstå dina krav och föreslå effektiva metoder.
• Det finns mer än ett sätt att arbeta med AI-verktyg och du behöver inte optimera hela din agent samtidigt. Om du inte får de resultat du vill ha, eller om du har svårt att förstå breda ändringar av din agents design och beteende, behandla AI-verktygen mer som strategiska partners och medarbetare än oberoende entreprenörer. Du kan använda dem iterativt för att diagnostisera specifika, diskreta problem, validera metoder och implementera lösningar. Här är några exempel på effektiva arbetsflöden i lagom storlek.
  • När du använder ett AI-kodningsverktyg med förinlästa kompetenser för att göra en ändring, granska ändringen i planläget. Be den förklara varför den har gjort specifika ändringar för att utmana och validera designbeslut och avgöra den bästa vägen framåt. Utför sedan ändringen i agentläget.
  • Granska en instruktion manuellt och notera rekommenderade ändringar. I fråga-läget, be om ett AI-perspektiv på dina ändringar – håller AI med, vad skulle det göra annorlunda och varför? Använd denna process för att bestämma vilka ändringar som ska behållas. Utför sedan ändringarna i agentläget i små satser.

Tips för att arbeta i team

För närvarande rekommenderar vi inte att samarbeta kring samma agent i byggaren samtidigt. Men det finns sätt att arbeta effektivt tillsammans med din agentmigrering.

• Utöver AI-granskning av ändringar, överväg peer review som en kvalitetskontroll innan du utför agentändringar.
• Begränsa samarbete med flera spelare till enkla, fristående problem och fixar.
• Varje byggare ska arbeta i sin egen kopia av agenten. Diffa och koppla sedan kopiorna manuellt. Precis som många andra steg i denna guide kan du använda AI för att hjälpa till med detta.