Configurare un connettore gestito

Crea una connessione autenticata a un servizio esterno, come Office 365 Outlook, Microsoft Teams, Google Gmail, Yammer/Viva Engage, Box, Confluence, OneDrive o SharePoint, con controlli di approvazione per strumento e bloccaggio dei parametri. L'agente ottiene l'accesso solo alle operazioni abilitate con le impostazioni di governance configurate.

Prerequisiti

• Un agente nel portale Azure SRE Agent
• Ruolo Autore Agent SRE o Amministratore nell'agente (vedi Ruoli utente)
• Un account sul servizio che vuoi collegare (ad esempio, un account Microsoft 365, un account Google Gmail, un accesso Viva Engage o un abbonamento a Box workspace)

Come i connettori gestiti proteggono le tue credenziali

Quando autentichi un connettore, SRE Agent memorizza il tuo token o chiave in una risorsa di connessione sicura separata dal runtime dell'agente. Durante l'esecuzione, l'agente si autentica usando la propria identità e chiama il servizio tramite quella connessione. L'agente non vede mai le tue credenziali. Se l'ambiente dell'agente viene compromesso, il tuo token non viene esposto. Puoi revocare l'accesso all'agente senza cambiare la tua password.

Il servizio a cui ti connetti mostra comunque l'identità che ha autorizzato la connessione. Le azioni intraprese dall'agente, come inviare un'email o pubblicare un aggiornamento del canale, appaiono a tuo nome.

Passaggio 1: Aprire la procedura guidata del connettore gestito

1. Apri l'agente nel portale SRE di Azure.
2. Nella barra laterale sinistra espandere Generatore.
3. Seleziona Connettori.
4. Selezionare Aggiungi connettore.

Il selezionatore di connettori si apre, mostrando i connettori disponibili organizzati per scheda: Telemetria, Notifica, MCP, Incidenti, Dispiegamento e Altro.

Le schede di collegamento di anteprima mostrano un badge di Anteprima . Usare la casella di ricerca per trovare un connettore in base al nome in tutte le schede.

Passaggio 2: Selezionare un connettore gestito ed eseguire l'autenticazione

Selezionare la scheda connettore per il servizio che si vuole connettere e quindi selezionare Avanti.

Viene visualizzato il passaggio di autenticazione. Ciò che viene visualizzato dipende dal connettore:

Connettori OAuth (maggior parte dei servizi)

Per Office 365 Outlook, Microsoft Teams, Google Gmail, Yammer/Viva Engage, Box, Confluence, OneDrive, SharePoint e servizi simili:

1. Selezionare Accedi (o Accedi a [Servizio]).
2. Verrà visualizzata una finestra popup OAuth. Accedi con il tuo account di quel servizio.
3. Quando il popup si chiude, la scheda di connessione mostra un segno di spunta verde e il nome autenticato.

Connettori multi-autenticazione

Alcuni connettori offrono più metodi di autenticazione come pulsanti radio:

1. Scegli il metodo che preferisci.
2. Completa i campi di accesso, token, app o identità gestita mostrati dal wizard.

Connettori definiti a runtime

Alcuni connettori recuperano i loro metodi di autenticazione e le operazioni dall'API gestita al momento dell'installazione. Segui le scelte mostrate dal mago invece di assumere una lista di autenticazione fissa.

Connettori basati su token e header

1. Inserisci il token, l'intestazione o i valori di connessione che il connettore mostra.
2. Selezionare Connetti.

Dopo aver completato l'autenticazione, selezionare Avanti per continuare.

Passo 3: Configurare gli strumenti

Il passaggio di configurazione degli strumenti mostra ogni strumento disponibile per il connettore in una tabella con nome dello strumento, policy dei parametri e colonne Permessi .

1. Seleziona la casella di spunta per ogni operazione che vuoi che l'agente utilizzi.
2. Usa la casella di selezione nell'intestazione del nome dello strumento per selezionare o cancellare tutte le operazioni attualmente filtrate.
3. Usa la casella di ricerca per filtrare gli strumenti per nome o descrizione.

Il conteggio selezionato (ad esempio, 12 su 47 selezionati) mostra quanti strumenti hai selezionato tra il totale disponibile.

Configura la governance per ogni operazione selezionata nella stessa tabella:

Valori dei parametri di blocco (criteri dei parametri)

1. Attiva l'interruttore della policy Parametri per uno strumento selezionato.
2. Lo strumento si espande per visualizzare tutti i relativi parametri.
3. Digitare un valore in qualsiasi campo di parametro per bloccarlo. L'agente usa questo valore esatto ogni volta.
4. Lasciare vuoto un campo per l'agente per riempirlo in fase di esecuzione in base al contesto.

Per altre informazioni sul funzionamento del blocco dei parametri, vedere Connettori gestiti.

Impostare i requisiti di approvazione (autorizzazione)

Per ogni strumento selezionato, alterna il Permesso tra:

• Consenti: l'agente viene eseguito liberamente (impostazione predefinita). Da usare per le operazioni di lettura.
• Ask: L'agente si interrompe e chiede la tua approvazione prima di ciascuna esecuzione. Usare per operazioni di scrittura che creano, modificano o eliminano risorse.

Seleziona Avanti dopo aver selezionato gli strumenti e configurato la governance.

Passaggio 4: Rivedere e creare

Il passaggio Revisione & Creazione mostra un riassunto:

• Nome del server MCP (auto-generato)
• Connettori e Operazioni
• Funzionamento e conteggio dei parametri

1. Esaminare il riepilogo.
2. Fare clic su Crea.

L'agente SRE crea immediatamente il connettore. Appare nella tua lista dei connettori e il tuo agente può iniziare subito a usare gli strumenti abilitati.

Verificare che il connettore funzioni

Dopo aver creato il connettore:

1. Controllare l'elenco dei connettori. Il nuovo connettore dovrebbe visualizzare lo stato Connesso .
2. Aprire una chat con l'agente e chiedergli di usare una delle operazioni abilitate.

Ad esempio, se hai collegato un servizio di notifiche con un'operazione di invio attivata:

"Invia un riassunto dell'ultimo incidente al canale di chiamata"

Modificare o eliminare un connettore

Edit

Selezionare un connettore gestito esistente per riaprire la procedura guidata. È possibile modificare le operazioni abilitate, aggiornare i valori dei parametri e modificare le impostazioni di approvazione.

Cancella

Per rimuovere un connettore, selezionarlo dall'elenco dei connettori e selezionare Elimina.

Configurare un connettore gestito con l'API REST

È anche possibile creare e gestire connettori gestiti a livello di codice usando l'API REST.

1. Ottenere un token

TOKEN=$(az account get-access-token --resource https://azuresre.dev --query accessToken -o tsv)
ENDPOINT="https://{agentEndpoint}"

2. Elencare i connettori disponibili

curl -s -H "Authorization: ******" \
  "$ENDPOINT/api/v2/connectorV2/managedApis"

3. Ottenere operazioni per un connettore

CONNECTOR_NAME="{connectorName}"
curl -s -H "Authorization: ******" \
  "$ENDPOINT/api/v2/connectorV2/connectors/$CONNECTOR_NAME/operations"

Usa la risposta alle operazioni come fonte di verità per nomi e parametri delle operazioni. I connettori di anteprima possono cambiare ciò che restituiscono.

4. Creare una connessione (i connettori OAuth richiedono l'accesso al portale)

curl -X PUT -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  "$ENDPOINT/api/v2/connectorV2/connections/$CONNECTOR_NAME" \
  -d '{ "properties": {} }'

5. Creare la configurazione del server MCP con la governance

curl -X PUT -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  "$ENDPOINT/api/v2/connectorV2/mcpservers/$CONNECTOR_NAME" \
  -d '{
    "properties": {
      "description": "Managed connector",
      "state": "Enabled",
      "connectors": [{
        "name": "{connectorName}",
        "connectionName": "{connectorName}",
        "displayName": "{Connector display name}",
        "operations": [
          {
            "name": "{ReadOperationName}",
            "displayName": "{Read operation display name}",
            "agentParameters": []
          },
          {
            "name": "{WriteOperationName}",
            "displayName": "{Write operation display name}",
            "requiresApproval": true,
            "userParameters": [
              { "name": "{DestinationParameter}", "value": "{Locked destination}" }
            ],
            "agentParameters": []
          }
        ]
      }]
    }
  }'

In questo esempio, l'operazione di lettura viene eseguita senza approvazione. L'operazione di scrittura richiede l'approvazione (requiresApproval: true) e blocca il parametro di destinazione.

Per l'elenco completo degli endpoint, vedere Informazioni di riferimento sulle API.

Troubleshooting

Contenuti correlati

• Collega un servizio di codice sorgente
• Collega un servizio di notifica
• Collega una sorgente di telemetria
• Connettori gestiti
• Connettori e strumenti MCP