Compartilhar via


Coleção de ferramentas de criação de agentes MCP

Importante

Algumas informações neste artigo estão relacionadas ao produto pré-lançado que pode ser modificado substancialmente antes de ser lançado comercialmente. A Microsoft não faz garantias, expressas ou implícitas, quanto às informações fornecidas aqui.

O PROTOCOLO MCP (Model Context Protocol) permite que os servidores exponham ferramentas que podem ser invocadas por modelos de linguagem. As ferramentas permitem que os modelos interajam com sistemas externos ou executem cálculos. Cada ferramenta é identificada exclusivamente por um nome e inclui metadados que descrevem o respetivo esquema.

Este artigo fornece informações detalhadas sobre a coleção de ferramentas de criação de agentes MCP para criar Security Copilot agentes.

Pré-requisitos

Lista de ferramentas na coleção de criação de agentes

A lista de ferramentas na coleção é a seguinte:

Procurar ferramentas (search_for_tools)

Objetivo

Esta ferramenta encontra ferramentas relevantes, incluindo competências, agentes e ferramentas MCP, em Security Copilot que podem ser utilizadas para satisfazer a intenção.

Parâmetros

Nome Obrigatório Descrição
userQuery Sim A instrução de consulta ou problema para encontrar as ferramentas relevantes. Por exemplo, detalhes do incidente do Defender.

Iniciar a criação do agente (start_agent_creation)

Objetivo

Esta ferramenta cria uma nova sessão de Security Copilot para começar a criar um novo agente.

Parâmetros

Nome Obrigatório Descrição
userQuery Sim A instrução do problema para o agente.

agente Compose (compose_agent)

Objetivo

Esta ferramenta itera a composição do YAML do agente Security Copilot.

Parâmetros

Nome Obrigatório Descrição
sessionID Sim A ferramenta start_agent_creation cria o ID da sessão Security Copilot. Não deve ser um ID de sessão criado pelo search_for_tools.
userQuery Sim Entrada do utilizador para o construtor de agentes processar. Podem ser confirmações, esclarecimentos ou informações adicionais.
existingDefinition Não (Opcional) YAML de definição de agente existente para a ferramenta editar. O YAML pode ser gerado a partir de execuções anteriores desta ferramenta ou fornecido através da adição de um ficheiro YAML ao contexto.

Obter avaliação (get_evaluation)

Objetivo

Esta ferramenta é chamada depois de executar as ferramentas search_for_tools, start_agent_creation e compose_agent para obter o resultado.

Parâmetros

Nome Obrigatório Descrição
sessionID Sim ID de sessão da avaliação
promptID Sim ID de pedido de avaliação
evaluationID Sim ID de avaliação da avaliação

Implementar agente (deploy_agent)

Objetivo

Esta ferramenta carrega o agente para o âmbito Security Copilot utilizador ou área de trabalho.

Parâmetros

Nome Obrigatório Descrição
agentDefinition Sim Definição do agente no formato YAML. O YAML pode ser gerado a partir da ferramenta compose_agent ou fornecido através da adição de um ficheiro YAML ao contexto.
scope Sim Âmbito para onde carregar o agente. Pode ser apenas "Utilizador" ou "Área de Trabalho".
agentSkillsetName Sim Nome do conjunto de competências do agente. Tem de corresponder exatamente ao valor "Nome" em "Descritor" na definição do agente YAML.