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 si desidera utilizzare un plug-in di richieste nell'agente IA integrato, creare un plug-in di richieste.
• In Copilot Studio, se si desidera utilizzare un plug-in di connettori nell'agente IA integrato, creare un plug-in di connettori personalizzati.

Configurare i plug-in

Per utilizzare il plug-in di richieste o il plug-in di connettori nell'agente IA integrato dopo aver creato il plug-in, devi abilitare il plug-in Copilot Studio nell'interfaccia di amministrazione. Le sezioni seguenti descrivono come abilitare e configurare i plug-in.

Plug-in di richiesta

1. Nell'interfaccia di amministrazione di Copilot Service, seleziona Produttività.
2. Nella pagina Produttività, seleziona Gestisci per Plug-in per l'IA generativa (anteprima). Viene visualizzata la pagina Plug-in per IA generativa (anteprima) con tutti i prompt dei plug-in generati per l'ambiente.
3. Seleziona il plug-in della richiesta che desideri abilitare, quindi seleziona Abilita nella barra dei comandi.
4. In Seleziona tipo di accesso seleziona uno dei seguenti tipi:
   • Tutti gli agenti che hanno Copilot: agenti che hanno abilitato Copilot tramite i loro profili di esperienza agente.
   • Ruoli utente specifici: seleziona i ruoli nell'elenco.
5. Viene visualizzata la schermata Definisci input (facoltativo). Questo passaggio è facoltativo e ti consente di fornire il contesto che Copilot può usare automaticamente per generare le risposte. Se non aggiungi un input, i rappresentanti del servizio devono specificare manualmente il contesto quando eseguono il plug-in. Per configurare gli input e altre informazioni sul funzionamento di questa funzionalità, esegui i passaggi nella sezione Definire gli input.
6. Seleziona Avanti, quindi nella schermata Dati plug-in seleziona Archivia dati di questo plug-in. I dati vengono archiviati nel database Dataverse come parte delle tue interazioni di rappresentante del servizio con Copilot come trascrizioni di chat. Altre informazioni in Scaricare le trascrizioni e i dati di interazione di Copilot.
7. Seleziona Attiva plug-in.
8. Seleziona Pubblica modifiche nel messaggio di avviso nella parte superiore della pagina e quindi seleziona Conferma nella finestra di dialogo di conferma visualizzata. La pubblicazione delle modifiche può durare fino a 15 minuti.

Plug-in connettore personalizzato

1. Nella mappa del sito dell'interfaccia di amministrazione di Copilot Service, scegli uno dei seguenti passaggi per accedere ai plug-in:

   • Seleziona Produttività>Plug-in per IA generativa (Anteprima) in Esperienza agente.
   • Seleziona Insights>Plug-in per IA generativa (Anteprima) in Operazioni.

2. Seleziona Gestisci.

3. Nella pagina Plug-in per l'IA generativa (anteprima) seleziona il plug-in per del connettore personalizzato e quindi seleziona Attiva sulla barra dei comandi.

4. Nella finestra di dialogo Seleziona autenticazione utente, seleziona il pulsante con i puntini di sospensione (...) in Configura un collegamento al connettore, quindi seleziona la connessione obbligatoria. Un segno di spunta verde indica che la connessione all'origine dati è stata completata.

5. In Autenticazione utente seleziona una delle seguenti opzioni:

   • Amministratore: utilizza l'autenticazione dell'amministratore per concedere l'accesso ai dati ai rappresentanti del servizio.
   • Agente: richiede ai rappresentanti del servizio di autenticarsi in fase di esecuzione. Questa opzione è consigliata se i dati sono riservati o sensibili.

6. Nella schermata Gestire l'accesso degli utenti, seleziona uno dei seguenti tipi di accesso:

   • Tutti gli agenti che hanno Copilot: rappresentanti che hanno abilitato Copilot tramite i loro profili di esperienza agente.
   • Ruoli utente specifici: seleziona i ruoli nell'elenco.

7. Seleziona Avanti.

8. Viene visualizzata la schermata Definisci input (facoltativo). Questo passaggio è facoltativo e consente di fornire un contesto che Copilot può usare automaticamente per generare le risposte. Se non aggiungi un input, i rappresentanti del servizio devono specificare manualmente il contesto quando eseguono il plug-in. Per configurare gli input e altre informazioni sul funzionamento di questa funzionalità, esegui i passaggi nella sezione Definire gli input.

9. In Risposte, seleziona Non riepilogare le risposte del plug-in se non vuoi che Copilot interpreti le risposte e presenti invece l'intera risposta disponibile nel plug-in.

10. Seleziona Avanti e nella schermata Salvataggio dei dati del plug-in in Dynamics 365, quindi seleziona Salva i dati di questo plug-in nella trascrizione di Dynamics 365 Copilot. I dati vengono archiviati nel database Dataverse come parte delle tue interazioni di rappresentante del servizio con Copilot come trascrizioni di chat. Altre informazioni in Scaricare le trascrizioni e i dati di interazione di Copilot.

    Importante

    Indipendentemente dal fatto che selezioni la casella di controllo, Copilot Studio salva tutti i dati del plug-in come parte delle trascrizioni delle conversazioni del rappresentante del servizio. Microsoft non ha accesso a queste informazioni.

11. Seleziona Attiva plug-in.

12. Seleziona Pubblica modifiche nel messaggio di avviso nella parte superiore della pagina e seleziona Conferma nella finestra di dialogo di conferma visualizzata. La pubblicazione delle modifiche può durare fino a 15 minuti.

Definizione degli input per le richieste

Quando si aggiungono input nella schermata Definisci input (facoltativo) abiliti la richiesta in modo che diventi sensibile al contesto integrando automaticamente i dati pertinenti. Questo input consente a 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 utilizza come input per la 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 la chiave del parametro

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. Selezionare Salva.

   

4. Seleziona Avanti per andare a Salva i dati del plug-in in Dynamics 365, quindi completa i passaggi per completare la configurazione del plug-in.

5. Utilizza 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.

Passare la chiave del parametro come input al plug-in

Crea un file JavaScript che usa la variabile Chiave del parametro copiata nel passaggio 2 di Impostare la chiave del parametro e sottoscrive la funzione Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData all'interno dell'SDK Microsoft CCaaS Embed. 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);
  });
});

Nota

Assicurati di ospitare questo file su un server Web e di renderlo accessibile pubblicamente per evitare problemi di autenticazione.

Configura l'URL in CRM non Microsoft

È possibile aggiungere l'URL del file JavaScript all'URL del widget Copilot integrabile utilizzato per integrare il widget Copilot nel CRM non Microsoft aggiungendo "&copilotExtensionUrl=<URL to customer hosted .js file>" all'URL di integrazione 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 aggiorni il plug-in, ti consigliamo di salvarlo e ripubblicarlo in Copilot Studio. Puoi quindi selezionare Aggiorna nei Plug-in per IA generativa (anteprima) nell'interfaccia di amministrazione di Copilot Service per visualizzare le modifiche.