Abilitare i plug-in per l'IA generativa (anteprima)

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

I rappresentanti del servizio clienti (rappresentanti del servizio o rappresentanti) fanno affidamento su dati e informazioni provenienti da un'ampia varietà di sistemi. Con i plug-in è possibile interagire direttamente con i dati non Microsoft CRM. Questa interazione diretta consente di ridurre la necessità che i rappresentanti del servizio passino ad altre schede e strumenti per svolgere il proprio lavoro e migliorare i tempi di risoluzione e la soddisfazione del cliente.

Prerequisiti

• In Copilot Studio, se vuoi utilizzare un plug-in di prompt nel tuo agente di intelligenza artificiale incorporato, crea un plug-in di prompt .
• In Copilot Studio, se si vuole usare un connettore plug-in nell'agente di intelligenza artificiale incorporato, creare un connettore plug-in personalizzato.

Configurare i plugin

Per usare il plug-in prompt o il plug-in connettore nell'agente di intelligenza artificiale incorporato dopo aver creato il plug-in in Copilot Studio, è necessario abilitare il plug-in nell'interfaccia di amministrazione. Le sezioni seguenti descrivono come abilitare e configurare i plug-in.

Definizione degli input per le richieste

Quando si aggiungono input nella schermata Definisci input (facoltativo), abiliti il prompt per farlo diventare sensibile al contesto integrando automaticamente i dati pertinenti. Questo input consente Copilot di accedere direttamente ai campi specificati senza richiedere ai rappresentanti del servizio clienti di immettere manualmente le informazioni già esistenti nel sistema.

Se non configuri gli input, i prompt rimangono statici e non consentono di accedere al contesto. Il plug-in richiede quindi ai rappresentanti dell'assistenza ulteriori informazioni che devono immettere manualmente.

Si supponga, ad esempio, di avere una richiesta che recupera i dettagli dell'ordine di un cliente in base al nome e all'ID caso del cliente. Puoi aggiungere i campi Nome cliente e ID caso come input in Definizione degli input (facoltativo).

Quando un rappresentante del servizio apre un caso e attiva la richiesta, Copilot preleva automaticamente il nome del cliente e l'ID del caso dal record del caso e li usa come input alla richiesta.

Per gli agenti IA integrati, è necessario generare una Chiave del parametro. La Chiave del parametro è un identificatore univoco usato in un file JavaScript per recuperare il contesto richiesto da un CRM non Microsoft.

Impostare il parametro chiave

Per impostare i parametri nella pagina Definisci input, attieniti alla seguente procedura:

1. Specifica Tipo di record e Campo dati. È necessario specificare queste informazioni per generare la Chiave del parametro.

2. Seleziona Copia per copiare il valore nella Chiave del parametro. Il valore di Chiave del parametro è una variabile che il sistema utilizza in un JavaScript per memorizzare il valore che il sistema passa al plug-in come input.

3. Seleziona Salva.

   

4. Selezionare Next per passare ai dati del plug-in Save in Dynamics 365 e quindi completare i passaggi per completare la configurazione del plug-in.

5. Utilizza la Chiave del parametro che hai copiato al passaggio 2 nel file JavaScript. Per altre informazioni, vedi Passare la chiave del parametro come input al plug-in.

6. Configurare l'URL del file JavaScript in CRM non Microsoft per completare l'installazione.

Fornire il parametro chiave come input al plug-in

Creare un file JavaScript che usa la variabile Parameter Key copiata nel passaggio 2 di Impostare la chiave del parametro e sottoscrive la funzione Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData all'interno di Microsoft CCaaS Embed SDK. Di seguito vengono visualizzate le azioni applicabili:

• La funzione è in ascolto di una richiesta per ottenere i dati del plug-in.
• Recupera i dati richiesti dal sistema e assegna il valore alla variabile Chiave del parametro. Questa variabile Chiave del parametro è il valore copiato nel passaggio 2 della sezione Impostare la chiave del parametro.
• Restituisce il valore della variabile Chiave del parametro al plug-in. Il plug-in utilizza questo valore come input per il prompt.

Ad esempio, sono state generate due Chiavi del parametro, incident____customerid_account____accountid e customerid_account____accountid nella pagina Definisci input (facoltativo). Ecco il codice di esempio della funzione che restituisce un valore di 1 per incident____customerid_account____accountid e 2 per customerid_account____accountid che vengono quindi passati come input al 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);
  });
});

Configura l'URL nei CRM non Microsoft

È possibile aggiungere l'URL del file JavaScript all'URL del widget incorporabile di Copilot che si usa per incorporare il widget Copilot nel CRM non Microsoft aggiungendo "&copilotExtensionUrl=<URL to customer hosted .js file>" all'URL di incorporazione esistente.

Ad esempio, se l'URL per il file JavaScript è https://embedcopilotnonprod.blob.core.windows.net/embedcopilotnonprodcontainer/demopromptplugin.js, l'URL che devi aggiungere nei CRM non Microsoft è il seguente:

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

Gestire plug-in

Utilizzare le opzioni del menu dei comandi per gestire i plug-in. Il pulsante di modifica consente di aggiornare le impostazioni del plug-in e pubblicare le modifiche. Non puoi modificare alcuna impostazione mentre la pubblicazione è in corso.

Considerazioni

• Puoi aggiungere una sola azione di plug-in.
• Se si aggiorna il plug-in, è consigliabile salvare e ripubblicare il plug-in in Copilot Studio. È quindi possibile selezionare Refresh nel Plugins per l'intelligenza artificiale generativa (anteprima) nell'interfaccia di amministrazione del servizio Copilot per visualizzare le modifiche.