Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
Denne artikkelen forklarer hvordan du oppretter og kobler en Salesforce Einstein Bot til en Copilot Studio-agent. Ved å integrere disse plattformene kan du forbedre agentopplevelsen med de kombinerte funksjonene til begge.
I dette integreringsmønsteret fungerer Einstein Bot som fronten og bruker Copilot Studio som en tilbakefallsmekanisme gjennom Einsteins forvirret emne. I stedet for å tilordne hensikter mellom de to plattformene videresender Einstein Bot enhver brukerspørring den ikke forstår til Copilot Studio. Copilot Studio behandler spørringen og returnerer et svar. Denne forespørsels-/svarmodellen betyr at Copilot Studio gir AI-drevne svar basert på brukerens spørring.
Einstein Bot har full kontroll over overføringen til en menneskelig agent. Denne implementeringen lytter ikke etter leveringshendelser fra Copilot Studio. Du konfigurerer eskaleringsutløsere direkte i Einstein for å rute samtaler til Salesforce Omni-Channel køer.
Forhåndskrav
Før du begynner, må du kontrollere at du har:
- En Salesforce-konto med Einstein Bots aktivert.
- En Copilot Studio-konto.
- Administrator- eller utviklertillatelser i Salesforce og Microsoft Power Platform.
Trinn 1: Hent direktelinjehemmeligheten for agenten din
- Åpne agenten i Copilot Studio, og gå til Innstillinger.
- Velg sikkerhet>sikkerhet for webkanal.
- Kopier Secret 1 eller Secret 2 under Hemmeligheter og tokener.
Viktig!
Denne integreringen støtter bare Copilot Studio-agenter som er konfigurert uten godkjenning. Godkjente kunnskapskilder, for eksempel SharePoint, støttes ikke med denne tilnærmingen.
Tips
Automatisert distribusjon: Hvis du har Salesforce CLI installert, kan du bruke de automatiserte distribusjonsskriptene til å fullføre trinn 2 til 5. Når skriptet er fullført, følger du instruksjonene for å konfigurere direktelinjehemmeligheten. Gå deretter videre til trinn 6: Setup Einstein bot. Hvis du vil konfigurere manuelt, fortsetter du til trinn 2.
Trinn 2: Konfigurere innstillinger for eksternt salesforce-område
- Logg på din Salesforce-konto.
- Gå til installasjonsprogrammet.
- Skriv inn innstillinger for eksternt område i Hurtigsøk, og velg deretter Innstillinger for eksternt område.
- Legg til et nytt eksternt område, skriv inn DirectLine for Eksternt områdenavn, og skriv inn https://directline.botframework.comurl-adressen for eksternt område.
- Velg Lagre.
Obs!
Bruk den aktuelle URL-adressen for DirectLine-API-en for andre områder. Se API-referansen for direkte linje for regionale endepunkter.
Trinn 3: Opprett Apex-klasser for å koble til DirectLine API
Gå til installasjonsprogrammet i Salesforce.
Skriv inn Apex-klasser i Hurtigsøk.
Opprett følgende Apex-klasser ved å kopiere kildekoden fra eksemplet på Salesforce-integrering:
-
DL_GetConversation: Starter en ny direktelinjesamtale og returnererconversationId. -
DL_PostActivity: Sender en brukermelding til samtalen gjennom DirectLine-API-en. -
DL_GetActivity: Henter agentens svar, med innebygd forsinkelse og prøv logikk på nytt for håndtering av asynkrone svar.
-
Trinn 4: Konfigurere en navngitt legitimasjon for sikker godkjenning
Microsoft anbefaler at du bruker navngitt legitimasjon i stedet for hardkoding av hemmeligheter i Apex-klassene dine. Navngitt legitimasjon gir en sikker måte å lagre hemmeligheter på, og det er enklere å administrere og rotere uten å endre kode.
Opprette en ekstern legitimasjon
- Søk etter navngitt legitimasjon i salesforce-konfigurasjonen, og velg Navngitt legitimasjon.
- Velg Ekstern legitimasjon-fanen.
- Velg Ny og konfigurer:
-
Etikett:
Directline -
Navn:
Directline -
Godkjenningsprotokoll:
Custom
-
Etikett:
- Velg Lagre.
Opprett en hovedkomponent
- Velg Ny under Prinsipper i den eksterne legitimasjonen du opprettet.
- Konfigurere:
-
Parameternavn:
Directline_Principal -
Sekvensnummer:
1 -
Identitetstype:
Named Principal
-
Parameternavn:
- Velg Lagre.
- Velg Legg til under Godkjenningsparametere.
- Konfigurere:
-
Navn:
Token - Verdi: Din direkte linjehemmelighet fra trinn 1
-
Navn:
- Velg Lagre.
Opprette en egendefinert topptekst
- Velg Ny under Egendefinerte overskrifter i den eksterne legitimasjonen.
- Konfigurere:
-
Navn:
Authorization -
Verdi:
{!'Bearer ' & $Credential.Directline.Token} -
Sekvensnummer:
1
-
Navn:
- Velg Lagre.
Opprett den navngitte legitimasjonen
- Gå tilbake til fanen Navngitt legitimasjon .
- Velg ny>ny navngitt legitimasjon.
- Konfigurere:
-
Etikett:
Directline -
Navn:
Directline -
URL-adresse:
https://directline.botframework.com - Aktivert for uthevninger: Krysset av
-
Ekstern legitimasjon: Velg
Directline - Generer autorisasjonshode: Ikke avmerket
- Tillat formler i HTTP-topptekst: Merket
-
Etikett:
- Velg Lagre.
Trinn 5: Gi tillatelser til roboten
Einstein Bots krever en dedikert tillatelse satt til å få tilgang til Apex-klasser og ekstern legitimasjon. Du må gi roboten tilgang til komponentene du opprettet.
Gi tilgang til Apex-klassen
- Søk etter tillatelsessett i salesforce-konfigurasjonen, og velg Tillatelsessett.
- Finn og velg Chatbot-tillatelsessettet (API-navn: ).
sfdc_chatbot_service_permset - Velg Apex Class Access>Edit.
- Legg til følgende klasser:
DL_GetConversationDL_PostActivityDL_GetActivity
- Velg Lagre.
Gi ekstern legitimasjonskontohavertilgang
- Velg Ekstern legitimasjonskontohaver for tilgangsredigering i >.
- Legg til
Directline - Directline_Principal. - Velg Lagre.
Trinn 6: Konfigurere Einstein bot
- Gå til installasjonsprogrammet i Salesforce.
- Skriv inn Einstein i Hurtigsøk, og velg Einstein Bots.
- Opprett en ny Einstein-robot ved å følge instruksjonene i Salesforce Einstein-dokumentasjonen.
Trinn 7: Koble Einstein Bot til Copilot Studio
Konfigurer to dialogbokser i Einstein Bot for å koble til Copilot Studio: Dialogboksen Velkommen starter direktelinjesamtalen. Dialogboksen Forvirret videresender ukjente brukermeldinger til Copilot Studio og returnerer svaret.
Konfigurer dialogboksen Velkommen
Velkomstdialogboksen initialiserer Direkte linje-samtalen når en bruker begynner å chatte.
Legg til et hilsningsmeldingstrinn (valgfritt) i dialogboksen Velkommen.
Legg til et handlingstrinn med Apex for handlingstype og Start direktelinjesamtale for handlingsnavn (
DL_GetConversation).Tilordne utdatasamtale-ID-en til en variabel (for eksempel
ConversationID). Denne variabelen brukes av etterfølgende handlinger i dialogboksen Forvirret.Angi neste trinn til hovedmenyen eller samtaledialogboksen.
Trinnegenskaper-panelet viser variabeltilordningen for handlingen Start direktelinjesamtale:
-
Inndata: Navngitt legitimasjon: Satt til
Directline(navngitt legitimasjon fra trinn 4) -
Utdata:
-
Samtale-ID:
ConversationID(Tekst): Brukes av dialogbokshandlingene Forvirret. -
Svarkode:
responseCode(Tall): HTTP-statuskode. -
Feilmelding:
errorMessage(Tekst): Feildetaljer hvis samtalen mislykkes.
-
Samtale-ID:
Tips
Legg til et betingelsestrinn etter denne handlingen for å kontrollere variabelen responseCode . Hvis verdien ikke 200er det, kan du vise feilmeldingen for å diagnostisere tilkoblingsproblemer under installasjonen.
Konfigurer dialogboksen Confused
Dialogboksen Forvirret håndterer enhver brukermelding som Einstein ikke forstår, og videresender den til Copilot Studio.
Legg til et handlingstrinn med Handlingstype-apex og Handlingsnavn innleggsmelding i Copilot Studio (
DL_PostActivity).-
Inndata:
-
Brukermelding:
[System] Last Customer Input(obligatorisk) -
Samtale-ID:
ConversationIDvariabel fra dialogboksen Velkommen (obligatorisk) - Brukernavn, bruker-ID, navngitt legitimasjon: Valgfritt
-
Brukermelding:
-
Utdata:
-
Svarkode (
responseCode) [tall] -
Feilmelding (
errorMessage) [Tekst] -
Vannmerke (
watermark) [Tekst]: Sendt til neste handling.
-
Svarkode (
-
Inndata:
Legg til et handlingstrinn med Handlingstype-apex og Handlingsnavn Få Copilot Studio Response (
DL_GetActivity).-
Inndata:
-
Samtale-ID:
ConversationID: Variabel (obligatorisk) -
Vannmerke:
watermark: Variabel fra forrige handling. -
Maksimalt antall nye forsøk:
5(standard) -
Første forsinkelse (sekunder):
5(standard) -
Navngitt legitimasjon:
Directline
-
Samtale-ID:
-
Utdata:
-
Svarkode:
responseCode(tall) -
Melding:
mcsResponse(Tekst): Copilot Studio-agentens svar. -
Feilmelding:
errorMessage(Tekst) - Vannmerke: Oppdatert vannmerke for etterfølgende anrop.
- Har flere meldinger: (boolsk): Angir om flere meldinger er tilgjengelige.
- Is Handoff: (Boolean): Angir om Copilot Studio ber om agent-handoff.
-
Svarkode:
-
Inndata:
Obs!
Klassen DL_GetActivity inkluderer innebygd forsinkelse og prøv logikk på nytt for å håndtere asynkrone svar fra Copilot Studio. Som standard venter den fem sekunder før det første forsøket og starter på nytt opptil fem ganger. Du kan tilpasse denne virkemåten ved hjelp av valgfrie delaySeconds parametere og maxRetries inndataparametere.
- Legg til et meldingstrinn for å vise svaret til brukeren ved hjelp av variabelen
mcsResponse. - Angi neste trinn for å vente på kundeinndata , slik at samtaleløkken fortsetter.
Den fullstendige, forvirrede dialogboksflyten ser slik ut:
Trinn 8: Håndter overføring til agent
Hvis du vil aktivere eskalering av direkte agent, konfigurerer du eskaleringsutløsere direkte i Einstein Bot. Ved å bruke denne konfigurasjonen kan du rute brukerne til riktig Salesforce-Omni-Channel køer når de trenger menneskelig hjelp.
Hvis du vil ha mer informasjon, kan du se Salesforce-dokumentasjonen Rute diskusjoner fra en forbedret robot.