Crie plug-ins de API com uma nova API para o Microsoft 365 Copilot

Importante

Os plug-ins MCP e API fornecem ações em agentes declarativos. Eles não são pacotes de plug-in instaláveis autônomos: somente o agente contendo pode acessar suas funções e ferramentas. Para obter informações sobre o relacionamento de manifesto de ação e pacote, consulte Plug-ins e ações de agente declarativo.

Dica

Recomendado: Comece com o Work IQ Dev Tools para cenários de plug-in e de agente declarativo de código profissional com suporte. Consulte o início rápido do WIQD. As instruções baseadas em kit de ferramentas permanecem disponíveis para projetos e fluxos de trabalho existentes que as exigem. Verifique a capacidade e o suporte à experiência de destino antes de escolher uma ferramenta: O WIQD não tem como alvo agentes de mecanismo personalizados.

Os plug-ins de API permitem que um agente declarativo chame uma API REST. Use o Microsoft 365 Agents Toolkit para gerar um projeto de agente, um manifesto de plug-in de API e uma implementação de API REST como ponto de partida.

Criar o agente e a API

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.

  1. Abra o Visual Studio Code. Se o Agents Toolkit ainda não estiver instalado, consulte Instalar o Agents Toolkit para obter instruções de instalação.

  2. Selecione o ícone do Microsoft 365 Agents Toolkit na Barra de Atividades à esquerda.

  3. Selecione Criar um novo agente/aplicativo no painel de tarefas Kit de ferramentas para agentes.

    Uma captura de tela da interface do Kit de Ferramentas de Agentes

  4. Selecione o Agente Declarativo.

  5. Selecione Adicionar uma Ação e, em seguida, selecione Iniciar com uma Nova API.

  6. Selecione OAuth para o tipo de autenticação.

  7. Selecione sua linguagem de programação preferida: JavaScript ou TypeScript. Este guia pressupõe o TypeScript.

  8. Escolha um local para o projeto de agente.

  9. Insira Repairs Agent um nome para o seu projeto de agente.

Quando você conclui essas etapas, o Agents Toolkit gera os arquivos de projeto de agente e API, incluindo o manifesto do plug-in de API, e abre o projeto em uma nova janela do Visual Studio Code. Para obter detalhes, consulte o arquivo README.md no diretório raiz do projeto gerado.

Executar a API e fazer sideload do agente

  1. Na janela do Visual Studio Code com o projeto do agente carregado, selecione o ícone do Microsoft 365 Agents Toolkit na barra de atividades à esquerda.

  2. No painel Contas , selecione Entrar no Microsoft 365. (Se você já estiver conectado, continue para a próxima etapa).

  3. Confirme se o Upload de aplicativo personalizado habilitado e o Acesso ao Copilot habilitado são exibidos em sua conta do Microsoft 365. Caso contrário, marque com o administrador da sua organização. Consulte Requisitos para opções de extensibilidade do Copilot para obter detalhes.

  4. Selecione o ícone Executar e Depurar na Barra de Atividades à esquerda.

  5. Selecione Depurar no Copilot (Edge) ou Depurar no Copilot (Chrome) e pressione F5 para iniciar a depuração.

O Agents Toolkit cria o projeto, cria um pacote do aplicativo que contém o agente e sua configuração de plug-in de API e faz o sideload do agente para sua conta de usuário. Ele também inicia a API localmente. Uma nova janela do navegador é aberta para o aplicativo Microsoft Teams.

Testar a ação de API do agente

  1. No Microsoft Teams em seu navegador, selecione Copilot.

  2. Selecione Repairs Agentlocal na lista Agents à direita. Se a lista não estiver disponível, selecione o ícone Chats e mais do Copilot no canto superior direito.

  3. Envie uma mensagem ao Copilot sobre reparos. Por exemplo, experimente Which repairs are assigned to Karin?.

Neste ponto, a API REST está sendo executada localmente em seu computador de desenvolvimento sem autenticação. Para adicionar autenticação, implante a API no Azure.

Implantar no Azure e habilitar a autenticação

  1. Selecione o ícone do Microsoft 365 Agents Toolkit na Barra de Atividades à esquerda.

  2. No painel Ciclo de Vida , selecione Provisionar.

  3. Quando solicitado um nome de grupo de recursos, aceite o padrão ou altere-o conforme desejado e pressione Enter.

  4. Selecione um local para o grupo de recursos.

  5. Examine a mensagem na caixa de diálogo. Se tudo estiver correto, selecione Provisionar para continuar.

  6. Aguarde a conclusão das etapas de provisionamento e selecione Implantar no painel Ciclo de Vida .

Ao concluir essas etapas, você implantará a API REST como uma Função do Azure com autenticação. O agente chama essa API hospedada por meio de sua configuração de plug-in de API.

Teste o agente com a API autenticada

  1. No Microsoft Teams em seu navegador, selecione Copilot.

  2. Selecione Repairs Agentdev na lista Agents no lado direito.

  3. Envie uma mensagem ao Copilot sobre reparos. Por exemplo, experimente Which repairs are assigned to Issac?.