Configurare e gestire le connessioni

Gli agenti usano strumenti e conoscenze per eseguire azioni per conto degli utenti e raccogliere informazioni contestuali pertinenti. Questi strumenti e origini conoscenze vengono spesso archiviati in sistemi esterni, ad esempio Microsoft Dataverse, Microsoft SharePoint o altre API. Per accedere in modo sicuro a queste risorse, gli agenti devono eseguire l'autenticazione per stabilire connessioni. L'agente può usare l'autenticazione dell'agente o l'autenticazione dell'utente, a seconda dello scenario.

In Microsoft Copilot Studio le connessioni vengono usate per accedere in modo sicuro ai servizi autenticati per strumenti e conoscenze. È possibile creare connessioni a varie origini dati, ad esempio Microsoft Dataverse, Microsoft SharePoint o API esterne.

Visualizzare e gestire le connessioni degli agenti

In Copilot Studio è possibile visualizzare e configurare le connessioni usate dall'agente nella pagina Impostazioni connessione .

Nella pagina Impostazioni di connessione è possibile configurare e gestire le connessioni usate dall'agente. È possibile visualizzare le connessioni esistenti, crearne di nuove e modificarle o disconnetterle in base alle esigenze.

Visualizzare le connessioni nella pagina Impostazioni connessione

1. Passare alla pagina dell'agente in Copilot Studio selezionando Agenti e quindi selezionando l'agente da esaminare.

   Verrà visualizzata la pagina di panoramica dell'agente.

2. Selezionare Impostazioni per aprire la pagina Impostazioni agente.

3. Nel riquadro di spostamento sinistro selezionare Impostazioni di connessione.

Un elenco viene visualizzato in una tabella con tutte le connessioni associate all'agente. Per ogni connessione, è possibile visualizzarne il nome, gli strumenti e le conoscenze usando la connessione, lo stato della connessione e la data dell'ultimo aggiornamento della connessione.

Filtrare le connessioni

Se si dispone di molte connessioni nell'agente, è possibile filtrare per ottenere una visualizzazione più stretta e trovare la connessione che si vuole gestire. È possibile applicare filtri diversi per visualizzare le connessioni in base al relativo stato, ad esempio Attivato/disattivato, Connesso/non connesso, Disattivato, Scaduto o Errore di connessione.

Selezionare o creare una connessione

1. In Stato per la voce di connessione nell'elenco selezionare Gestisci per aprire il riquadro Crea o selezionare una connessione .

2. Aprire la configurazione connessione . Selezionare una connessione esistente dall'elenco o selezionare Crea nuova connessione per crearne una nuova.

   Se si seleziona Crea nuova connessione, verrà aperto un riquadro di configurazione della connessione. Se necessario, potrebbe essere richiesto di accedere al servizio o fornire informazioni aggiuntive per completare la configurazione della connessione.

3. Al termine, seleziona Invia per salvare le modifiche.

   La connessione è ora associata all'agente e l'agente può usare la connessione per accedere agli strumenti e alle conoscenze.

Configurare i parametri di connessione

In Gestisci per la voce di connessione nell'elenco selezionare Visualizza dettagli per visualizzare altri dettagli sulla connessione.

Le informazioni vengono visualizzate in due schede:

• Dettagli: visualizza il nome della connessione, la descrizione, lo stato e i dettagli di creazione.
• Parametri di connessione: visualizza i parametri di connessione, ad esempio dettagli di autenticazione, chiavi API o altre informazioni necessarie e consente di configurare i dettagli.

Condividere i parametri di connessione per l'autenticazione On-Behalf-Of (OBO)

Per alcune connessioni che supportano Single Sign-On (SSO), è possibile impostare la connessione per l'uso dell'autenticazione on-Behalf-Of (OBO). In un flusso OBO, l'utente delega all'agente di usare i parametri di connessione condivisa con il servizio per conto dell'utente. Ciò è utile quando l'agente deve accedere alle risorse che richiedono autorizzazioni specifiche dell'utente o quando è necessario eseguire azioni nel contesto dell'identità di un utente.

Abilitare la condivisione dei parametri per OBO

In Parametri di connessione per la voce di connessione nell'elenco è possibile consentire all'utente di autorizzare la condivisione di parametri di connessione specifici.

1. In Parametri di connessione attivare Consenti autorizzazione per condividere i parametri.

   

2. Selezionare le caselle di controllo per i parametri che si desidera consentire all'utente di condividere.

   All'utente viene richiesto di concedere l'autorizzazione per questi parametri quando l'agente usa l'autenticazione OBO.

Esperienza utente per l'autenticazione OBO

Quando l'agente usa l'autenticazione OBO, all'utente viene richiesto di concedere all'agente l'autorizzazione per l'uso dei parametri di connessione. L'utente può scegliere di consentire o negare questa autorizzazione. Se l'utente lo consente, l'agente può accedere alle risorse ed eseguire azioni per conto dell'utente. L'agente si connette al servizio in modo trasparente usando i parametri di connessione condivisa.