Kör agentelement
Använd en Agentforce agent för att hantera uppgifter dynamiskt i ditt flöde. Välj en befintlig agent eller skapa en agent med egna instruktioner och åtgärder.
Versioner som krävs
Behörigheter
För att använda befintliga agenter i dina flöden behöver du användarbehörigheten Visa inställningar. För att skapa agenter från Flow Builder behöver du användarbehörigheterna Anpassa program, Einstein Copilot Builder, Einstein Agent Platform Builder eller Självbetjäningscopilot Builder. Användare med profilen Systemadministratör kan både skapa och använda agenter.
Om du inte har behörighet att skapa agenter visas inte knappen Skapa agent i agenturvalspanelen. Du kan endast välja befintliga agenter.
Användning
Lägg till ett Kör agent-element i ditt flöde. Sök efter och välj en aktiv agent i fältet Agent eller klicka på Skapa agent för att bygga en ny.
Välj en befintlig agent
För att använda en befintlig agent, sök efter agenten med dess namn i fältet Agent. Endast aktiva agenter visas i listan. När du har valt en agent, konfigurera agentens indata och utdata i egenskapspanelen.
Skapa en ny agent
För att skapa en agent, klicka på Skapa agent. I fönstret Ny agent, konfigurera agentens grundläggande information.
| Fält | Beskrivning |
|---|---|
| Etikett | Agentens namn. |
| API-namn | Kravet på unika namn gäller bara element inom det aktuella flödet. Två element kan ha samma API-namn under förutsättning att de används i olika flöden. API-namnet kan omfatta understreck och alfanumeriska tecken utan mellanslag. Det måste börja med en bokstav och kan inte sluta med ett understreck. Det kan inte heller ha två efterföljande understreck. |
| Beskrivning | En beskrivning av vad agenten gör. |
| Användaråtkomst | Den användarpost som agenten körs som. Välj en befintlig användare eller låt systemet skapa en användare. |
| Instruktioner | Instruktioner som beskriver vad agenten gör och guidar dess resonemang. |
| Åtgärder | De åtgärder som agenten kan använda. Välj befintliga åtgärder från tillgångsbiblioteket eller skapa egna åtgärder. |
Lägg till åtgärder till agenten
Agenten behöver minst en åtgärd för att utföra uppgifter. Lägg till åtgärder innan du klickar på Skapa och aktivera eller i Agentforce Builder efter att du har aktiverat agenten.
För att välja befintliga åtgärder, klicka på Välj åtgärder. Sök efter och välj en eller flera åtgärder från tillgångsbiblioteket och klicka sedan på Lägg till i agent. Tillgängliga åtgärder inkluderar Knowledge åtgärder, flöden konfigurerade som åberopbara åtgärder och standardåtgärder.
För att skapa en åtgärd, klicka på Skapa åtgärd. I fönstret Skapa åtgärd, konfigurera åtgärden.
| Fält | Beskrivning |
|---|---|
| Etikett för agentverktyg | Namnet på åtgärden. |
| API-namn | Kravet på unika namn gäller bara element inom det aktuella flödet. Två element kan ha samma API-namn, förutsatt att de används i olika flöden.Ett API-namn kan innehålla understreck och alfanumeriska tecken utan blanksteg. Det måste börja med en bokstav och kan inte sluta med ett understreck. Det kan inte heller ha två efterföljande understreck. |
| Beskrivning | Namnet på åtgärden. Agenten använder denna information för att avgöra hur och när denna åtgärd ska användas. |
| Referensåtgärdstyp | Åtgärdstypen, till exempel Flöde eller Apex. |
| Referensåtgärdskategori | Undertypen för referensåtgärdstypen. Inte alla åtgärder har en referensåtgärdskategori. |
| Referensåtgärd | Namnet på åtgärden att hänvisa till. |
För varje indata, lägg till en beskrivning om vad indata gör. Agenten använder beskrivningen för att avgöra hur indata ska användas när åtgärden anropas. Välj Kräv inmatning för att utföra åtgärd för att göra inmatningen obligatorisk.
För varje utdata, lägg till en beskrivning om utdatareturer och hur resultatet ska användas i flödet. Välj Filtrera från agentsammanhang för att utesluta utdata från agentens resonemang. Välj Visa i konversation för att inkludera denna utdata i agentens svar.
Klicka på Skapa och aktivera för att skapa och aktivera din agent.
Konfigurera elementet
När du har valt eller skapat en agent, konfigurera elementet Kör agent i egenskapspanelen.
| Fält | Beskrivning |
|---|---|
| Etikett | Etiketten för åtgärden på arbetsytan och i Verktygsboxhanteraren. |
| API-namn | Kravet på unika namn gäller bara element inom det aktuella flödet. Två element kan ha samma API-namn, förutsatt att de används i olika flöden.Ett API-namn kan innehålla understreck och alfanumeriska tecken utan blanksteg. Det måste börja med en bokstav och kan inte sluta med ett understreck. Det kan inte heller ha två efterföljande understreck. |
| Beskrivning | Beskrivning av elementet. |
Ange värden för indata
Konfigurera indata för elementet Kör agent i egenskapspanelen.
| Fält | Beskrivning |
|---|---|
| Agentbegäran | En fråga eller begäran att skicka till agenten för detta flödesutförande. Agenten tillämpar sina instruktioner för denna specifika begäran att skapa utdata. |
| Session-ID | Valfritt. Använd sessions-ID som returneras av ett Kör agent-element som körs tidigare i flödet. Agenten behåller sitt fullständiga resonemangssammanhang och minne från den konversationen. Om du inte anger ett sessions-ID startar agenten en ny konversation, men du kan alltid specificera utdata från tidigare Kör agent-element som indata. |
Konfigurera strukturerade utdata
För att konfigurera agenten att returnera strukturerade data som ditt flöde kan använda, definiera strukturerade utdatafält. Varje fält representerar en bit information som agenten extraherar eller skapar.
Om du konfigurerar strukturerad utdata returnerar agenten endast strukturerade data i fältet Strukturerat agentsvar. Fältet Agentsvar returnerar null. Om du inte konfigurerar strukturerad utdata returnerar agenten endast ostrukturerad text i fältet Agentsvar.
För att konfigurera strukturerad utdata, klicka på Konfigurera. Konfigurera fälten för varje strukturerat utdatafält:
| fält | Beskrivning |
|---|---|
| Fältnamn | Obligatoriskt. Det unika alfanumeriska namnet för det strukturerade utdatafältet. Namnet får inte innehålla specialtecken eller blanksteg. |
| Beskrivning | En kort beskrivning som används med fältnamnet för att öka precisionen för en stor språkmodell (LLM). |
| Datatyp | Obligatoriskt. Fältets datatyp. Giltiga värden: Sträng, Nummer, Boolesk. |
| Obligatoriskt | Indikerar att LLM måste skapa ett svar för detta utdatafält. Att kräva utdatarader kan resultera i felaktiga eller skadliga svar från LLM. |
Lagra värden för utdata
| Fält | Beskrivning |
|---|---|
| Agentsvar | Det ostrukturerade svaret från agenten. Returnerar noll om strukturerad utdata har konfigurerats. |
| Session-ID | ID för konversationssessionen som agentsvaret är i. |
| Strukturerat agentsvar | Den strukturerade utmatningen från agenten. Returnerar noll om ingen strukturerad utdata har konfigurerats. |
Användning av strukturerade utdata
Innan du konfigurerar strukturerad utdata, ange en etikett och ett API-namn för elementet Kör agent och spara sedan flödet.
När du konfigurerar strukturerad utdata, definiera minst 1 strukturerat utdatafält innan du sparar.
För varje definierat strukturerat utdatafält skapas två fält: ett med det definierade namnet och ett relaterat booleskt _set-fält. Om du till exempel har definierat ett strukturerat utdatafält som heter summary skapas även ett booleskt fält som heter summary_set.
| Fält | Beskrivning |
|---|---|
| Sant | Fältet inkluderades i det strukturerade agentsvaret men hade inget fast värde. |
| Falskt | Fältet inkluderades inte i det strukturerade agentsvaret. |
När en definierad strukturerad utdata returnerar null, använd dess relaterade _set-fält senare i flödet för att avgöra varför fältet är null.
Användningsanteckningar
- Testa ditt flöde innan aktivering för att säkerställa att elementet Kör agent fungerar som förväntat.
- Du kan när som helst hitta och redigera agenter som skapats i Flow Builder i Agentforce Builder.
- Från och med API version 67.0 är AI-agentåtgärder inte längre tillgängliga från elementet Åtgärd. Använd elementet Kör agent för att arbeta med agenter. När du öppnar ett flöde med ett åtgärdselement som refererar till en AI-agentåtgärd visas det automatiskt som ett Kör agent-element. Din ursprungliga konfiguration bevaras.
