Invoegtoepassingen inschakelen voor generatieve AI (preview)

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Uw klantenservicemedewerkers (servicemedewerkers of medewerkers) baseren zich op gegevens en informatie uit een grote verscheidenheid aan systemen. Met plug-ins kunt u rechtstreeks met uw niet-Microsoft CRM-gegevens werken. Door deze directe interactie hoeven servicemedewerkers minder vaak over te schakelen naar andere tabbladen en tools om hun werk te doen, en verbetert de oplostijd en de klanttevredenheid.

Voorwaarden

• Als u in Copilot Studio een invoegtoepassing voor prompts wilt gebruiken in uw ingesloten AI-agent, maakt u een invoegtoepassing voor prompts.
• Als u in Copilot Studio een invoegtoepassing voor connectors wilt gebruiken in uw ingesloten AI-agent, maakt u een aangepaste invoegtoepassing voor connectors.

Plugins configureren

Als u de invoegtoepassing voor prompts of invoegtoepassing voor connectors in uw ingesloten AI-agent te gebruiken nadat u de invoegtoepassing hebt gemaakt in Copilot Studio, moet u de invoegtoepassing inschakelen in het beheercentrum. In de volgende secties wordt beschreven hoe u plug-ins kunt inschakelen en configureren.

Promptinvoegtoepassing

1. Ga naar het Copilot Service-beheercentrum en selecteer Productiviteit.
2. Selecteer op de pagina Productiviteit de optie Beheren voor Invoegtoepassingen voor generatieve AI (preview). De pagina Plugins voor generatieve AI (Preview) wordt weergegeven, met alle plug-inprompts die voor de omgeving zijn gegenereerd.
3. Selecteer de invoegtoepassing voor prompts die u wilt inschakelen en selecteer vervolgens Inschakelen op de opdrachtbalk.
4. Selecteer bij Toegangstype selecteren een van de volgende typen:
   • Alle agenten die Copilot hebben: agenten voor wie Copilot is ingeschakeld via hun agentervaringsprofiel.
   • Specifieke gebruikersrollen: selecteer de rollen in de lijst.
5. Het scherm Invoer definiëren (optioneel) wordt weergegeven. Deze stap is optioneel en zorgt ervoor dat u context kunt opgeven die Copilot automatisch kan gebruiken om antwoorden te genereren. Als u geen invoer toevoegt, moeten servicemedewerkers de context handmatig opgeven wanneer ze de plug-in uitvoeren. Voer de stappen in de sectie Invoer definiëren uit om invoer te configureren en meer te weten te komen over hoe deze functie werkt.
6. Selecteer Volgende en selecteer vervolgens op het scherm Gegevens van invoegtoepassing de optie Gegevens van deze invoegtoepassing opslaan. De gegevens worden als chattranscripties opgeslagen in uw Dataverse-database als onderdeel van uw interacties met Copilot als servicemedewerker. Meer informatie is te vinden in Copilot-transcripties en interactiegegevens downloaden.
7. Selecteer Invoegtoepassing inschakelen.
8. Selecteer Wijzigingen publiceren in het waarschuwingsbericht boven aan de pagina en selecteer vervolgens Bevestigen in het bevestigingsvenster dat verschijnt. Het kan tot 15 minuten duren voordat de wijzigingen zijn gepubliceerd.

Aangepaste invoegtoepassing voor connector

1. Kies in de sitemap van het Copilot Servicebeheercentrum een van de volgende stappen om toegang te krijgen tot de plug-ins:

   • Selecteer Productiviteit>Invoegtoepassingen voor generatieve AI (preview) onder Agentervaring.
   • Selecteer Inzichten>Invoegtoepassingen voor generatieve AI (preview) onder Bewerkingen.

2. Selecteer Beheren.

3. Selecteer op de pagina Invoegtoepassingen voor generatieve AI (preview) de invoegtoepassing voor aangepaste connectors en selecteer vervolgens Inschakelen in de opdrachtbalk.

4. Selecteer in het dialoogvenster Gebruikersverificatie selecteren de knop met het weglatingsteken (…) in Een koppeling naar de connector instellen en selecteer vervolgens de gewenste verbinding. Een groen vinkje geeft aan dat de gegevensbron succesvol is verbonden.

5. Selecteer een van de volgende opties in Gebruikersverificatie:

   • Beheerder: gebruikt beheerdersverificatie om servicemedewerkers toegang tot gegevens te verlenen.
   • Agent: vereist dat servicemedewerkers verificatie bieden tijdens runtime. Deze optie wordt aanbevolen als de gegevens beperkt of gevoelig zijn.

6. Selecteer een van de volgende toegangstypen op het scherm Gebruikerstoegang beheren:

   • Alle agenten die Copilot hebben: medewerkers voor wie Copilot is ingeschakeld via hun agentervaringsprofiel.
   • Specifieke gebruikersrollen: selecteer de rollen in de lijst.

7. Selecteer Volgende.

8. Het scherm Invoer definiëren (optioneel) wordt weergegeven. Deze stap is optioneel en stelt u in staat om context te verstrekken die Copilot automatisch kan gebruiken om antwoorden te genereren. Als u geen invoer toevoegt, moeten servicemedewerkers de context handmatig opgeven wanneer ze de plug-in uitvoeren. Voer de stappen in de sectie Invoer definiëren uit om invoer te configureren en meer te weten te komen over hoe deze functie werkt.

9. Selecteer in Responsende optie Responsen van invoegtoepassingen niet samenvatten als u niet wilt dat Copilot de antwoorden interpreteert en in plaats daarvan de volledige respons presenteert die beschikbaar is in de invoegtoepassing.

10. Selecteer Volgende en selecteer op het scherm Invoegtoepassingsgegevens opslaan in Dynamics 365 de optie Gegevens van deze invoegtoepassing opslaan in Dynamics 365 Copilot-transcriptie. De gegevens worden als chattranscripties opgeslagen in uw Dataverse-database als onderdeel van uw interacties met Copilot als servicemedewerker. Meer informatie is te vinden in Copilot-transcripties en interactiegegevens downloaden.

    Belangrijk

    Ongeacht of u het selectievakje inschakeld, slaat Copilot Studio alle invoegtoepassingsgegevens op als onderdeel van de transcripties van de gesprekken van medewerkers. Microsoft heeft geen toegang tot deze informatie.

11. Selecteer Invoegtoepassing inschakelen.

12. Selecteer Wijzigingen publiceren in het waarschuwingsbericht boven aan de pagina en selecteer Bevestigen in het bevestigingsdialoogvenster dat verschijnt. Het kan tot 15 minuten duren voordat de wijzigingen zijn gepubliceerd.

Definieer invoer voor prompts

Wanneer u invoer toevoegt op het scherm Invoer definiëren (optioneel), wordt uw prompt contextbewust door automatisch relevante gegevens op te nemen. Met deze invoer kan Copilot rechtstreeks toegang krijgen tot de opgegeven velden, zonder dat klantenservicemedewerkers handmatig informatie hoeven in te voeren die al in het systeem staat.

Als u geen invoer configureert, blijven de prompts statisch en is er geen mogelijkheid om toegang tot de context te hebben. Vervolgens vraagt de plug-in de servicemedewerkers om aanvullende informatie die ze handmatig moeten invoeren.

U hebt bijvoorbeeld een prompt die de bestelgegevens van een klant ophaalt op basis van de naam van de klant en de case-ID. U kunt de velden klantnaam en case-id toevoegen als invoer in Invoer definiëren (optioneel).

Wanneer servicemedewerker een case opent en de prompt activeert, haalt Copilot automatisch de klantnaam en case-ID op uit de caserecord en gebruikt deze als invoer voor de prompt.

Voor ingesloten AI-agenten moet u een parametersleutel genereren. De parametersleutel is een unieke identificatie die in een JavaScript-bestand wordt gebruikt om de vereiste context op te halen uit de niet-Microsoft CRM.

De parametersleutel instellen

Voer de volgende stappen uit om de parameters op de pagina Invoer definiëren in te stellen:

1. Geef het recordtype en het gegevensveld op. U moet deze informatie opgeven om de parametersleutel te genereren.

2. Selecteer Kopiëren om de waarde in Parametersleutel te kopiëren. De waarde Parametersleutel is een variabele die het systeem gebruikt in een JavaScript om de waarde op te slaan die het systeem als invoer aan de invoegtoepassing doorgeeft.

3. Selecteer Opslaan.

   

4. Selecteer Volgende om naar Invoegtoepassingsgegevens opslaan in Dynamics 365 te gaan en voltooi vervolgens de stappen om de configuratie van de invoegtoepassing te voltooien.

5. Gebruik de parametersleutel die u in stap 2 hebt gekopieerd in het JavaScript-bestand. Meer informatie vindt u in De parametersleutel doorgeven als invoer aan de invoegtoepassing.

6. Configureer de URL van het JavaScript-bestand in niet-Microsoft CRM's om de installatie te voltooien.

Geef de parametersleutel door als invoer aan de plug-in

Maak een JavaScript-bestand dat de variabele Parametersleutel gebruikt die u in stap 2 van De parametersleutel instellen en abonneer u op de functie Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData in de Microsoft CCaaS Embed SDK. De volgende acties zijn van toepassing:

• De functie luistert naar een verzoek om plug-ingegevens op te halen.
• Hiermee worden de benodigde gegevens uit het systeem opgehaald en wordt de waarde toegewezen aan de variabele Parametersleutel. Deze variabele Parametersleutel is de waarde die is gekopieerd in stap 2 van de sectie De parametersleutel instellen.
• Hiermee wordt de waarde van de variabele Parametersleutel geretourneerd aan de invoegtoepassing. De plugin gebruikt deze waarde als invoer voor de prompt.

U hebt bijvoorbeeld twee parametersleutels, incident____customerid_account____accountid en customerid_account____accountid, gegenereerd op de pagina Invoer definiëren (optioneel). Hier is de voorbeeldcode van de functie die een waarde van 1 voor incident____customerid_account____accountid en 2 voor customerid_account____accountid retourneert. Deze worden vervolgens als invoer doorgegeven aan de invoegtoepassing.

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

Notitie

Zorg ervoor dat u dit bestand op een webserver host en het openbaar toegankelijk maakt om authenticatieproblemen te voorkomen.

De URL configureren in niet-Microsoft CRM's

U kunt de URL van uw JavaScript-bestand toevoegen aan de URL van de insluitbare widget van Copilot die u gebruikt om de Copilot-widget in te sluiten in uw niet-Microsoft CRM door "&copilotExtensionUrl=<URL to customer hosted .js file>" toe te voegen aan de bestaande insluit-URL.

Als de URL voor uw JavaScript-bestand bijvoorbeeld https://embedcopilotnonprod.blob.core.windows.net/embedcopilotnonprodcontainer/demopromptplugin.js is, moet u de volgende URL toevoegen aan uw niet-Microsoft CRM's:

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

Plugins beheren

Gebruik de opties in het opdrachtmenu om de plug-ins te beheren. Met de knop Bewerken kunt u de plug-ininstellingen bijwerken en de wijzigingen publiceren. U kunt geen instellingen wijzigen terwijl de publicatie bezig is.

Overwegingen

• U kunt slechts één invoegtoepassingsactie toevoegen.
• Als u de invoegtoepassing bijwerkt, raden wij u aan de invoegtoepassing op te slaan en opnieuw te publiceren in Copilot Studio. U kunt vervolgens Vernieuwen selecteren in Invoegtoepassingen voor generatieve AI (preview) in het Copilot Service-beheercentrum om de wijzigingen te bekijken.