Compartilhar via

Criar um agente do zero com o construtor de agentes

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.

Pode criar agentes personalizados de forma rápida e intuitiva com a nova experiência baseada em formulários. Este artigo explica como começar a criar o agente personalizado do zero com o construtor de agentes no Security Copilot.

Começar a criar o seu agente personalizado

A partir da página Compilar , crie o seu agente personalizado do zero da seguinte forma:

  • Selecione o card Iniciar do zero.

  • Selecione Introdução.

    Imagem do agente de criação no Security Copilot

  • É apresentada a página de destino do Agente .

  • Na barra de navegação superior, existem dois separadores: Compilar e Testar. Utilize o separador Compilar para definir o agente e configurar as respetivas ferramentas. O separador Teste permite-lhe validar as respostas do agente.

    Imagem da descrição geral do agente e da interface de chat no Security Copilot

  • O painel de navegação Descrição geral do agente apresenta as secções de configuração do agente no formulário do construtor de agentes. Pode configurar os Detalhes, Instruções, Entradas, Ferramentas e Automatização do agente para definir Acionadores e Permissões conforme aplicável. Estas secções estão organizadas sob o nome do agente e são utilizadas para criar e refinar incrementalmente o agente.

  • Selecione o botão Copilot para abrir a interface de Chat, que é apresentada no lado direito do ecrã. Pode alternar entre a interface de Chat e o formulário do construtor de agentes, para definir iterativamente o seu agente e adicionar ferramentas. Na interface de Chat, o Copilot faz perguntas para o orientar e utiliza as suas respostas para preencher os detalhes que definem o seu agente.

Criar o agente personalizado

Utilize a página Agente para começar a criar o seu agente personalizado. Pode definir a finalidade e o âmbito do agente e as ferramentas para executar tarefas. Pode configurar as secções seguintes na página do agente:

Detalhes do agente

Defina a identidade e o objetivo do agente, forneça instruções claras e configure quaisquer parâmetros de entrada de que o agente necessite para executar ferramentas de forma eficaz. Para obter mais informações, veja YAML do Agente.

  • Na secção Detalhes do agente :

    • Introduza Nome a apresentar do agente e Descrição do agente.
      • Descreva o agente na descrição e o objetivo final que tem de cumprir.

    Imagem da secção de descrição geral dos detalhes do agente no Security Copilot

  • Na secção Instruções :

    • Pode fornecer instruções claras para orientar o agente sobre o objetivo e como o agente deve executar tarefas. Normalmente escrito em linguagem natural e inclui formatação como markdown ou comentários. Por exemplo, forneça uma lista ordenada de ações para o agente, incluindo instruções sobre como invocar as ferramentas que criou com os tipos de ferramentas.

  • Na secção Entradas :

    • Indique os parâmetros de entrada necessários para a ferramenta de agente. Tem de orientar o modelo de IA na descrição, se apenas alguns valores forem possíveis (por exemplo, "SeverityLevel deve ser um de high, mediumou low").
    • Pode referenciar nomes de entrada no campo Instruções ao encapsula-los em chavetas duplas. Por exemplo, {{skillInputName}}.
    • Selecione Adicionar entrada para fornecer entradas adicionais às suas ferramentas.

Observação

O nome a apresentar do Agente tem de ser um identificador válido, uma vez que é utilizado para identificar exclusivamente o agente. Depois de o agente ser implementado no Security Copilot, pode utilizar o nome para procurar.

Ferramentas

As ferramentas representam uma capacidade específica que o agente pode utilizar para realizar as respetivas tarefas. Normalmente, uma ferramenta é um componente modular, uma função ou mesmo outro agente especializado concebido para executar uma tarefa predefinida. Muitas vezes, estas tarefas envolvem permitir que os agentes interajam com sistemas ou dados externos.

Selecione Adicionar ferramenta no extenso catálogo de ferramentas de Security Copilot ou selecione Criar ferramenta que permite ao agente realizar tarefas específicas e interagir com sistemas externos.

Imagem da secção de ferramentas do agente na descrição geral no Security Copilot

Adicionar ferramenta

Pode adicionar ferramentas explicitamente ao seu agente.

  • Selecione Adicionar ferramenta para abrir o modal do catálogo Ferramentas.

  • No modal Adicionar uma ferramenta, pode selecionar várias ferramentas do catálogo: ferramentas da Microsoft e as ferramentas predefinidas que criar, como AGENTE, GPT, KQL, API e MCP.

  • Pesquisa: pode procurar a ferramenta na Barra de pesquisa (pesquisa semântica). O agente utiliza estas competências ou ferramentas para realizar uma tarefa específica. Pode aplicar filtros para melhorar a deteção da pesquisa. Por exemplo, para adicionar a coleção de ferramentas MCP de Microsoft Sentinel, pesquise pelo palavra-chave ou filtre pelo Publisher: MCP.Sentinel.

    Imagem das ferramentas Sentinel MCP no Security Copilot

  • Selecione Adicionar selecionado para adicionar as ferramentas ao agente.

    Imagem da seleção de ferramentas no catálogo de ferramentas no Security Copilot

  • A ferramenta selecionada é adicionada à secção Ferramentas e apresentada no painel de navegação esquerdo.

    • Selecione a ferramenta para ver as informações detalhadas e os parâmetros de entrada necessários para a ferramenta.

Observação

A pesquisa semântica melhora a obtenção de informações ao interpretar o contexto e a intenção subjacentes à consulta. Utiliza técnicas avançadas, como o Processamento de Linguagem Natural (NLP) para fornecer resultados mais relevantes e significativos.

Eliminar ferramenta

Pode utilizar qualquer uma das seguintes opções para eliminar as ferramentas adicionadas:

  • Selecione as reticências (...) nas ferramentas para Remover uma ferramenta.

  • Selecione Eliminar no painel de navegação esquerdo.

    Imagem da opção para eliminar uma ferramenta no Security Copilot

Criar ferramenta

Pode expandir as capacidades do seu agente personalizado ao adicionar uma ou mais ferramentas.

Para criar uma ferramenta a partir de tipos de ferramentas como GPT, KQL, API e MCP, veja Como criar ferramentas.

Automação

Pode configurar Acionadores e Permissões na secção Automatização .

Acionadores

Os acionadores ativam o agente para ser executado com base numa agenda.

Imagem da secção de acionador do agente no Security Copilot

  • Indique um Nome do acionador e Frequência sobre a frequência com que o acionador é executado.

  • Ferramenta de processo: ferramenta (competência) que é invocada com base no acionador.

A ferramenta Processo funciona como um ponto de entrada para o fluxo de trabalho do agente. Pode adicionar os seguintes tipos de ferramentas:

  • Uma ferramenta recentemente criada (API, KQL, GPT, MCP) a partir das Ferramentas do Agente. Para criar o plug-in MCP, veja Criar plug-in MCP.

  • Ferramentas globais criadas no Security Copilot, incluindo ferramentas MCP.

  • Ferramentas personalizadas criadas para a sua organização.

O agente utiliza estas ferramentas específicas para realizar uma tarefa específica.

Permissões

Pode definir se o agente tem permissão para ser executado em simultâneo e ver que plug-ins são necessários para que seja executado.

  • Selecione a restrição inquilino único pretendida para o agente na lista pendente.

    • Inquilino: só pode haver uma instância por inquilino.

    • Área de trabalho: a instância do agente está confinada a um ambiente de colaboração específico no inquilino. As execuções do agente são visíveis apenas para os membros da área de trabalho, a menos que sejam explicitamente partilhadas. Só pode haver uma instância por área de trabalho.

    • Nenhum: sem restrições. Crie o número de instâncias de agente que pretender.

    Para obter mais informações sobre áreas de trabalho, veja Áreas de trabalho.

  • Os plug-ins Necessários apresentam a Microsoft ou outros plug-ins adicionados ao agente. Os plug-ins são adicionados automaticamente com base nas ferramentas selecionadas no agente.

Ver código

  • Pode alternar Ver código para ver o editor de código a apresentar o código do agente gerado automaticamente num formato YAML.

  • Também pode copiar o YAML diretamente ou transferir o YAML para editar no seu editor de código preferido.

    Imagem do código do agente gerado automaticamente como YAML no Security Copilot

Adicionar ferramentas através do chat

  • Pode utilizar a interface de chat para criar também o seu agente e as respetivas ferramentas personalizadas subjacentes. Selecione Aplicar alterações a aceitar.

    Imagem da ferramenta de agente adicionada através do chat como YAML no Security Copilot

  • A ferramenta subordinada é adicionada à secção Ferramentas.

Próximas etapas

Confira também

  • Last updated on