Criar agentes JavaScript no Visual Studio Code com o Kit de Ferramentas de Agentes do Microsoft 365

Neste artigo, você aprende a criar um novo projeto Agents SDK JavaScript no Visual Studio, usando o Microsoft 365 Agents Toolkit.

Pré-requisitos

• Instale a extensão do Kit de Ferramentas dos Agentes para Visual Studio Code.

• Você precisa de um modelo do Azure OpenAI no portal Microsoft Foundry. Você precisa dos seguintes dados sobre o modelo:

  • Nome
  • URI de Destino
  • Chave

  Saiba como adicionar e configurar modelos no Fábrica de IA do Azure Models

Criar um projeto

O Agents Toolkit oferece um modelo de projeto para ajudar você a iniciar a criação de um agente. Você pode começar a partir de um template no Agents Toolkit ou de exemplos no Agents SDK.

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 criar um novo projeto de agente, selecione Create a New Agent/App. Você pode começar a partir de um template no Agents Toolkit ou de exemplos no Agents SDK. Este guia aborda como começar a usar o Agents Toolkit.

1. Para começar a criar um agente com o SDK de Agentes, selecione Custom Engine Agent:

Criar um agente

Com o agente de mecanismo personalizado selecionado como opção, você é guiado por uma série de prompts para adicionar os próprios serviços de IA.

Você tem dois modelos para escolher:

• Agente do Mecanismo Personalizado Básico
• Agente Meteorológico.

O agente do mecanismo personalizado básico é um agente sem nada predefinido. É necessário adicionar um orquestrador de IA, como Kernel semântico ou LangChain, além do seu próprio conhecimento, para que o agente seja útil.

1. Neste exemplo, selecione Agente Meteorológico para criar um agente que use LangChain e Fábrica de IA do Azure, dependendo do idioma escolhido.

Você será solicitado a selecionar um serviço LLM.

1. Selecione Azure OpenAI para seu modelo.

   

   Você será solicitado a fornecer sua chave, URI de destino e o nome do seu modelo Azure OpenAI no portal Microsoft Foundry. Você pode encontrar essas informações em Meus ativos e Modelos e endpoints no portal Foundry.

2. Insira 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 de aplicação para armazenar a pasta raiz do projeto no local padrão.

   O novo projeto é aberto.

   

4. Confirme que você está autenticado usando a extensão, selecionando o logotipo do Microsoft 365 na barra de ferramentas do Visual Studio Code. Certifique-se de estar autenticado no locatário ao qual deseja se conectar.

   

Depurar e testar o agente no Agents Playground

Você pode depurar e testar o 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 precisar passar por um ciclo completo de implantação.

1. Selecione Depurar no Playground de agentes do Microsoft 365.

   Ao selecionar o playground, aguarde enquanto ele prepara o computador local com os componentes necessários. A preparação leva alguns minutos.

   

2. Enquanto espera pela implantação, confira sua pasta para encontrar o código e revise-o para se familiarizar.

   

3. Depois que o playground para depuração e teste terminar de carregar, um navegador será aberto e estará tudo pronto para você interagir com o agente usando o playground. Se você seguir o guia e usar o modelo pronto com LangChain e Fábrica de IA do Azure, pode perguntar: "Como estará o clima em {sua localização} amanhã?" O agente responde com um cartão adaptável com o clima, utilizando o serviço de IA selecionado.

   

   

Depurar e testar o agente no Microsoft 365 Copilot

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

1. Altere o alvo de depuração para Copilot, assim você pode depurar usando o Microsoft 365 Copilot. Pressione F5 no teclado ou clique em Debug para testar. São necessários alguns minutos de preparação para tornar o agente disponível no Microsoft 365. Nos bastidores, o kit de ferramentas cria um registro de aplicativo e um registro do Serviço de Bot do Azure no Serviço de Bot do Azure e implanta seu projeto em seu locatário junto com um manifesto.

   

2. Depois que seu projeto for implantado, você verá o Microsoft 365 Copilot carregar e poderá fazer perguntas, adicionar pontos de interrupção e depurar, conforme necessário, diretamente no Microsoft 365 Copilot:

   

Resumo

Agora você concluiu com êxito:

• Iniciou um novo projeto e agente do Microsoft 365 Agents usando o Agents Toolkit
• Testou o agente localmente usando o Playground de Agentes do Microsoft 365
• Implantou o agente para depuração diretamente no Canal do Microsoft 365