Gode fremgangsmåter for instruksjoner om agenthandlinger
Handlingsinstruksjoner forteller en agent hva handlingen gjør og når den skal brukes. Når du oppretter en tilpasset handling, må du nøye planlegge og teste instruksjonene for å sikre at handlingen utføres som forventet.
Nødvendige utgaver
| Tilgjengelig i Lightning Experience |
| Tilgjengelig i Enterprise, Performance, Unlimited og Developer Edition. Nødvendige tilleggslisenser varierer etter agenttype. |
Navnene og instruksjonene for agenthandlinger og deres inndata og utdata bestemmer når og hvordan en handling brukes i en samtale. AI-agenter bruker en stor språkmodell (LLM) og planleggingstjenesten til å søke gjennom alle handlinger som er tildelt en kopiot, og velge én eller flere som skal utføres i samtalen, basert på brukerens spørsmål eller forespørsel. Jo mer effektive instruksjonene er, desto mer forutsigbar utføres handlingen.
Effektive instruksjoner varierer etter handling og bruksområde. For å få best mulig resultat tester du handlingen i Agentforce Builder og gjentar til handlingen oppfyller kravene dine.
Instruksjoner for handlinger
Handlingsinstruksjoner beskriver hva handlingen gjør og når den skal brukes i en samtale. Det viktigste elementet i handlingsinstruksjoner er en presis beskrivelse på naturlig språk av hva handlingen gjør, vanligvis én til tre setninger skrevet som en instruksjon til LLM. Beskrivelsen kan inkludere målet eller oppgaven for handlingen, eventuelle brukstilfeller for handlingen og objektene eller postene den bruker eller endrer. Generelt sett er det enklere for LLM å skille mellom handlinger jo mer relevante detaljer du inkluderer i instruksjonene.
| Eksempel på agenthandling | Mindre effektiv beskrivelse | Mer effektiv beskrivelse |
|---|---|---|
| Oppdatere telefonnummer til kontakt | Oppdaterer et telefonnummer. | Oppdaterer brukerens telefonnummer som er knyttet til kontaktposten. Hvis det ikke finnes noen samsvarende kontakt, opprettes det en ny kontaktpost. |
| Spørringsposter | Gir mulighet til å bruke naturlig språk til å spørre informasjon om Salesforce CRM-poster. | Finner og henter Salesforce CRM-poster basert på brukerinndata og bestemte betingelser, som feltverdier. Denne handlingen identifiserer automatisk de riktige postene og objekttypen. |
| Spor bestilling | Handling for å hente sporingsinformasjon for en bestilling. | Returnerer sporingsinformasjon for en kundebestilling basert på sporingsnummeret og bestemmelsespostnummeret. |
I mange tilfeller er beskrivelsen av naturlig språk alt som kreves for at en agent skal kunne bruke handlingen som forventet. Enkelte handlinger krever imidlertid flere detaljer etter testing. Her er noen alternativer for å begrense handlingsbeskrivelsen.
| Hva som skal inkluderes | Når den kan brukes | Eksempler |
|---|---|---|
| Én til tre ytringer, eller eksempelkundeinndata | Inkluder eksempler på kundemeldinger som du forventer å utløse handlingen for å hjelpe LLM med å samsvare en gitt kundeinndata med handlingen. Hvis du inkluderer flere ytringer, minimerer du overlappinger.
|
|
| Avhengige handlinger | Enkelte handlinger bruker andre handlinger, ofte systemhandlinger, til å hente nødvendig informasjon. Hvis en nødvendig handling mangler i en plan eller handlinger ikke kalles opp i den riktige rekkefølgen, kan du angi dem etter API-navn. | Handlingen IdentifyRecordByName må kalles opp direkte før denne handlingen for å få en enkelt post-ID som inndata. Hvis handlingen IdentifyRecordByName er en del av planen, må den kjøres før GetRecordFieldsAndValues. |
| Eksempler på hvordan du vil at handlingen skal fungere | Eksempler generaliserer ikke godt, men de kan være nyttige når en agent utfører en konsekvent feil. Generelt sett forstår LLM-er eksempler på hva som skal gjøres bedre enn eksempler på hva som ikke skal gjøres, men du kan teste med begge. |
Denne handlingen bør kalles opp bare når en mer spesifikk sammendragshandling ikke er tilgjengelig. |
Instruksjoner for inndata og utdata
Instruksjoner for inndata og utdata beskriver hvordan du formaterer og bruker parameteren. I instruksjonene for en inndata angir du hvilken informasjon som kreves for å utføre handlingen. I instruksjonene for et utdata angir du resultatet av handlingen og hva en kopiopot returnerer til brukeren.
LLM-er har ikke en fullstendig forståelse av kontekst, inkludert Salesforce-konteksten. Med andre ord vet ikke en LLM alltid antall tegn i en Salesforce-post-ID eller navnene på Salesforce-objekter. Kortfattede, men detaljerte instruksjoner hjelper en kopiot til å hente nødvendig informasjon og returnere relevante resultater. Den beste måten å finne riktig detaljnivå på, er å teste og gjenta instruksjonene dine.
Når du skriver instruksjoner for en inndata eller et utdata, bør du vurdere følgende:
- Datatypen til informasjonen: "en 18-tegns ID", "et svar på brukerens spørsmål med rik tekst".
- Eventuelle spesifikke felt eller verdier: "inneholder kontakt-IDen og forventet leveringsdato".
- Slik hentes eller genereres informasjonen: For en ny e-postmelding henter du IDen fra brukerens inndata. For en revidert e-postmelding henter du IDen fra samtalehistorikken."
- Eventuelle spesielle regler om hvordan du forventer at handlingen skal brukes: "Ikke generer SQL eller SOQL.", "Nødvendig bare når brukeren vil revidere et tidligere utkast."", "API-navnet brukes til å identifisere Salesforce-postfelt-verdi-par fra brukerforespørselen."
Her er noen eksempler på effektive instruksjoner for inndata og utdata.
| Inndata- eller utdataparameter | Instruksjoner |
|---|---|
| postID | Den ene ID-en til Salesforce CRM-posten som sammendraget skal opprettes for. Eksempel: recordId, record_id, recordIds[0], accountId. |
| objectApiName | API-navnet på Salesforce-objektet (som Konto eller Salgsmulighet) som er knyttet til posten brukeren vil finne. Navnet kan hentes fra konteksten og krever ikke handlingen IdentifyObjectByName. |
| summary | Sammendraget for rik tekst opprettet for den angitte posten. |
| searchResults (søkresultater) | En liste over samsvarende Salesforce CRM-post-ID-er i synkende rekkefølge av relevans. |
| generatedEmail | Et JSON-objekt som inneholder mottaker-IDen, emnelinjen og innholdet i e-postmeldingen. |
