Estendi Microsoft 365 Copilot o Copilot agenti con azioni di connessione (anteprima)

Le azioni di connettore ti consentono di definire connettori che possono essere richiamati dalle superfici dell'intelligenza artificiale in Power Platform. Per le azioni di connettore, è necessario identificare le azioni abilitate per l'uso in Copilot. Puoi anche acquisire le informazioni necessarie ai modelli linguistici di grandi dimensioni per identificare e utilizzare in modo efficace il plug-in, come ad esempio i campi di riepilogo e descrizione.

Prerequisiti

Per estendere le esperienze del Copilot Microsoft con azioni di connettore sono necessari alcuni prerequisiti.

Prerequisiti generali

Per tutti i tipi di Copilot, è necessario disporre delle credenziali di creatore, una licenza di copilota e una licenza Microsoft Teams.

Microsoft 365 Copilot vendite agente e Microsoft 365 Copilot servizio agente prerequisiti

Per il servizio Microsoft 365 Copilot agente e Microsoft 365 le vendite Copilot agente, devi aver effettuato l'accesso a un ambiente che contiene il agente che desideri estendere.

Microsoft 365 Copilot vendite agente prerequisiti

• I clienti Salesforce devono aver effettuato l'accesso al proprio ambiente Dataverse. Questo ambiente è solitamente denominato msdyn_viva.
• È necessario effettuare l'accesso a Microsoft 365 Copilot sales agente tramite Outlook nel ambiente che si desidera estendere almeno una volta prima di procedere all'estensione.

Aggiungi un'azione di connettore

L'aggiunta di un'azione di connettore a un copilota Microsoft comporta alcuni passaggi. Le sezioni seguenti forniscono indicazioni su come aggiungere un'azione connettore a Microsoft 365 Copilot, Microsoft 365 Copilot per le vendite e Microsoft 365 Copilot per l'assistenza.

Seleziona il agente e scegli l'azione del connettore

1. Nella home page, Seleziona Agenti.

   

2. Nell'elenco degli agenti nel menu di navigazione a sinistra, digita Seleziona e digita agente Copilot che desideri estendere.

   

   Viene visualizzata la pagina di panoramica per agente.

3. Seleziona la scheda Azioni. Puoi vedere un elenco delle azioni già presenti in Copilot.

4. Quindi seleziona + Aggiungi azione.

   Ti verrà fornito un elenco di tutti i tipi di azioni supportati per agente Copilot.

   

5. Seleziona Connettore per estenderlo con un'azione di connettore.

   Viene visualizzata la pagina Seleziona il connettore. Viene fornito un elenco di tipi di connettori disponibili tra cui scegliere.

   I connettori collegano i copiloti a diversi servizi. L'elenco include tutti i connettori certificati offerti da Microsoft.

   A seconda del Copilot, l'elenco potrebbe includere anche connettori personalizzati presenti nell'ambiente corrente. È disponibile una barra di ricerca per trovare il connettore che desideri utilizzare.

   Nota

   Al momento non è possibile aggiungere connettori personalizzati Microsoft 365 Copilot servizio agente.

Seleziona il tipo di connettore e una soluzione

1. Trova il tipo di connettore utilizzando la barra di ricerca e selezionalo.

   

   Viene visualizzata la pagina Crea un'azione IA personalizzata utilizzando il tuo connettore.

2. Scrivi un nome e una descrizione per il connettore.

   Il nome del connettore essere univoco. Per impostazione predefinita, assume il tipo di connettore scelto. Dovresti aggiungere maggiori informazioni di definizione per assicurarti che sia un nome univoco e che sia facile discernere cosa fa per gli utenti che desiderano abilitarlo in un secondo momento. Valuta la possibilità di includere nella descrizione i tipi di azioni consentite, ad esempio "Servizio di posta: consente di recuperare e creare messaggi".

   

   La descrizione potrebbe essere fornita se presente nel connettore selezionato. La descrizione viene utilizzata da agente Copilot per identificare quando l'azione può essere utilizzata per ottenere risposte alla richiesta dell'utente. Scrivi la descrizione nel modo più dettagliato e descrittivo possibile. Fornisci dettagli specifici utilizzando i termini che prevedi che gli utenti utilizzino quando richiedono l'azione. Per continuare con l'esempio del servizio di posta, potresti includere qualcosa come:

   "Il servizio di posta offre la possibilità di ottenere elenchi di messaggi esistenti, recuperare cartelle in cui sono archiviati i messaggi, elencare titoli di messaggi e cartelle, ricevere messaggi, aggiornare titoli e corpi dei messaggi e impostare la priorità per i messaggi."

   La descrizione consente all'utente agente Copilot di sapere di utilizzare l'azione senza ricevere istruzioni esplicite, consentendo un'esperienza di linguaggio più naturale.

3. In Soluzione, un menu a discesa elenca tutte le soluzioni disponibili nell'ambiente corrente. Seleziona la soluzione che vuoi usare. Per ulteriori informazioni su quali sono le soluzioni e perché apportano vantaggi, vedi Concetti della soluzione.

   

   Se hai una soluzione preferita o il connettore selezionato è già presente nella soluzione, tale soluzione verrà selezionata automaticamente. Puoi selezionare una soluzione o lasciarla vuota. Se la lasci la soluzione vuota, viene creata automaticamente una soluzione con nome azione ed editore predefinito. Memorizzare la tua azione in una soluzione ti consente di spostarla facilmente tra gli ambienti.

   Nota

   In questo caso non vedi la soluzione predefinita o la soluzione predefinita CDS come opzione poiché consigliamo di avere una soluzione personalizzata per facilitare la gestione. Per altre informazioni, vedi Soluzione predefinita e soluzione personalizzata.

4. Scegli una soluzione e seleziona Avanti.

   Viene visualizzata la pagina Seleziona e configura la tua azione di plug-in. Questa pagina mostra tutte le azioni disponibili da aggiungere al tuo connettore. Puoi selezionare e configurare le azioni che vuoi che il tuo copilota supporti, una alla volta. È disponibile una barra di ricerca per aiutarti a trovare l'azione che desideri selezionare. Non esiste un limite al numero di azioni che puoi selezionare il connettore.

   

Aggiunta di azioni al connettore

Successivamente, è necessario selezionare le azioni disponibili per aggiungerle al connettore.

1. Seleziona un'azione per procedere. Viene visualizzata la pagina Configura la tua azione di plug-in per l'azione scelta.

   

2. Fornire un nome e una descrizione per la tua azione. In questo caso il nome non deve necessariamente essere univoco. Molto probabilmente questi valori verranno popolati dal connettore. Tuttavia, come per la descrizione del connettore, è necessario fornire una descrizione dettagliata in modo che agente sappia quando richiamare l'azione specifica. La descrizione aiuta a consentire un approccio basato sul linguaggio più naturale per selezionare l'azione da eseguire. Ad esempio, se un'azione è "Elenca cartelle messaggi", potresti utilizzare:

   "Elenca cartelle messaggi consente di ottenere un elenco di tutte le cartelle dei messaggi disponibili dal servizio di posta. Questa azione recupera tutte le cartelle e le inserisce in una visualizzazione elenco e le restituisce".

   La descrizione dell'azione fornisce gli indizi contestuali "elenca cartelle messaggi", "recupera", "tutto", "recupera", "elenca", "servizio di posta", "restituisci", "cartelle" e "visualizza". Il tuo copilota può utilizzare questi indizi contestuali per identificare quando l'azione è quella giusta per una richiesta dell'utente.

3. Dopo aver completato la pagina, seleziona Avanti. Viene visualizzata la pagina Rivedi i parametri dell'azione.

4. Per procedere, seleziona Avanti.

   Questa azione ti riporta alla pagina Seleziona e configura l'azione del tuo plugin . Puoi vedere la nuova azione selezionata.

   

5. Seleziona un'altra azione e ripeti i passaggi di configurazione dell'azione precedente, se lo desideri.

   In alternativa, seleziona Avanti. Viene visualizzata la schermata Rivedi, testa e pubblica la tua azione.

   

   Nella pagina Rivedi, testa e pubblica la tua azione vengono visualizzati i dettagli di tutti i passaggi di configurazione fino a questo punto. Puoi esaminarli e quindi testare la tua azione prima della pubblicazione.

Test

Una volta configurata l'azione di connettore, ora puoi testarla.

1. Seleziona la connessione esistente dal menu a discesa o seleziona + Nuova connessione se non disponi di una connessione.

   Se selezioni + Nuova connessione, si apre una procedura guidata in cui puoi aggiungere dettagli per creare la connessione. Al termine, puoi selezionare la nuova connessione dal menu a discesa.

2. Al termine della selezione della connessione, seleziona Testa azione.

3. Quando vedi un messaggio che l'azione è pronta per essere testata, Seleziona Apri per testare per aprire la chat copilota in una nuova finestra. Apri il riquadro a comparsa per vedere l'azione e attivala.

   L'azione viene visualizzata con l'icona di un bicchiere sotto il connettore scelto con formato Nome azione test.

4. Ora puoi testare il plug-in provando le istruzioni che ti aspetti vengano utilizzate da un utente. Puoi anche utilizzare il comando –developer on per ottenere maggiori informazioni sull'esecuzione della richiesta. Una volta che sei soddisfatto dei risultati, torna alla finestra Copilot Studio.

Pubblica

1. Una volta terminato il test, seleziona Pubblica.

   Viene visualizzata una pagina che mostra che il connettore sta per essere pubblicato. Al termine, vedi una pagina che indica che il tuo connettore è pubblicato.

2. Seleziona Vai alla pagina dei dettagli per visualizzare i dettagli del connettore pubblicato.

   Nota

   Ora che il tuo connettore è pubblicato, deve essere abilitato da un amministratore prima che possa essere utilizzato nel copilota. Se non vedi il connettore nel copilota, assicurati che sia abilitato tramite Microsoft Admin Center o la pagina degli agenti Copilot. Una volta abilitato correttamente, il connettore verrà visualizzato nel menu a comparsa. La prima volta che esegui questo passaggio, può esserci un ritardo fino a 24 ore.

3. Puoi anche spostare facilmente un connettore da un ambiente a un altro utilizzando una soluzione. Per fare ciò, seleziona Esporta soluzione nella pagina dei dettagli. L'esportazione della soluzione consente di esportare il connettore.

   

4. Se necessario, modifica il numero di versione e indica se la soluzione deve essere gestita o non gestita.

   • Gestita indica che non devi apportare ulteriori modifiche alla soluzione.
   • Non gestita significa che desideri apportare modifiche alla soluzione nell'ambiente di destinazione.

5. Al termine, vedi un messaggio verde con l'opzione Scarica che consente di scaricare la soluzione e salvarla come file ZIP nel tuo sistema.

   Nota

   Non è necessario selezionare Pubblica nel riquadro delle soluzioni.

6. Ritorna alla pagina agente Azioni in Copilot Studio e Seleziona Importa soluzione nel target ambiente.

   

7. Sfoglia per selezionare il file .zip della soluzione esportata e seleziona Avanti per procedere. Puoi vedere il connettore nell'elenco Azioni.

Eliminare un'azione di connettore

Se è necessario eliminare un'azione di connettore, procedi come segue.

Individuare la soluzione utilizzata dall'azione di connettore

La procedura per eliminare un'azione di connettore viene eseguita in Power Apps Maker Portal. Tuttavia, è necessaria la soluzione utilizzata per l'azione di connettore in Copilot Studio.

1. Copilot Studio aperti.

2. Seleziona l'ambiente utilizzato per creare l'azione di connettore.

3. In Agenti, Seleziona il agente in cui è stata creata l'azione del connettore.

4. Seleziona la scheda Azioni per visualizzare l'elenco delle azioni associate a agente.

5. Seleziona l'azione che desideri eliminare e prendi nota del nome della soluzione.

   

Eliminare un connettore in Power Apps Maker Portal

1. Vai a Maker Portal (https://make.powerapps.com) e seleziona l'ambiente che hai utilizzato in Copilot Studio per creare azioni.

2. Nel riquadro di spostamento seleziona Soluzioni per visualizzare l'elenco delle soluzioni nell'ambiente.

3. Individua la soluzione utilizzata per creare l'azione e selezionala.

   Viene visualizzato un elenco di oggetti associati alla soluzione.

4. Trova l'azione di connettore che desideri eliminare. L'azione è di tipo AIPlugin.

   Suggerimento

   Se non vedi la tua azione nella soluzione, cambia lo stato dell'azione da bozza a pronto pubblicando l'azione.

5. Prima di eliminare l'azione, devi eliminare la dipendenza nella tabella AICopilot_AIPlugin. Per prima cosa, seleziona Avanzate>Mostra dipendenze.

   

   Vengono visualizzate le dipendenze per l'azione di connettore.

6. Per la voce AICopilot_AIPlugin nell'elenco delle dipendenze, seleziona Elimina.

   

7. Torna all'elenco degli oggetti ed elimina l'azione selezionando Rimuovi>Elimina da questo ambiente.

   

8. Eliminare tutte le operazioni di tipo AIPluginOperation nella tabella selezionando Rimuovi>Elimina da questo ambiente.

   

9. Torna a Copilot Studio per verificare che l'azione sia stata rimossa dalla vista Azioni per il Copilot.