Configurare e gestire le connessioni

Gli agenti usano strumenti e conoscenze per eseguire azioni per conto degli utenti e raccogliere informazioni contestuali pertinenti. Gli sviluppatori spesso archiviano questi strumenti e origini conoscenze in sistemi esterni, ad esempio Microsoft Dataverse, Microsoft SharePoint o altre API. Per accedere a queste risorse in modo sicuro, gli agenti devono autenticarsi per stabilire connessioni tra loro e il sistema esterno. L'agente può utilizzare l'autenticazione dell'autore oppure l'autenticazione dell'utente, a seconda dello scenario.

In Microsoft Copilot Studio si usano le connessioni 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 di connessione.

Nella pagina Impostazioni di connessione , puoi configurare e gestire le connessioni che il tuo agente utilizza. È possibile visualizzare le connessioni esistenti, crearne di nuove e modificarle o disconnetterle in base alle esigenze.

Visualizzare le connessioni nella pagina Impostazioni connessione

1. Vai alla pagina del tuo agente in Copilot Studio selezionando Agenti e poi selezionando l'agente che vuoi vedere.

   La pagina panoramica dell'agente si apre.

2. Selezionare Impostazioni per aprire la pagina Impostazioni agente.

3. Seleziona Impostazioni di Connessione.

Vedi una lista in una tabella con tutte le connessioni associate al tuo agente. Per ogni connessione, puoi vedere:

• Nome della connessione
• Strumenti e fonti di conoscenza che utilizzano la connessione
• Stato della connessione

Definizioni di stato della connessione

Lo stato della connessione indica lo stato attuale della connessione. Esistono diversi possibili status:

• Connesso: La connessione è attiva e l'agente può usarla per accedere allo strumento o alle conoscenze associate.
• Non connesso: Non c'è connessione attiva. L'agente non può accedere allo strumento o alle conoscenze associate. Devi stabilire un legame.
• Disattivato: La connessione è disattivata, forse da un amministratore, e l'agente non la sta usando al momento.
• Scaduta: Le credenziali di autenticazione della connessione sono scadute e non più valide. Devi riautenticare la connessione affinché l'agente possa accedere allo strumento o alle conoscenze associate.
• Scaduto: La connessione non è più valida o utilizzabile, di solito perché è stata interrotta o a causa di un timeout. Devi rivedere e aggiornare o sostituire la connessione affinché l'agente possa accedere allo strumento o alla conoscenza associata.

Filtrare le connessioni

Se hai diversi contatti con il tuo agente, filtra la lista per trovare il contatto con cui vuoi lavorare. Applica filtri diversi per visualizzare le connessioni in base al loro stato, come Attivato, Disattivato, Connesso, Non Connesso, Scaduto o Obsoleto.

Seleziona o crea una connessione individuale

1. Sotto Stato per la voce della connessione nella lista, seleziona il collegamento ipertestuale accanto allo stato per aprire il pannello Crea o scegli un pannello di connessione.

2. Seleziona ... per aprire la configurazione di Connessione .

3. Seleziona una connessione esistente dalla lista oppure seleziona Crea nuova connessione per crearne una nuova.

   Se si seleziona Crea nuova connessione, verrà aperto un riquadro di configurazione della connessione. Se necessario, potresti essere invitato ad accedere al servizio o fornire ulteriori informazioni per completare la configurazione della connessione.

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

   Hai configurato la connessione e l'hai associata al tuo agente. Il tuo agente può usare la connessione per accedere agli strumenti e alle conoscenze.

Visualizza i dettagli e configura 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 il single sign-on (SSO), puoi impostare la connessione per usare l'autenticazione On-Behalf-Of (OBO). In un flusso OBO, l'utente delega all'agente l'uso dei parametri di connessione dell'utente con il servizio per conto dell'utente. Questo metodo di autenticazione è utile quando l'agente deve accedere a risorse che richiedono permessi specifici per l'utente o quando è necessario eseguire azioni nel contesto dell'identità dell'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. Seleziona le caselle di controllo per i parametri che desideri 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.

Richieste di connessione ripetute quando si usa OAuth 2.0 con gli strumenti di API Graph Microsoft

Quando si utilizza l'autenticazione OAuth 2.0 , ogni utente deve accedere e concedere il consenso. Quando condividi o ospiti l'agente, gli altri utenti non hanno ancora dato il consenso, quindi vedono la carta Connect .

Per evitare richieste ripetute, prova una delle seguenti opzioni di autenticazione:

• Abilita l'autenticazione unica (SSO) di Teams con il flusso 'on-behalf-of' (OBO): Gli utenti eseguono l'accesso una sola volta in Teams. Non è richiesto alcun consenso aggiuntivo in chat.

• Usa i permessi dell'applicazione (principale del servizio): il backend chiama Microsoft Graph utilizzando le credenziali dell'app. Non è richiesto il consenso dell'utente.

• Usa SSO generico OAuth per gli agenti ospitati sul web: la tua app gestisce l'accesso e passa il token all'agente.

• Concedere il consenso dell'amministratore per ambiti delegati: Rimuove i prompt di permesso per utente. È comunque necessario un iniziale accesso.

Contenuti correlati

• Configurare l'autenticazione OBO per i connettori personalizzati