Aktiver programtillegg for generativ kunstig intelligens (forhåndsversjon)

[Denne artikkelen inneholder dokumentasjon for forhåndsversjonen og kan bli endret.]

Kundeservicerepresentantene (servicerepresentanter eller representanter) er avhengige av data og informasjon fra en lang rekke systemer. Med programtillegg kan du samhandle direkte med CRM-data som ikke er fra Microsoft. Denne direktesamhandlingen bidrar til å redusere behovet for servicerepresentanter å bytte til andre faner og verktøy for å gjøre jobben sin og forbedrer løsningstiden og kundetilfredsheten.

Forutsetning

• Hvis du vil bruke en ledeteksttillegg i den innebygde AI-agenten i Copilot Studio, oppretter du et plugin-modul for prompt.
• Hvis du vil bruke en plugin-modul for tilkobling i den innebygde AI-agenten i Copilot Studio, oppretter du plugin-modulen kutomkobling.

Konfigurer programtillegg

Hvis du vil bruke plugin-modulen for ledetekst eller tilkobling i den innebygde AI-agenten etter at du har opprettet plugin-modulen Copilot Studio, må du aktivere plugin-modulen i administrasjonssenteret. Delene nedenfor beskriver hvordan du aktiverer og konfigurerer plugin-moduler.

Definer inndata for ledetekster

Når du legger til inndata på skjermen Definer inndata (valgfritt), aktiverer du spørringen til å bli kontekstbevisst ved automatisk å inkludere relevante data. Denne inndataene gjør det mulig for Copilot å få direkte tilgang til de angitte feltene uten å kreve at kundeservicerepresentanter manuelt angir informasjon som allerede finnes i systemet.

Hvis du ikke konfigurerer inndata, forblir ledetekstene statiske og mangler muligheten til å få tilgang til kontekst. Programtillegget ber deretter servicerepresentantene om ytterligere informasjon de må angi manuelt.

Du har for eksempel en spørring som henter en kundes ordredetaljer basert på kundens navn og saks-ID. Du kan legge til feltene for kundenavn og saks-ID som inndata i Definer inndata (valgfritt).

Når en tjenesterepresentant åpner en sak og utløser ledeteksten, henter Copilot automatisk kundenavnet og saks-ID-en fra saksposten og bruker dem som inndata til ledeteksten.

For innebygde KI-agenter må du generere en parameternøkkel. Parameternøkkelen er en unik identifikator som brukes i en JavaScript-fil til å hente den nødvendige konteksten fra CRM som ikke er fra Microsoft.

Konfigurer parameternøkkelen

Hvis du vil konfigurere parameterne på siden Definer inndata, følger du denne fremgangsmåten:

1. Angi oppføringstypen og datafeltet. Du må angi denne informasjonen for å generere parameternøkkelen.

2. Velg Kopier for å kopiere verdien i Parameternøkkel. Verdien Parameternøkkel er en variabel systemet bruker i en JavaScript for å lagre verdien systemet sender til programtillegget som inndata.

3. Velg Lagre.

   

4. Velg Next for å gå til Lagre plugin-data i Dynamics 365, og fullfør deretter trinnene for å fullføre plugin-konfigurasjonen.

5. Bruk parameternøkkelen du kopierte i trinn 2, i JavaScript-filen. Finn ut mer i Send parameternøkkelen som inndata til programtillegget.

6. Konfigurer nettadressen til JavaScript-filen i CRM-er som ikke er fra Microsoft, for å fullføre oppsettet.

Send parameternøkkelen som inndata til pluginet

Opprett en JavaScript-fil som bruker Parameternøkkel variabelen du kopierte i trinn 2 av Sett opp parameternøkkelen og abonnerer på Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData-funksjonen i Microsoft CCaaS Embed SDK. Følgende handlinger er aktuelle:

• Funksjonen lytter etter en forespørsel om å få plugin-data.
• Den henter de nødvendige dataene fra systemet og tildeler verdien til variabelen Parameternøkkel. Denne parameternøkkelvariabelen er verdien som ble kopiert i trinn 2, i delen Konfigurer parameternøkkelen.
• Den returnerer verdien Parameternøkkel til programtillegget. Plugin bruker denne verdien som innspill til ledeteksten.

Du genererte for eksempel to parameternøkler, incident____customerid_account____accountid og customerid_account____accountid på siden Definer inndata(valgfritt). Her er eksempelkoden til funksjonen som returnerer en verdi på 1 for incident____customerid_account____accountid og 2 for customerid_account____accountid, som deretter sendes som inndata til programtillegget.

Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData((request) => {
  return new Promise((resolve, reject) => {
    // 7 get plugin data
    const { objectData } = request;
    const pluginContext = objectData || {};
    const { entityId, entityName, parameters, parameterValues } = pluginContext;
    let responseData = null;
  console.log("External adapter plugin invoked...");
 
    if (entityName === "incident" && // sample entity name (case == incident)
      parameters.length > 0) {
      // copy parameter values
      const values = parameterValues;
      // override parameter values for 1P or 3P scenario
      parameters.forEach((param) => {
        if (param === "incident____customerid_account____accountid") {
          values[param] = "1";
        }
    
    if (param === "customerid_account____accountid") {
          values[param] = "2";
        }
      });
      // return the updated parameter values
      responseData = {
        entityId,
        entityName,
        parameters,
        parameterValues: values,
      };
    }
    const dataResponse = {
      objectId: request.objectId,
      objectType: request.objectType,
      data: responseData,
    };
  console.log("External adapter sending data from plugin:",responseData);
    resolve(dataResponse);
  });
});

Konfigurer nettadressen til CRM-er som ikke er fra Microsoft

Du kan tilføye URL-adressen til JavaScript-filen i Copilot url-adresse for kontrollprogram for innebygging som du bruker til å bygge inn kontrollprogrammet for Copilot i ikke-Microsoft CRM ved å legge til "&copilotExtensionUrl=<URL to customer hosted .js file>" i den eksisterende innebyggings-URL-adressen.

Hvis nettadresse for JavaScript-filen for eksempel er https://embedcopilotnonprod.blob.core.windows.net/embedcopilotnonprodcontainer/demopromptplugin.js, er nettadresse du må legge til i CRM-er som ikke er fra Microsoft, som følger:

https://copilotforservice-prod.azureedge.net/widget/index.html?dynamicsUrl=https://X<your_org_URL>&copilotExtensionUrl=https://embedcopilotnonprod.blob.core.windows.net/embedcopilotnonprodcontainer/demopromptplugin.js

Administrer programtillegg

Bruk alternativene på kommandomenyen for å administrere programtilleggene. Med redigeringsknappen kan du oppdatere innstillingene for programtilleggene og publisere endringene. Du kan ikke endre noen innstillinger mens publiseringen pågår.

Vurderinger

• Du kan bare legge til én programtilleggshandling.
• Hvis du oppdaterer plugin-modulen, anbefaler vi at du lagrer og publiserer programtillegget på nytt Copilot Studio. Deretter kan du velge Refresh på Plugins for generative AI (Preview) i administrasjonssenteret for Copilot tjeneste for å se endringene.