Raccolta di strumenti di creazione dell'agente MCP

Importante

Alcune informazioni in questo articolo fanno riferimento alle caratteristiche di un prodotto prima del rilascio, che possono essere modificate sostanzialmente prima della distribuzione al pubblico. Microsoft non fornisce alcuna garanzia, esplicita o implicita, in relazione alle informazioni contenute in questo documento.

Il protocollo MCP (Model Context Protocol) consente ai server di esporre gli strumenti che possono essere richiamati dai modelli linguistici. Gli strumenti consentono ai modelli di interagire con sistemi esterni o di eseguire calcoli. Ogni strumento è identificato in modo univoco da un nome e include metadati che descrivono il relativo schema.

Questo articolo fornisce informazioni dettagliate sulla raccolta di strumenti di creazione dell'agente MCP per compilare agenti Security Copilot.

Prerequisiti

• Microsoft Sentinel MCP Server
• Visual Studio Code
• estensione GitHub Copilot Visual Studio (VS) Code

Elenco degli strumenti nella raccolta di creazione dell'agente

L'elenco degli strumenti nella raccolta è il seguente:

Cercare gli strumenti (search_for_tools)

Finalità

Questo strumento trova strumenti pertinenti, tra cui competenze, agenti e strumenti MCP, in Security Copilot che possono essere usati per soddisfare la finalità.

Parametri

Nome	Obbligatorio	Descrizione
userQuery	Sì	Istruzione query o problema per cui trovare gli strumenti pertinenti. Ad esempio, i dettagli dell'evento imprevisto di Defender.

Avviare la creazione dell'agente (start_agent_creation)

Finalità

Questo strumento crea una nuova sessione di Security Copilot per iniziare a creare un nuovo agente.

Parametri

Nome	Obbligatorio	Descrizione
userQuery	Sì	Istruzione del problema per l'agente.

agente Compose (compose_agent)

Finalità

Questo strumento esegue l'iterazione sulla composizione dell'agente Security Copilot YAML.

Parametri

Nome	Obbligatorio	Descrizione
sessionID	Sì	Lo strumento start_agent_creation crea l'ID sessione Security Copilot. Questo non deve essere un ID sessione creato da search_for_tools.
userQuery	Sì	Input dell'utente da elaborare per il generatore di agenti. Possono trattarsi di conferme, chiarimenti o informazioni aggiuntive.
existingDefinition	No	(Facoltativo) YAML di definizione dell'agente esistente per lo strumento da modificare. YaML può essere generato da esecuzioni precedenti di questo strumento o fornito tramite l'aggiunta di un file YAML al contesto.

Ottenere la valutazione (get_evaluation)

Finalità

Questo strumento viene chiamato dopo l'esecuzione degli strumenti search_for_tools, start_agent_creation e compose_agent per recuperare il risultato.

Parametri

Nome	Obbligatorio	Descrizione
sessionID	Sì	ID sessione della valutazione
promptID	Sì	ID richiesta di valutazione
evaluationID	Sì	ID valutazione della valutazione

Distribuire l'agente (deploy_agent)

Finalità

Questo strumento carica l'agente nell'ambito dell'utente o dell'area di lavoro Security Copilot.

Parametri

Nome	Obbligatorio	Descrizione
agentDefinition	Sì	Definizione dell'agente in formato YAML. Yaml può essere generato dallo strumento compose_agent o fornito tramite l'aggiunta di un file YAML al contesto.
portata	Sì	Ambito in cui caricare l'agente. Può essere solo "Utente" o "Area di lavoro".
agentSkillsetName	Sì	Nome del set di competenze dell'agente. Deve corrispondere esattamente al valore 'Name' in 'Descriptor' nella definizione dell'agente YAML.