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 Criar um agente.

  • Selecione Introdução.

    Imagem do agente de criação no Security Copilot

  • A página Descrição geral é apresentada.

  • Na barra de navegação superior, existem dois separadores: Compilar e Testar. Crie o agente e configure as ferramentas do agente no separador Compilar.

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

  • Na página Descrição geral do agente , pode configurar os detalhes, ferramentas, acionadores e permissões do agente. Estas secções de configuração estão acessíveis a partir do painel de navegação esquerdo em Descrição geral do 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, a Copilot faz perguntas para o orientar e utiliza as suas respostas para preencher os detalhes, como o nome, descrição, instruções e ferramentas que definem o seu agente.

Passos para criar o agente personalizado

Utilize a página Descrição Geral para especificar a finalidade e o âmbito do agente, ferramentas para executar tarefas, acionadores e permissões.

Definir detalhes do agente

  • Introduza um Nome descritivo para o agente.

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

  • Pode adicionar um ícone personalizado para o seu agente. Os formatos aceites são:.svg, .jpg, .png.

  • Descreva o agente na Descrição e o objetivo final que tem de cumprir.

  • O Publisher é a organização que desenvolve e mantém o agente de segurança.

  • Especifique o (s) Produto(s) para o qual o agente está no âmbito.

Observação

O nome 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.

Configurar ferramentas de agente

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.

Adicione uma ferramenta existente a partir do extenso catálogo de ferramentas de Security Copilot ou crie uma nova ferramenta que permita 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 ferramentas

Pode adicionar ferramentas explicitamente ao seu agente.

  • Selecione Adicionar ferramentas 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 específicas para realizar uma tarefa específica. Após a seleção, a ferramenta é apresentada no campo Ferramentas selecionadas . Pode aplicar filtros para melhorar a deteção da pesquisa.

  • Selecione Adicionar selecionado para adicionar as ferramentas ao agente.

    • Selecione Mostrar Detalhes para ver as informações detalhadas na ferramenta.

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

  • A ferramenta selecionada é adicionada à secção Ferramentas. Também é apresentado no painel de navegação esquerdo.

  • Selecione Remover para eliminar uma 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.

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, AGENT, API e MCP, veja Como criar ferramentas.

Configurar Acionadores

Os acionadores ativam o agente para ser executado com base numa agenda. Utiliza a ferramenta Fetch para recolher dados antes de invocar a ferramenta Processo para analisar os dados.

Selecione Adicionar Acionador para configurar uma agenda para o agente. Pode configurar vários acionadores.

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

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

  • Ferramenta de obtenção (opcional): forneça os detalhes da ferramenta para obter dados para o agente.

  • Ferramenta de processo: processa os dados obtidos pela ferramenta Fetch.

A ferramenta de obtenção e a ferramenta Processo funcionam como pontos de entrada para o fluxo de trabalho do agente. Pode adicionar os seguintes tipos de ferramentas:

  • Uma ferramenta recentemente criada (AGENT, API, KQL, GPT, MCP) a partir das Ferramentas do Agente.

  • Ferramentas globais criadas no Security Copilot.

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

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

Gerenciar 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. Isto é adicionado 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. Pode efetuar edições ao YAML para aplicar alterações dinâmicas à vista de formulário.

  • 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 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.

Observação

Pode criar uma ferramenta de Security Copilot ou um agente por qualquer ordem. O processo de desenvolvimento permite flexibilidade para se ajustar ao seu fluxo de trabalho.

Próximas etapas

Confira também

  • Last updated on