Tutorial: Criar agentes declarativos usando o Microsoft 365 Agents Toolkit e JSON

Um agente declarativo fornece uma experiência de conversação direcionada a objetivos da plataforma Microsoft 365 Copilot. Você define seu propósito, instruções, conhecimento e ações. Este guia fornece informações sobre como criar um agente declarativo usando o Microsoft 365 Agents Toolkit.

O agente criado neste tutorial é direcionado a usuários licenciados do Microsoft 365 Copilot. Você também pode criar agentes para usuários do Microsoft 365 Copilot Chat, com recursos limitados. Para obter detalhes, consulte Licenças de desenvolvedor do Microsoft 365 Copilot.

Observação

Os locatários do Microsoft 365 Government não dão suporte à publicação de agentes por meio do Kit de Ferramentas de Agentes.

Dica

As Ferramentas de Desenvolvimento do Work IQ (versão prévia) e o Kit de Ferramentas de Agentes do Microsoft 365 fornecem fluxos de trabalho de código profissional relacionados. Para escolher com base em sua funcionalidade, rota de pacote e experiência de destino, consulte Escolher ferramentas de desenvolvimento para seu plug-in.

A captura de tela mostra a resposta do agente declarativo no Microsoft 365 Copilot.

Para obter informações gerais, consulte Agentes declarativos do Microsoft 365 Copilot. Para comparar tipos de agente, consulte Comparar agentes de mecanismo declarativo e personalizado.

Observação

Os agentes declarativos baseados no Microsoft 365 Copilot agora têm suporte no Word e no PowerPoint.

Pré-requisitos

Os seguintes recursos são necessários para concluir as etapas descritas neste artigo:

Observação

As capturas de tela e referências de interface do usuário neste artigo usam uma versão de lançamento do Microsoft 365 Agents Toolkit. As versões de pré-lançamento podem ser diferentes da interface do usuário mostrada.

Você deve estar familiarizado com os seguintes padrões e diretrizes para agentes declarativos do Microsoft 365 Copilot:

Criar e provisionar um agente declarativo com o Kit de Ferramentas de Agentes do Microsoft 365

Comece criando um agente declarativo básico.

  1. Abra o Visual Studio Code.

  2. Selecione Microsoft 365 Agents Toolkit > Criar um novo agente/aplicativo.

    Uma captura de tela do botão Criar um novo agente/aplicativo na barra lateral do Kit de ferramentas para agentes

  3. Selecione o Agente Declarativo.

    Uma captura de tela das opções de Novo projeto com Agente selecionado

  4. Selecione Sem Ação para criar um agente declarativo básico.

  5. Selecione a pasta padrão para armazenar a pasta raiz do projeto no local padrão.

  6. Digite My Agent como o Nome do Aplicativo e pressione Enter.

  7. Na nova janela do Visual Studio Code que é aberta, selecione Microsoft 365 Agents Toolkit e, em seguida, selecione Provisionar no painel Ciclo de Vida.

    Uma captura de tela da opção Provisionar no painel Ciclo de Vida do Kit de Ferramentas de Agentes

Testar o agente

  1. Acesse o aplicativo Copilot em https://m365.cloud.microsoft/chat.

  2. Ao lado do botão New Chat, selecione o ícone da gaveta de conversas.

  3. Selecione o agente declarativo Meu Agente.

    Uma captura de tela do agente declarativo no Copilot

  4. Insira uma pergunta para seu agente declarativo e certifique-se de que ele responda com "Obrigado por usar o Microsoft 365 Agents Toolkit para criar seu agente declarativo!"

    Captura de tela de uma resposta do agente declarativo no Microsoft 365 Copilot

Próxima etapa