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.

• Você precisa de um modelo do Azure do portal do Azure AI Foundry. Você precisa destes dados sobre o modelo:

  • Nome
  • URI de destino
  • Key

  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.

Você pode criar um novo projeto de agente selecionando Criar um novo agente/aplicativo no Microsoft 365 Agents Toolkit. 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.

Para começar com a criação de um agente com o SDK de agentes, selecione Agente de mecanismo personalizado no primeiro menu:

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.

1. Você tem dois modelos para selecionar: Basic Custom Engine Agent ou Weather Agent. O agente de motor personalizado básico é um agente sem nada pré-criado. Você precisa adicionar um orquestrador de IA, como Semantic Kernel ou LangChain, e seu conhecimento.

   

2. Neste exemplo, selecione Weather Agent para criar um agente que use LangChain e Azure AI Foundry, dependendo do idioma escolhido.

3. Selecione Azure OpenAI para o seu modelo.

   

   Você será solicitado a fornecer sua chave, o URI de destino e o Nome do seu modelo do Azure no portal do Azure AI Foundry. Você pode encontrar essas informações em Meus ativos e modelos e pontos finais no portal da Fundição.

4. Insira os detalhes, começando com a chave:

   

5. 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.

   

6. 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 você seguiu o guia e usou o modelo pré-criado com LangChain e Azure AI Foundry, você pode perguntar "Qual é o tempo em {sua localização} amanhã?" O agente responde com um cartão adaptável 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 ou Depurar para testar. Leva alguns minutos de preparação para disponibilizar o agente para o Microsoft 365. Em segundo plano, o kit de ferramentas cria um registo do Registo de Aplicações e do Serviço de Bot no Azure Bot Service e implementa o seu projeto no seu inquilino juntamente com um manifesto.

   

2. Depois de fazer isso, você verá o carregamento do Microsoft 365 Copilot 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