Opprette en tilpasset handling
Du kan opprette en tilpasset handling fra aktivumbiblioteket eller fra en agent i Agentforce Builder. Når du oppretter en handling fra aktivumbiblioteket, er den tilgjengelig for å legges til i flere agenter og versjoner. Når du oppretter en handling fra en agent i Agentforce Builder, er den tilgjengelig bare for denne agenten.
Nødvendige utgaver
| Tilgjengelig i Lightning Experience |
| Tilgjengelig i Enterprise, Performance, Unlimited og Developer Edition. Nødvendige tilleggslisenser varierer etter agenttype. |
| Nødvendig brukertillatelse | |
|---|---|
| For å opprette en tilpasset agenthandling: | Behandle AI-agenter OG de nødvendige tillatelsene for agenttypen |
| For å opprette eller endre ledetekstmaler: | Ledetekstmalbehandling |
| For å opprette eller endre flyter: | Behandle flyter |
Opprette en tilpasset handling i Agentforce Builder
Når du oppretter en tilpasset handling fra en agent i Agentforce Builder, er den tilgjengelig bare for den agenten. Eventuelle endringer du gjør, gjelder bare for denne agentversjonen. Hvis du vil gjøre en handling tilgjengelig for andre emner, agenter og agentversjoner, oppretter du den i aktivumbiblioteket i stedet.
Før du begynner:
- Se gjennom vurderingene for tilpassede handlinger.
- Opprett den underliggende Salesforce-funksjonaliteten som du vil bruke med agenten. Når du oppretter en tilpasset handling, konfigurerer du funksjonaliteten som skal brukes med agenten. Du kan opprette en tilpasset handling som kaller opp kallbare metoder og REST Apex, eksterne tjenester, automatisk startede flyter, MuleSoft API-er eller ledetekstmaler.
Tilgang til en tilpasset agenthandling avhenger av hvilken type Salesforce-funksjonalitet den refererer til. Hvis en tilpasset handling for eksempel bygges med en flyt, overholder den tilpassede handlingen tillatelsene, feltnivåsikkerheten og delingsinnstillingene som er konfigurert i flyten. For å kunne kjøre handlingen må minst brukeren eller Agentbruker ha tillatelsen Kjøre flyter og tilgang til objekter som brukes i flyten. Se Generell brukertilgang for standard agenthandlinger.
Hvis du vil gjøre endringer i agenten, må den være i utkasttilstand. Hvis du vil gjøre endringer i en bekreftet agent, oppretter du et nytt utkast.
- Åpne agenten du vil legge til en handling i, fra Agenter-listen i Agentforce Studio-appen.
- Hvis det er flere versjoner av agenten, velger du agentversjonen du vil redigere, fra toppteksten i Agentforce Builder.
-
I Utforsker-panelet åpner du emnet du vil legge til handlingen i, og deretter fører du markøren over Handlinger og klikker på
.
- Velg Opprett ny handling.
- Gi handlingen et navn, og klikk deretter på Opprett og åpne. Den tilpassede handlingen legges til i emnet og agenten.
- Fra rullegardinlisten Referansehandlingstype velger du hvilken type funksjonalitet du vil bruke til å bygge agenthandlingen, for eksempel en flyt eller en ledetekstmal. Velg deretter kategorien, hvis du blir bedt om det, og referansehandlingen. Beskrivelsene for den tilpassede handlingen og hver inndata og utdata fylles ut med beskrivelsene fra referansehandlingen.
-
Gjør endringer i handlingen.
- Se gjennom beskrivelsen av handlingen. Gjør om nødvendig endringer for å hjelpe agenten med å forstå hva handlingen gjør og når og hvordan den skal brukes.
- Se gjennom beskrivelsen av hver inndata og hvert utdata.
-
Angi eventuelle aktuelle innstillinger for hver inndata.
Inndatainnstilling Detaljer Indsaml data fra bruger Krev at denne parameteren oppgis av brukeren. Krev inndata Krev denne parameteren for å utføre handlingen. Når denne innstillingen er aktivert, kan ikke handlingen kjøres hvis inndataene mangler. Alle andre inndata behandles som valgfrie. Hvis det kreves inndata av referansehandlingen, er denne innstillingen aktivert som standard og skrivebeskyttet. -
Angi eventuelle aktuelle innstillinger for hvert utdata.
Utdatainnstilling Detaljer Inkluder i agentkontekst Når du oppretter en agenthandling, legges alle inndata og utdata fra referansehandlingen til i agenthandlingen. Når denne innstillingen aktiveres for et utdata, legges utdataene til i agentens samtalehistorikk og gjøres tilgjengelig for vurderinger. Deaktiver innstillingen for eventuelle underliggende referansehandlingsutdata som du ikke vil bruke med agenten. Minst ett utdata må brukes sammen med agenthandlingen. Vis i diskusjon Når denne innstillingen aktiveres, inkluderes utdataene i agentens svar. I enkelte kanaler konverteres enkelte utdata til strukturert innhold (for eksempel gjenkjenner Agentforce i Lightning Experience postsider).
Når denne innstillingen er deaktivert for alle utdata, bruker agenten LLM til å oppsummere utdataene på naturlig språk i agentens svar.
-
Angi eventuelle andre innstillinger for handlingen.
Tilleggsinnstilling Detaljer Krev brukerbekreftelse Når en handling gjør en endring i en post, kan du kreve at en agent ber brukeren om å bekrefte endringen før agenten kan utføre den. Vis innlastingstekst for denne handlingen Vis innlastingstekst i agentsamtalen mens handlingen kjører i bakgrunnen.
For en tilpasset handling kan du angi innlastingstekst for handlingen i feltet Innlastingstekst. I 1–3 ord uten tegnsetting forteller du brukerne hva handlingen gjør. For eksempel "Opret din mail", "Gør opdateringer" eller "Hent aktivitetsdetaljer".
Når denne innstillingen er deaktivert, eller når denne innstillingen er aktivert, men ingen innlastingstekst er angitt, vises standardinnlastingstekst. For eksempel "Arbeide", "Gå fremover" eller "Sjekk notatene mine".
Hvis du vil vise innlastingstekst i forbedrede Meldinger-kanalsamtaler, kræves yderligere konfiguration for Forbedret chat.
- Lagre endringene.
Handlingen er tilgjengelig bare i dette agentemnet og -versjonen og er ikke tilgjengelig i aktivumbiblioteket. Eventuelle endringer du gjør i handlingen, gjelder bare for dette emnet og agentversjonen. Endringer påvirker ikke andre emner eller agenter.
Handlingen legges automatisk til i emnets resoneringshandlinger (Handlinger tilgjengelig for resonering), så handlingen er tilgjengelig for agenten å velge under resonering med en LLM. I argumenthandlinger kan du legge til logikk i agenthandlingen, som filtre og oppfølgingshandlinger. Hvis du vil kjøre handlingen deterministisk før agenten begynner å tenke, refererer du til handlingen i emnets begrunnelsesinstruksjoner.
Opprette en tilpasset handling fra aktivumbiblioteket
Opprett en tilpasset handling i aktivumbiblioteket for å gjøre handlingen tilgjengelig for flere agenter, versjoner og emner. Legg den deretter til én eller flere agenter.
Før du begynner:
- Se gjennom vurderingene for tilpassede handlinger.
- Opprett den underliggende Salesforce-funksjonaliteten som du vil bruke med agenten. Når du oppretter en tilpasset handling, konfigurerer du funksjonaliteten som skal brukes med agenten. Du kan opprette en tilpasset handling som kaller opp kallbare metoder og REST Apex, eksterne tjenester, automatisk startede flyter, MuleSoft API-er eller ledetekstmaler.
Tilgang til en tilpasset agenthandling avhenger av hvilken type Salesforce-funksjonalitet den refererer til. Hvis en tilpasset handling for eksempel bygges med en flyt, overholder den tilpassede handlingen tillatelsene, feltnivåsikkerheten og delingsinnstillingene som er konfigurert i flyten. For å kunne kjøre handlingen må minst brukeren eller Agentbruker ha tillatelsen Kjøre flyter og tilgang til objekter som brukes i flyten. Se Generell brukertilgang for standard agenthandlinger.
- Skriv inn Agentforce-aktiva i Oppsett, og velg deretter Agentforce-aktiva.
- Klikk på Ny agenthandling fra Handlinger-fanen.
-
Fra rullegardinlisten Referansehandlingstype velger du hvilken type funksjonalitet du vil bruke til å bygge agenthandlingen, for eksempel en flyt eller en ledetekstmal. Velg deretter kategorien, hvis du blir bedt om det, og referansehandlingen.
Beskrivelsene for den tilpassede handlingen og hver inndata og utdata fylles ut med beskrivelsene fra referansehandlingen.
-
Gjør endringer i handlingen.
- Se gjennom beskrivelsen av handlingen. Gjør om nødvendig endringer for å hjelpe agenten med å forstå hva handlingen gjør og når og hvordan den skal brukes.
-
Angi eventuelt innlastingstekst for handlingen. Ellers slår du av innstillingen.
Innstilling Detaljer Vis innlastingstekst for denne handlingen Vis innlastingstekst i agentsamtalen mens handlingen kjører i bakgrunnen.
For en tilpasset handling kan du angi innlastingstekst for handlingen i feltet Innlastingstekst. I 1–3 ord uten tegnsetting forteller du brukerne hva handlingen gjør. For eksempel "Opret din mail", "Gør opdateringer" eller "Hent aktivitetsdetaljer".
Når denne innstillingen er deaktivert, eller når denne innstillingen er aktivert, men ingen innlastingstekst er angitt, vises standardinnlastingstekst. For eksempel "Arbeide", "Gå fremover" eller "Sjekk notatene mine".
Hvis du vil vise innlastingstekst i forbedrede Meldinger-kanalsamtaler, kræves yderligere konfiguration for Forbedret chat.
- Se gjennom beskrivelsen av hver inndata og hvert utdata.
-
Angi eventuelle aktuelle innstillinger for hver inndata.
Inndatainnstilling Detaljer Indsaml data fra bruger Krev at denne parameteren oppgis av brukeren. Krev inndata Krev denne parameteren for å utføre handlingen. Når denne innstillingen er aktivert, kan ikke handlingen kjøres hvis inndataene mangler. Alle andre inndata behandles som valgfrie. Hvis det kreves inndata av referansehandlingen, er denne innstillingen aktivert som standard og skrivebeskyttet. -
Angi eventuelle aktuelle innstillinger for hvert utdata.
Utdatainnstilling Detaljer Inkluder i agentkontekst Når du oppretter en agenthandling, legges alle inndata og utdata fra referansehandlingen til i agenthandlingen. Når denne innstillingen aktiveres for et utdata, legges utdataene til i agentens samtalehistorikk og gjøres tilgjengelig for vurderinger. Deaktiver innstillingen for eventuelle underliggende referansehandlingsutdata som du ikke vil bruke med agenten. Minst ett utdata må brukes sammen med agenthandlingen. Vis i diskusjon Når denne innstillingen aktiveres, inkluderes utdataene i agentens svar. I enkelte kanaler konverteres enkelte utdata til strukturert innhold (for eksempel gjenkjenner Agentforce i Lightning Experience postsider).
Når denne innstillingen er deaktivert for alle utdata, bruker agenten LLM til å oppsummere utdataene på naturlig språk i agentens svar.
- Klikk på Fullfør.
Handlingen er tilgjengelig i aktivumbiblioteket. For å bruke handlingen legger du den til i en agent. Se Legge til en handling i et emne fra aktivumbiblioteket.
Eventuelle endringer du gjør i handlingen i aktivumbiblioteket, synkroniseres ikke til noen kopier av handlingen du har lagt til i agenter. Hvis du vil bruke endringer gjort i en handling i aktivumbiblioteket på en agent, må du legge til den oppdaterte handlingen i agenten.
