Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[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.
- Nell'interfaccia di amministrazione di Copilot Service, seleziona Produttività.
- 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.
- Seleziona il plug-in della richiesta che desideri abilitare, quindi seleziona Abilita nella barra dei comandi.
- 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.
- 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.
- 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.
- Seleziona Attiva plug-in.
- 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.
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:
Specifica Tipo di record e Campo dati. È necessario specificare queste informazioni per generare la Chiave del parametro.
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.
Selezionare Salva.
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.
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.
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.