Opprett agentelement
Bruk en Agentforce til å håndtere oppgaver dynamisk i flyten. Velg en eksisterende agent, eller opprett en agent med tilpassede instruksjoner og handlinger.
Nødvendige utgaver
Tillatelser
For å kunne bruke eksisterende agenter i flytene må du ha brukertillatelsen Vise oppsett. For å kunne opprette agenter fra Flow Builder må du ha brukertillatelsene Tilpasse program, Einstein Copilot Builder, Einstein Agent Platform Builder eller Selvbetjent kopilotbygger. Brukere med Systemadministrator-profilen kan både opprette og bruke agenter.
Hvis du ikke har tillatelse til å opprette agenter, vises ikke Opprett agent-knappen i agentvalgpanelet. Du kan velge bare eksisterende agenter.
Bruk
Legg til et Opprett agent-element i flyten. Søk etter og velg en aktiv agent i Agent-feltet, eller klikk på Opprett agent for å bygge en ny.
Velge en eksisterende agent
Hvis du vil bruke en eksisterende agent, søker du etter agenten etter navn i Agent-feltet. Bare aktive agenter vises i listen. Når du har valgt en agent, konfigurerer du agentens inndata og utdata i egenskapspanelet.
Opprette en ny agent
Klikk på Opprett agent for å opprette en agent. Konfigurer agentens grunnleggende informasjon i vinduet Ny agent.
| Felt | Beskrivelse |
|---|---|
| Etikett | Navnet på agenten. |
| API-navn | Kravet om unikhet gjelder bare for elementer innen gjeldende flyt. To elementer kan ha samme API-navn, forutsatt at de brukes i forskjellige flyter.Et API-navn kan inneholde understrek og alfanumeriske tegn uten mellomrom. Det må begynne med en bokstav og kan ikke avslutte med et understrek. Det kan heller ikke ha to etterfølgende understrek. |
| Beskrivelse | En beskrivelse av hva agenten gjør. |
| Brukertilgang | Brukerposten som agenten kjører som. Velg en eksisterende bruker, eller få systemet til å opprette en bruker. |
| Instruksjoner | Instruksjoner som beskriver hva agenten gjør, og veileder dens resonnement. |
| Handlinger | Handlingene som agenten kan bruke. Velg eksisterende handlinger fra aktivumbiblioteket, eller opprett tilpassede handlinger. |
Legge til handlinger i agenten
Agenten krever minst én handling for å utføre oppgaver. Legg til handlinger før du klikker på Opprett og aktiver eller i Agentforce Builder etter at du har aktivert agenten.
Klikk på Velg handlinger for å velge eksisterende handlinger. Søk etter og velg én eller flere handlinger fra aktivumbiblioteket, og klikk deretter på Legg til i agent. Tilgjengelige handlinger inkluderer Knowledge, flyter konfigurert som kallbare handlinger og standardhandlinger.
Klikk på Opprett handling for å opprette en handling. Konfigurer handlingen i vinduet Opprett handling.
| Felt | Beskrivelse |
|---|---|
| Agent Tool-etikett | Navnet på handlingen. |
| API-navn | Kravet om unikhet gjelder bare for elementer innen gjeldende flyt. To elementer kan ha samme API-navn, forutsatt at de brukes i forskjellige flyter.Et API-navn kan inneholde understrek og alfanumeriske tegn uten mellomrom. Det må begynne med en bokstav og kan ikke avslutte med et understrek. Det kan heller ikke ha to etterfølgende understrek. |
| Beskrivelse | Navnet på handlingen. Agenten bruker denne informasjonen til å bestemme hvordan og når denne handlingen skal brukes. |
| Referansehandlingstype | Typen handling, for eksempel Flyt eller Apex. |
| Referansehandlingskategori | Undertypen for handlingstypen referanse. Ikke alle handlinger har en referansehandlingskategori. |
| Referansehandling | Navnet på handlingen det skal refereres til. |
For hver inndata legger du til en beskrivelse av hva inndataene gjør. Agenten bruker beskrivelsen til å bestemme hvordan inndataene skal brukes når handlingen kalles opp. Velg Kreve inndata for å utføre handlingen for å gjøre inndataene nødvendige.
For hvert utdata legger du til en beskrivelse av utdataverdiene og hvordan resultatet skal brukes i flyten. Velg Filtrer fra agentkontekst for å ekskludere utdata fra agentens resonnement. Velg Vis i samtale for å inkludere disse utdataene i agentens svar.
Klikk på Opprett og aktiver for å opprette og aktivere agenten.
Konfigurere elementet
Når du har valgt eller opprettet en agent, konfigurerer du Opprett agent-elementet i egenskapspanelet.
| Felt | Beskrivelse |
|---|---|
| Etikett | Etiketten for handlingen på lerretet og i verktøykassebehandling. |
| API-navn | Kravet om unikhet gjelder bare for elementer innen gjeldende flyt. To elementer kan ha samme API-navn, forutsatt at de brukes i forskjellige flyter.Et API-navn kan inneholde understrek og alfanumeriske tegn uten mellomrom. Det må begynne med en bokstav og kan ikke avslutte med et understrek. Det kan heller ikke ha to etterfølgende understrek. |
| Beskrivelse | Beskrivelsen av elementet. |
Angi inndataverdier
Konfigurer Opprett agent-elementets inndata i egenskapspanelet.
| Felt | Beskrivelse |
|---|---|
| Agentforespørsel | Et spørsmål eller en forespørsel som skal sendes til agenten for denne flytutførelsen. Agenten bruker instruksjonene sine på denne spesifikke forespørselen for å generere utdata. |
| Økt-ID | Valgfritt. Bruk Økt-IDen som returneres av et Opprett agent-element som kjører tidligere i flyten. Agenten beholder sin fulle årsakskontekst og minne fra denne samtalen. Hvis du ikke oppgir en økt-ID, starter agenten en ny samtale, men du kan alltid angi utdata fra tidligere Opprett agent-elementer som inndata. |
Konfigurere strukturerte utdata
For å konfigurere agenten til å returnere strukturerte data som flyten kan bruke, definerer du strukturerte utdatafelt. Hvert felt representerer en bit informasjon som agenten trekker ut eller genererer.
Hvis du konfigurerer strukturerte utdata, returnerer agenten bare strukturerte data i feltet Strukturert agentrespons. Feltet Agentsvar returnerer null. Hvis du ikke konfigurerer strukturerte utdata, returnerer agenten bare ustrukturert tekst i Agentsvar-feltet.
Klikk på Konfigurer for å konfigurere strukturerte utdata. Konfigurer feltene for hvert strukturert utdatafelt:
| field | Beskrivelse |
|---|---|
| Feltnavn | Obligatorisk. Det unike alfanumeriske navnet på det strukturerte utdatafeltet. Navnet kan ikke inneholde spesialtegn eller mellomrom. |
| Beskrivelse | En kort beskrivelse som brukes sammen med feltnavnet for å øke nøyaktigheten av stor språkmodell (LLM). |
| Datatype | Obligatorisk. Datatypen til feltet. Gyldige verdier: Streng, Tall, Boolsk. |
| Obligatorisk | Angir at LLM må generere et svar for dette utdatafeltet. Krevende utdatarader kan føre til unøyaktige eller skadelige svar fra LLM. |
Lagre utdataverdier
| Felt | Beskrivelse |
|---|---|
| Agentsvar | Det ustrukturerte svaret fra agenten. Returnerer null hvis strukturert utdata er konfigurert. |
| Økt-ID | ID-en til samtaleøkten som agentsvaret er i. |
| Strukturert agentsvar | De strukturerte utdataene fra agenten. Returnerer null hvis ingen strukturert utdata er konfigurert. |
Strukturert utdatabruk
Før du konfigurerer strukturerte utdata oppgir du en etikett og et API-navn for Opprett agent-elementet, og deretter lagrer du flyten.
Når du konfigurerer strukturerte utdata, definerer du minst ett strukturert utdatafelt før du lagrer.
For hvert definerte strukturerte utdatafelt opprettes det to felt: en med det definerte navnet og et relatert boolsk _settfelt. Hvis du for eksempel definerte et strukturert utdatafelt med navnet summary, opprettes det også et boolsk felt med navnet summary_set.
| Felt | Beskrivelse |
|---|---|
| True | Feltet ble inkludert i det strukturerte agentsvaret, men det hadde ingen angitt verdi. |
| False | Feltet ble ikke inkludert i det strukturerte agentsvaret. |
Når et definert strukturert utdata returnerer null, bruker du det relaterte _set-feltet senere i flyten til å finne ut hvorfor feltet er null.
Merknader om bruk
- Test flyten før du aktiverer for å sikre at Opprett agent-elementet fungerer som forventet.
- Du kan finne og redigere agenter opprettet i Flow Builder i Agentforce Builder når som helst.
- Fra og med API-versjon 67.0 er ikke AI Agent-handlinger lenger tilgjengelig fra Handling-elementet. Bruk Opprett agent-elementet til å arbeide med agenter. Når du åpner en flyt med et Handling-element som refererer til en AI Agent-handling, vises den automatisk som et Opprett agent-element. Den opprinnelige konfigurasjonen beholdes.
