breadcrumbDescription
Opret agentelement
Brug en Agentforce til at håndtere opgaver dynamisk i dit forløb. Vælg en eksisterende agent, eller opret en agent med tilpassede instruktioner og handlinger.
EditionsHeading
Tilladelser
Hvis du vil bruge eksisterende agenter i dine forløb, skal du have brugertilladelsen Vis opsætning. Hvis du vil oprette agenter fra Flow Builder, skal du have brugertilladelserne Tilpas applikation, Einstein Copilot Builder, Einstein Agent Platform Builder eller Selvbetjeningspilotkonstruktør. Brugere med profilen Systemadministrator kan både oprette og bruge agenter.
Hvis du ikke har tilladelser til at oprette agenter, vises knappen Opret agent ikke i agentvalgpanelet. Du kan kun vælge eksisterende agenter.
Anvendelse
Føj et Opret agent-element til dit forløb. I feltet Agent skal du søge efter og vælge en aktiv agent eller klikke på Opret agent for at opbygge en ny.
Vælg en eksisterende agent
Hvis du vil bruge en eksisterende agent, skal du søge efter agenten efter navn i feltet Agent. Kun aktive agenter vises på listen. Når du har valgt en agent, skal du konfigurere agentens input og output i egenskabspanelet.
Opret en ny agent
Hvis du vil oprette en agent, skal du klikke på Opret agent. I vinduet Ny agent skal du konfigurere agentens basisoplysninger.
| Felt | Beskrivelse |
|---|---|
| Betegnelse | Navnet på agenten. |
| API-navn | Kravet til entydighed gælder kun for elementer i det aktuelle forløb. To elementer kan have det samme API-navn, forudsat de bruges i forskellige forløb.Et API-navn kan indeholde understregninger og alfanumeriske tegn uden mellemrum. Det skal starte med et bogstav og ikke slutte med en understregning. Det kan også have to på hinanden følgende understregninger. |
| Beskrivelse | En beskrivelse af, hvad agenten gør. |
| Brugeradgang | Den brugerregistrering, som agenten kører som. Vælg en eksisterende bruger, eller få systemet til at oprette en bruger. |
| Instruktioner | Instruktioner, der beskriver, hvad agenten gør og guider sin argumentation. |
| Handlinger | De handlinger, som agenten kan bruge. Vælg eksisterende handlinger fra aktivbiblioteket, eller opret tilpassede handlinger. |
Føj handlinger til agenten
Agenten kræver mindst en handling for at udføre opgaver. Tilføj handlinger, før du klikker på Opret og aktiver eller i Agentforce-konstruktør, når du har aktiveret agenten.
Hvis du vil vælge eksisterende handlinger, skal du klikke på Vælg handlinger. Søg efter og vælg en eller flere handlinger fra aktivbiblioteket, og klik derefter på Føj til agent. Tilgængelige handlinger inkluderer Knowledge, forløb, der er konfigureret som handlinger, der kan kaldes, og standardhandlinger.
Hvis du vil oprette en handling, skal du klikke på Opret handling. Konfigurer handlingen i vinduet Opret handling.
| Felt | Beskrivelse |
|---|---|
| Agentværktøjsbetegnelse | Navnet på handlingen. |
| API-navn | Kravet til entydighed gælder kun for elementer i det aktuelle forløb. To elementer kan have det samme API-navn, forudsat de bruges i forskellige forløb.Et API-navn kan indeholde understregninger og alfanumeriske tegn uden mellemrum. Det skal starte med et bogstav og ikke slutte med en understregning. Det kan også have to på hinanden følgende understregninger. |
| Beskrivelse | Navnet på handlingen. Agenten bruger disse oplysninger til at bestemme, hvordan og hvornår denne handling skal bruges. |
| Referencehandlingstype | Typen af handling, f.eks. Forløb eller Apex. |
| Referencehandlingskategori | Undertypen af referencehandlingstypen. Det er ikke alle handlinger, der har en referencehandlingskategori. |
| Referencehandling | Navnet på den handling, der skal refereres til. |
For hvert input skal du tilføje en beskrivelse af, hvad inputtet gør. Agenten bruger beskrivelsen til at bestemme, hvordan inputtet skal bruges, når handlingen kaldes. Vælg Kræv input for at udføre handling for at gøre input påkrævet.
For hvert output skal du tilføje en beskrivelse om outputreturneringerne og hvordan du bruger resultatet i forløbet. Vælg Filtrer fra agentkontekst for at ekskludere outputtet fra agentens argumentation. Vælg Vis i samtale for at inkludere dette output i agentens svar.
Klik på Opret og aktiver for at oprette og aktivere din agent.
Konfigurer elementet
Når du har valgt eller oprettet en agent, skal du konfigurere Opret agent-elementet i egenskabspanelet.
| Felt | Beskrivelse |
|---|---|
| Betegnelse | Betegnelsen for handlingen på lærredet og i Toolbox Manager. |
| API-navn | Kravet til entydighed gælder kun for elementer i det aktuelle forløb. To elementer kan have det samme API-navn, forudsat de bruges i forskellige forløb.Et API-navn kan indeholde understregninger og alfanumeriske tegn uden mellemrum. Det skal starte med et bogstav og ikke slutte med en understregning. Det kan også have to på hinanden følgende understregninger. |
| Beskrivelse | Beskrivelsen af elementet. |
Angiv inputværdier
Konfigurer Opret agent-elementets input i egenskabspanelet.
| Felt | Beskrivelse |
|---|---|
| Agentanmodning | Et spørgsmål eller en anmodning, der skal sendes til agenten for denne forløbskørsel. Agenten anvender sine instruktioner på denne specifikke anmodning for at generere output. |
| Sessions-id | Valgfrit. Brug det sessions-id, der returneres af et Opret agent-element, der kører tidligere i forløbet. Agenten bevarer sin fulde kontekst og hukommelse fra denne samtale. Hvis du ikke angiver et sessions-id, starter agenten en ny samtale, men du kan altid angive output fra tidligere Opret agent-elementer som input. |
Konfigurer struktureret output
Hvis du vil konfigurere agenten til at returnere strukturerede data, som dit forløb kan bruge, skal du definere strukturerede outputfelter. Hvert felt repræsenterer et stykke oplysninger, som agenten udtrækker eller genererer.
Hvis du konfigurerer struktureret output, returnerer agenten kun strukturerede data i feltet Struktureret agentsvar. Feltet Agentsvar returnerer null. Hvis du ikke konfigurerer struktureret output, returnerer agenten kun ustruktureret tekst i feltet Agentsvar.
Hvis du vil konfigurere struktureret output, skal du klikke på Konfigurer. Konfigurer felterne for hvert struktureret outputfelt:
| felt | Beskrivelse |
|---|---|
| Feltnavn | Påkrævet. Det entydige alfanumeriske navn for det strukturerede outputfelt. Navnet må ikke indeholde specialtegn eller mellemrum. |
| Beskrivelse | En kort beskrivelse, der bruges sammen med feltnavnet til at øge nøjagtigheden af stor sprogmodel (LLM). |
| Datatype | Påkrævet. Datatypen for feltet. Gyldige værdier: Streng, Tal, Boolesk. |
| Påkrævet | Angiver, at LLM skal generere et svar for dette outputfelt. Krævning af outputrækker kan resultere i unøjagtige eller skadelige svar fra LLM. |
Gem outputværdier
| Felt | Beskrivelse |
|---|---|
| Agentsvar | Det ustrukturerede svar fra agenten. Returnerer nul, hvis der er konfigureret struktureret output. |
| Sessions-id | Id'et på den samtalesession, som agentsvaret er i. |
| Struktureret agentrespons | Det strukturerede output fra agenten. Returnerer nul, hvis der ikke er konfigureret nogen struktureret output. |
Struktureret outputanvendelse
Før du konfigurerer struktureret output, skal du angive en betegnelse og et API-navn for Opret agent-elementet og derefter gemme forløbet.
Når du konfigurerer struktureret output, skal du definere mindst 1 struktureret outputfelt, før du gemmer.
For hvert defineret struktureret outputfelt oprettes der to felter: et med det definerede navn og et relateret boolesk _set-felt. Hvis du f.eks. definerede et struktureret outputfelt ved navn summary, oprettes der også et boolesk felt ved navn summary_set.
| Felt | Beskrivelse |
|---|---|
| Sand | Feltet blev inkluderet i det strukturerede agentsvar, men det havde ingen angivet værdi. |
| Falsk | Feltet blev ikke inkluderet i det strukturerede agentsvar. |
Når et defineret struktureret output returnerer null, skal du bruge dets relaterede _set-felt senere i forløbet til at bestemme, hvorfor feltet er null.
Anvendelsesnotater
- Test dit forløb, før du aktiverer for at sikre, at Opret agent-elementet fungerer som forventet.
- Du kan når som helst finde og redigere agenter, der er oprettet i Flow Builder i Agentforce Builder.
- Fra og med API version 67.0 er AI-agenthandlinger ikke længere tilgængelige fra handlingselementet. Brug Opret agent-elementet til at arbejde med agenter. Når du åbner et forløb med et handlingselement, der refererer til en AI-agenthandling, vises det automatisk som et Opret agent-element. Din oprindelige konfiguration bevares.
