Tutorial: Criar agentes declarativos usando o Microsoft 365 Agents Toolkit

Um agente declarativo é uma versão personalizada do Microsoft 365 Copilot que você pode usar para criar experiências personalizadas declarando instruções, ações e conhecimentos específicos. 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 a agentes de publicação por meio do Kit de Ferramentas de Agentes do Microsoft 365.

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 Agentes do Microsoft 365 Copilot.

Observação

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

Pré-requisitos

Antes de começar, verifique se o Microsoft 365 Copilot está disponível para sua organização.

As seguintes opções estão disponíveis para seu ambiente de desenvolvimento:

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

Observação

As capturas de tela e referências à interface do usuário do Microsoft 365 Agents Toolkit neste documento foram geradas usando a versão de lançamento mais recente, 6.0. As versões de pré-lançamento do Agents Toolkit podem ser diferentes da interface do usuário neste documento.

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.

Dica

Work IQ Dev Tools (versão prévia) — Como alternativa às etapas do Visual Studio Code neste tutorial, comece a usar o Work IQ Dev Tools para obter um fluxo de trabalho de linha de comando mais simples e rápido. As etapas a seguir do Kit de Ferramentas para Agentes do Microsoft 365 podem ser mais adequadas para o seu fluxo de trabalho.

  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