Aktivere plug-ins for generativ AI (forhåndsversion)

[Denne artikel er til dokumentationen til den foreløbige udgivelse. Der kan forekomme ændringer.]

Dine kundeservicemedarbejdere (servicemedarbejdere eller medarbejdere) stoler på data og information fra en lang række systemer. Med plug-ins kan du interagere direkte med dine CRM-data, der ikke er fra Microsoft CRM. Denne direkte interaktion hjælper med at reducere behovet for, at kundeservicerepræsentanter skifter til andre faner og værktøjer for at udføre deres arbejde og forbedre løsningstiden og kundetilfredsheden.

Forudsætninger

• I Copilot Studio, hvis du vil bruge et prompt-plugin i din integrerede AI-agent, skal du oprette et prompt-plugin.
• I Copilot Studio, hvis du vil bruge et connector-plugin i din integrerede AI-agent, skal du oprette et tilpasset connector-plugin.

Konfigurer plug-ins

Når du har oprettet plug-in'et Copilot Studio, og hvis du vil bruge prompt-plug-in'et eller connector-plug-in'et i dit integrerede AI-agent, skal du aktivere plug-in'et i Administration. Følgende afsnit beskriver, hvordan du aktiverer og konfigurerer plug-ins.

Plug-in med prompt

1. I Copilot Service Administration skal du vælge Produktivitet.
2. På siden Produktivitet skal du vælge Administrer for Plug-ins til generativ kunstig intelligens (forhåndsversion). Siden Plugins for generativ AI (forhåndsversion) vises med alle de plug-in-prompts, der er genereret for miljøet.
3. Vælg den prompt-plugin, du vil aktivere, og derefter vælger Aktivér på kommandolinjen.
4. Under Vælg adgangstype, vælg en af følgende typer:
   • Alle medarbejdere med Copilot: Medarbejdere, som har Copilot aktiveret for dem via deres profil for agenters oplevelse.
   • Specifikke brugerroller: Vælg rollerne på listen.
5. Skærmbilledet Definer input (valgfrit) vises. Dette trin er valgfrit og giver dig mulighed for at angive kontekst, som Copilot automatisk kan bruge til at generere svar. Hvis du ikke tilføjer et input, skal servicemedarbejderne manuelt angive konteksten, når de kører plug-in'et. Hvis du vil konfigurere input og få mere at vide om, hvordan denne funktion fungerer, skal du udføre trinnene i afsnittet Definer input.
6. Vælg Næste, og derefter på skærmbilledet Plug-in-data vælg Gem dette plug-ins data. Dataene gemmes i din Dataverse-database som en del af dine servicemedarbejder-interaktioner med Copilot som chatafskrifter. Få mere at vide i Copilot-afskrifter og -interaktionsdata.
7. Vælg Slå plug-in til.
8. Vælg Udgiv ændringer i advarselsmeddelelsen øverst på siden, og vælg derefter Bekræft i den bekræftelsesdialogboks, der vises. Det kan tage op til 15 minutter at ændringerne til at publicere.

Brugerdefineret connector-plug-in

1. Vælg et af følgende trin i oversigten over webstedet i Copilot Service Administration for at få adgang til plug-ins:

   • Vælg Produktivitet>Plug-ins til generativ AI (forhåndsversion) under Helpdesk-medarbejderoplevelse.
   • Vælg Indsigt>Plug-ins til generativ AI (forhåndsversion) under Handlinger.

2. Vælg Administrer.

3. På siden Plug-ins til generativ AI (forhåndsversion) skal du vælge et brugerdefineret connector-plug-in og derefter vælge Slå til på kommandolinjen.

4. I dialogboksen Vælg brugergodkendelse, vælg ellipseknappen (...) i Konfigurer et link til connectoren, og vælg derefter den ønskede forbindelse. En grøn markering indikerer, at datakilden har forbindelse.

5. Vælg en af følgende indstillinger i Brugergodkendelse:

   • Administrator: Bruger administratorgodkendelse til at give dataadgang til servicemedarbejdere.
   • Helpdesk-medarbejder: Kræver, at servicemedarbejder til at levere godkendelses under kørsel. Denne indstilling anbefales, hvis dataene er begrænsede eller følsomme.

6. Vælg en af følgende adgangstyper på skærmbilledet Administrer brugeradgang:

   • Alle medarbejdere med Copilot: Medarbejdere, som har Copilot aktiveret for dem via deres profil for agenters oplevelse.
   • Specifikke brugerroller: Vælg rollerne på listen.

7. Vælg Næste.

8. Skærmbilledet Definer input (valgfrit) vises. Dette trin er valgfrit og giver dig mulighed for at angive kontekst, som Copilot automatisk kan bruge til at generere svar. Hvis du ikke tilføjer et input, skal servicemedarbejderne manuelt angive konteksten, når de kører plug-in'et. Hvis du vil konfigurere input og få mere at vide om, hvordan denne funktion fungerer, skal du udføre trinnene i afsnittet Definer input.

9. I Svar skal du vælge Opsummer ikke plugin-svar, hvis du ikke ønsker, at Copilot skal fortolke svarene og i stedet præsentere hele det svar, der er tilgængeligt i plug-in.

10. Vælg Næste, og på skærmen Gem plug-in-data i Dynamics 365, vælg Gem dette plug-ins data i Dynamics 365 Copilot-udskrift. Dataene gemmes i din Dataverse-database som en del af dine servicemedarbejder-interaktioner med Copilot som chatafskrifter. Få mere at vide i Copilot-afskrifter og -interaktionsdata.

    Vigtige oplysninger

    Uanset om du markerer afkrydsningsfeltet, gemmer Copilot Studio alle plugin-data som en del af servicemedarbejders samtaleafskrifter. Microsoft har ikke adgang til disse oplysninger.

11. Vælg Slå plug-in til.

12. Vælg Udgiv ændringer i advarselsmeddelelsen øverst på siden, og vælg Bekræft i den bekræftelsesdialogboks, der vises. Det kan tage op til 15 minutter at ændringerne til at publicere.

Definere input til prompter

Når du tilføjer input på skærmbilledet Definer input (valgfrit), gør du din prompt til at blive kontekstafhængig ved automatisk at inkorporere relevante data. Dette input gør det muligt for Copilot at få direkte adgang til de angivne felter, uden at kundeservicemedarbejdere manuelt skal angive oplysninger, der allerede findes i systemet.

Hvis du ikke konfigurerer input, forbliver prompter statiske og mangler mulighed for at få adgang til konteksten. Plugin'et beder derefter servicerepræsentanterne om yderligere oplysninger, de skal indtaste manuelt.

Du har f.eks. en prompt, der henter en kundes ordreoplysninger baseret på kundens navn og sags-id. Du kan tilføje felterne Kundenavn og Sags-id som input i Definer input (valgfrit).

Når en servicemedarbejder åbner en sag og udløser prompten, henter Copilot automatisk kundenavnet og sags-id'et fra sagsposten og bruger dem som input til prompten.

For integrerede AI-agenter skal du generere en parameternøgle. Parameternøglen er et entydigt id, der bruges i en JavaScript-fil til at hente den nødvendige kontekst fra ikke-Microsoft CRM.

Indstil parameternøglen

For at indstille parametrene på siden Definer Inputs, udfør følgende trin:

1. Angiv posttypen og feltet Datafelt. Du skal angive disse oplysninger for at generere parameternøglen.

2. Vælg Kopiér for at kopiere værdien i parameternøglen. Parameternøgleværdien er en variabel, som systemet bruger i en JavaScript til at gemme den værdi, systemet overfører til plug-in som input.

3. Vælg Save.

   

4. Vælg Næste for at gå til Gem plugindata i Dynamics 365, og udfør derefter trinnene for at afslutte pluginkonfigurationen.

5. Brug parameternøglen du kopierede i trin 2 i JavaScript-filen. Få mere at vide i Send parameternøglen som input til plug-in.

6. Konfigurer URL-adressen til JavaScript-filen i ikke-Microsoft CRM for at fuldføre installationen.

Send parameternøglen som input til pluginet

Opret en JavaScript-fil, der bruger Parameternøgle variablen, som du kopierede i trin 2 af indstille parameternøglen i og abonnerer på Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData funktionen i Microsoft CCaaS Embed SDK. Følgende handlinger er tilgængelige:

• Funktionen lytter efter en anmodning om at hente plugin-data.
• Den henter de nødvendige data fra systemet og tildeler værdien til Parameternøgle variablen. Denne Parameternøgle variabel er den værdi, der kopieres i trin 2 af indstille parameternøglesektionen i afsnittet.
• Det returnerer værdien for Parameternøgle-variablen til plug-in. Pluginet bruger denne værdi som input til prompten.

Du har f.eks. genereret to parameternøglerincident____customerid_account____accountid og customerid_account____accountid på siden Definer input (valgfrit). Her er eksempelkoden for den funktion, der returnerer en værdi på 1 for incident____customerid_account____accountid og 2 for customerid_account____accountid , der derefter overføres som input til plug-in.

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);
  });
});

Bemærk

Sørg for at hoste denne fil på en webserver, og gør den offentligt tilgængelig for at undgå godkendelsesproblemer.

Konfigurer Webadressen i ikke-Microsoft CRM'er

Du kan føje URL-adressen til filen JavaScript til URL-adressen til den Copilot integrerbar widget-URL der kan bruge til at integrere Copilot-widget i dit ikke-Microsoft CRM, ved at føje "&copilotExtensionUrl=<URL to customer hosted .js file>" den til den eksisterende URL-adresse til integrering.

Hvis URL-adressen til din JavaScript-fil f.eks. er https://embedcopilotnonprod.blob.core.windows.net/embedcopilotnonprodcontainer/demopromptplugin.js, er den URL-adresse, du skal tilføje i dine ikke-Microsoft CRM'er, 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 plug-ins

Brug indstillingerne i kommandomenuen til at administrere plugins. Redigeringsknappen giver dig mulighed for at opdatere plugin-indstillingerne og offentliggøre ændringerne. Du kan ikke ændre nogen indstillinger, mens publiceringen er i gang.

Overvejelser

• Du kan kun tilføje én plugin-handling.
• Hvis du opdaterer plug-in, anbefaler vi, at du gemmer og genudgiver plug-in i Copilot Studio. Du kan derefter vælge Opdater på Plug-ins for generativ AI (forhåndsversion) i Copilot Service Administration for at se ændringerne.