Criar agentes JavaScript no Visual Studio Code com o Microsoft 365 Agents Toolkit

Neste artigo, você aprenderá a criar um novo projeto JavaScript do SDK de agentes no Visual Studio, usando o Microsoft 365 Agents Toolkit.

Pré-requisitos

• Instale a extensão do Agents Toolkit para Visual Studio Code.

• Precisa de um modelo Azure OpenAI do portal Microsoft Foundry. Precisa dos seguintes dados sobre o modelo:

  • Nome
  • URI de destino
  • Chave

  Saiba como adicionar e configurar modelos aos Modelos do Azure AI Foundry

Criar um novo projeto

O Agents Toolkit fornece um modelo de projeto para ajudá-lo a começar a criar um agente. Você pode começar a partir de um modelo no kit de ferramentas ou a partir de exemplos no SDK de agentes.

1. No Visual Studio Code, abra o painel lateral da extensão Microsoft 365 Agents Toolkit selecionando o ícone Microsoft 365 Agents na barra lateral.

2. Para construir um novo projeto de agente, selecione Criar um Novo Agente/Aplicação. Você pode começar a partir de um modelo no kit de ferramentas ou a partir de exemplos no SDK de agentes. Este guia começa com o Kit de Ferramentas de Agentes.

1. Para começar a construir um agente com o SDK de Agentes, selecione Agente do Motor Personalizado:

Criar um novo agente

Com o agente de motor personalizado selecionado como uma opção, é guiado por uma série de pedidos para adicionar os seus próprios serviços de IA.

Tem dois modelos para escolher:

• Agente Básico de Motor Personalizado
• Agente do Tempo.

O agente de motor personalizado básico é um agente sem nada pré-criado. Precisas de adicionar um orquestrador de IA, como o Kernel Semântico ou o LangChain, e o teu conhecimento, para que o agente seja útil.

1. Neste exemplo, selecione Weather Agent para criar um agente que use LangChain e Azure AI Foundry, dependendo da linguagem escolhida.

É solicitado que escolha um serviço de LLM.

1. Selecione Azure OpenAI para o seu modelo.

   

   Serão solicitados o seu Key, Target URI e o Name do seu modelo OpenAI Azure do portal Microsoft Foundry. Você pode encontrar essas informações em Meus ativos e modelos e pontos finais no portal da Fundição.

2. Introduza os detalhes do modelo, começando pela chave de serviço Azure OpenAI.

   

3. Selecione JavaScript ou TypeScript, selecione a pasta Padrão e insira um Nome do Aplicativo para armazenar a pasta raiz do projeto no local padrão.

   O seu novo projeto é aberto.

   

4. Confirme que você está conectado usando a extensão selecionando o logotipo do Microsoft 365 na barra de ferramentas no Visual Studio Code. Certifique-se de que tem sessão iniciada no inquilino com o qual se pretende ligar.

   

Depurar e testar o seu agente no "Agents Playground"

Você pode depurar e testar seu código com o novo Microsoft 365 Agent Playground disponível no kit de ferramentas. O playground ajuda você a depurar seu código facilmente e sem ter que passar por um ciclo de implantação completo.

1. Selecione Depurar no Ambiente de Demonstração de Agentes do Microsoft 365.

   Ao selecionar o ambiente de demonstração, aguarde um curto período de tempo enquanto prepara a sua máquina local com os componentes necessários. A preparação leva alguns minutos.

   

2. Enquanto aguarda a implantação, verifique o código na pasta e revise-o para se familiarizar.

   

3. Quando o ambiente de demonstração para depuração e teste estiver totalmente carregado, um browser será aberto e poderá começar a interagir com o seu agente usando o ambiente de demonstração. Se seguir o guia e usar o modelo pré-construído com LangChain e Azure AI Foundry, pode perguntar "Qual é o tempo em {a sua localização} amanhã?" O agente responde com um cartão adaptativo com o tempo, usando o Serviço de IA escolhido.

   

   

Depurar e testar seu agente no Microsoft 365 Copilot

Quando terminar o teste localmente no Agents Playground, você poderá implantar no Serviço de Bot do Azure e configurar para o canal Microsoft 365 Copilot. Verifique se você está conectado a um locatário que tenha acesso ao Microsoft 365 Copilot.

1. Altere o destino de depuração para Copilot, para que você possa depurar usando o Microsoft 365 Copilot. Selecione F5 no teclado ou Debug para testar. Leva alguns minutos de preparação para disponibilizar o agente para o Microsoft 365. Nos bastidores, o toolkit cria um registo de aplicação e um registo de serviço em Azure Bot Service, e disponibiliza o seu projeto para o seu tenant juntamente com um manifesto.

   

2. Depois de implementado o seu projeto, deverá ver o Microsoft 365 Copilot a carregar e poder fazer perguntas, adicionar pontos de interrupção e depurar, conforme necessário, diretamente no Microsoft 365 Copilot:

   

Resumo

Executou agora com êxito:

• Iniciado um novo projeto e agente do Microsoft 365 Agents usando o Agents Toolkit
• Testou o agente localmente usando o Microsoft 365 Agents Playground
• Implantou o agente para despiste de erros diretamente no Canal Microsoft 365