Usare uno strumento MCP in Microsoft Copilot Studio (anteprima)

Questo articolo illustra come aggiungere la raccolta mcp (Model Context Protocol) di Microsoft Sentinel di strumenti di sicurezza o i propri strumenti personalizzati agli agenti di intelligenza artificiale in Microsoft Copilot Studio .

Per informazioni su come iniziare a usare gli strumenti MCP, vedere gli articoli seguenti:

• Introduzione a Microsoft Sentinel server MCP
• Creare e usare strumenti MCP Microsoft Sentinel personalizzati

Aggiungere una raccolta di strumenti Microsoft Sentinel

Per aggiungere una raccolta di strumenti Microsoft Sentinel in Copilot Studio, seguire questa procedura:

1. Passare a Copilot Studio e creare un nuovo agente o selezionare un agente esistente.

2. Dopo il provisioning dell'agente, nella pagina Panoramica dell'agente passare a Strumenti e selezionare Aggiungi strumento.

   

3. Nella finestra popup Aggiungi strumento cercare Sentinel e quindi scegliere una delle Sentinel raccolta di strumenti MCP disponibili in base alle proprie esigenze.

   

4. Assicurarsi che il tipo di autenticazione sia impostato su Microsoft Entra ID Integrato, quindi selezionare Crea.

   

5. Selezionare Aggiungi e configura.

   

L'agente è ora connesso alla raccolta di strumenti disponibile di Sentinel. È possibile iniziare a chiedere conferma all'agente e usare gli strumenti per ottenere risultati.

Aggiungere una raccolta di strumenti personalizzata

Gli strumenti MCP personalizzati consentono di creare flussi di lavoro deterministici specificando esattamente il motivo per cui gli agenti dati possono ragionare. Per aggiungere la raccolta di strumenti personalizzata in Copilot Studio, seguire questa procedura:

Passaggio 1: Registrare un'app in portale di Azure

1. Aprire la portale di Azure del tenant, quindi passare a Registrazioni app>Nuova registrazione.

   

2. Nella pagina Registra un'applicazione immettere un nome descrittivo per l'app e quindi selezionare Registra.

   

3. Nella pagina dell'app appena registrata passare a Gestisci>autorizzazioni API e quindi selezionare Aggiungi un'autorizzazione.

   

4. Nel riquadro a comparsa visualizzato passare alla scheda API usate dall'organizzazione e cercare Sentinel Platform Services.

   

5. Scegliere SentinelPlatform.DelegatedAccess, quindi selezionare Aggiungi autorizzazioni.

   

6. Tornare alla pagina dell'app, passare a Gestisci>certificati & segreti e quindi selezionare la scheda Segreti client .

7. Selezionare Nuovo segreto client. Nel riquadro a comparsa visualizzato aggiungere una descrizione e quindi selezionare Aggiungi.

   

   Consiglio

   Creare una singola app per tutti gli strumenti Sentinel personalizzati, ma creare segreti client separati per ogni raccolta personalizzata da aggiungere all'agente.

   Importante

   Dopo aver aggiunto il segreto client, copiare e salvare il relativo valore, che verrà usato nei passaggi successivi.

8. Indietro nella pagina Panoramica del portale di Azure e copiare e salvare i valori seguenti per i passaggi successivi:

   • ID applicazione (client)
   • Directory (tenant) ID

   

Passaggio 2: Aggiungere lo strumento MCP personalizzato a un agente

1. Aprire Copilot Studio e selezionare l'agente in cui si vuole aggiungere lo strumento personalizzato. Nella pagina Panoramica dell'agente passare alla sezione Strumenti e selezionare + Aggiungi strumento.

2. Nella finestra popup visualizzata selezionare + Nuovo strumento.

   

3. Selezionare Model Context Protocol e aggiungere i dettagli della raccolta di strumenti personalizzata. Assicurarsi di aggiungere correttamente le impostazioni OAuth seguenti:

   • Digitare: Manuale
   • ID client: Usare il valore ID applicazione (client) salvato in precedenza
   • Segreto client: Usare il valore del segreto salvato in precedenza
   • URL di autorizzazione: Usare il formato seguente e sostituire <tenant ID> con il valore id directory (tenant) salvato in precedenza:

     https://login.microsoftonline.com/<tenant ID>/oauth2/v2.0/authorize
     

   • Modello di URL token e URL di aggiornamento: usare il formato seguente e sostituire <tenant ID> con il valore id directory (tenant) salvato in precedenza:

     https://login.microsoftonline.com/<tenant ID>/oauth2/v2.0/token
     

   • Ambito: Usare quanto segue:

     4500ebfb-89b6-4b14-a480-7f749797bfcd/.default
     

   

4. Selezionare Crea. Lo strumento viene creato correttamente e viene generato un URL di reindirizzamento. Copiare e salvare questo URL e lasciare aperta la finestra popup per il momento.

   

Passaggio 3: Autenticare Copilot Studio per usare lo strumento personalizzato

1. Indietro al portale di Azure del tenant e nell'app appena aggiunta quindi selezionare Aggiungi un URI di reindirizzamento.

2. Selezionare + Aggiungi una piattaforma>Web.

   

3. Nella casella di testo URI di reindirizzamento aggiungere l'URL di reindirizzamento copiato e quindi selezionare Configura.

4. Indietro alla finestra della finestra popup Copilot Studio e selezionare Avanti.

5. Selezionare Crea nuova connessione. Se lo strumento si connette correttamente, accanto alla connessione viene visualizzato un segno di spunta verde.

   

6. Selezionare Aggiungi e configura.

Contenuto correlato

• Raccolta di strumenti in Microsoft Sentinel server MCP