Coleção de ferramentas de criação do agente 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 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 seu esquema.

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

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

Essa ferramenta encontra ferramentas relevantes, incluindo habilidades, agentes e ferramentas MCP, no Security Copilot que podem ser usadas para atender à intenção.

Parâmetros

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

Iniciar criação do agente (start_agent_creation)

Objetivo

Essa ferramenta cria uma nova sessão do 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 do Compose (compose_agent)

Objetivo

Essa ferramenta itera ao compor o YAML do agente do Security Copilot.

Parâmetros

Nome Obrigatório Descrição
sessionID Sim A ferramenta start_agent_creation cria a ID de sessão Security Copilot. Não deve ser uma ID de sessão criada por search_for_tools.
userQuery Sim Entrada do usuário para o construtor de agentes processar. Podem ser confirmações, esclarecimentos ou informações adicionais.
existingDefinition Não (Opcional) Definição de agente existente YAML para a ferramenta editar. O YAML pode ser gerado a partir de execuções anteriores dessa ferramenta ou fornecido por meio da adição de um arquivo YAML ao contexto.

Obter avaliação (get_evaluation)

Objetivo

Essa ferramenta é chamada após executar as ferramentas search_for_tools, start_agent_creation e compose_agent para recuperar o resultado.

Parâmetros

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

Implantar agente (deploy_agent)

Objetivo

Essa ferramenta carrega o agente no escopo do usuário ou do workspace do Security Copilot.

Parâmetros

Nome Obrigatório Descrição
agentDefinition Sim Definição de agente no formato YAML. O YAML pode ser gerado a partir da ferramenta compose_agent ou fornecido através da adição de um arquivo YAML ao contexto.
scope Sim Escopo para o qual carregar o agente. Ele pode ser somente 'Usuário' ou 'Espaço de trabalho'.
agentSkillsetName Sim Nome do conjunto de habilidades do agente. Ele deve corresponder exatamente ao valor 'Name' em 'Descriptor' na definição de agente YAML.
  • Last updated on