Aktivér plugins for generativ AI (forhåndsvisning)

[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

• Hvis du i Copilot Studio vil bruge en prompt-plug-in i din integrerede AI-agent, skal du oprette en prompt-plug-in.
• Hvis du i Copilot Studio vil bruge en connector-plug-in i din integrerede AI-agent, skal du oprette en custom connector-plug-in.

Konfigurer plug-ins

Hvis du vil bruge plug-in'en med prompten eller connectoren i din integrerede AI-agent, når du har oprettet plug-in'en i Copilot Studio, skal du aktivere plug-in'en i Administration. Følgende afsnit beskriver, hvordan du aktiverer og konfigurerer plug-ins.

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 kræve, at repræsentanter for kundeservice manuelt angiver 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 tjenesterepræsentant å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 Next for at gå til Gem plug-in-data i Dynamics 365, og udfør derefter trinnene for at fuldføre plug-in-konfigurationen.

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 variablen Parameter Key, som du kopierede i trin 2 i Konfigurer parameternøglen og abonnerer på funktionen Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData 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);
  });
});

Konfigurer Webadressen i ikke-Microsoft CRM'er

Du kan føje URL-adressen til JavaScript-filen til Copilot URL-adressen til integreringsbaseret widget som du bruger til at integrere Copilot-widgetten i din ikke-Microsoft CRM ved at føje "&copilotExtensionUrl=<URL to customer hosted .js file>" 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'en, anbefaler vi, at du gemmer og publicerer plug-in'en igen i Copilot Studio. Du kan derefter vælge Refresh på Plugins for generative AI (Preview) i Copilot Service Administration for at se ændringerne.