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

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

Pré-requisitos

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

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

  • Nome
  • URI de destino
  • Chave

  Saiba como adicionar e configurar modelos para modelos do Azure AI Foundry

Criar um novo projeto

O Kit de Ferramentas de Agentes 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 Kit de Ferramentas do Microsoft 365 Agents. Você pode começar a partir de um modelo no kit de ferramentas ou a partir de exemplos no SDK de Agentes. Este guia cobre o início com o Kit de Ferramentas dos Agentes.

Para começar a criar um agente com o SDK de Agentes, selecione o Agente do Mecanismo Personalizado no primeiro menu:

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.

1. Você tem dois modelos para selecionar: Agente de Mecanismo Personalizado Básico ou Agente meteorológico. O agente do mecanismo personalizado básico é um agente sem nada predefinido. Você precisa adicionar um orquestrador de IA, como o Kernel Semântico ou o LangChain, além do seu próprio conhecimento.

   

2. Neste exemplo, selecione Agente meteorológico para criar um agente que usa LangChain e Azure AI Foundry, dependendo do idioma escolhido.

3. Selecione o Azure OpenAI para seu modelo.

   

   Você será solicitado a fornecer a chave, o URI de destino e o nome do modelo do Azure no portal do Azure AI Foundry. Você pode encontrar essas informações em Meus ativos , modelos e pontos de extremidade no portal do Foundry.

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

   

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

   O novo projeto é aberto.

   

6. Confirme se você está conectado usando a extensão selecionando o logotipo do Microsoft 365 na barra de ferramentas no Visual Studio Code. Verifique se você está conectado ao locatário ao qual deseja se conectar.

   

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

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 aguarda a implantação, verifique a pasta para o código e revise-o para se familiarizar com ele.

   

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ê seguiu o guia e usou o modelo predefinido com o LangChain e o Azure AI Foundry, você pode perguntar "Qual é o clima em {sua localização} amanhã?" O agente responde com um cartão adaptável com o clima, usando o serviço de IA escolhido.

   

   

Depurar e testar seu agente no Microsoft 365 Copilot

Ao concluir o teste localmente no Agents Playground, você pode implantar no Serviço de Bot do Azure e configurar para o canal do Microsoft 365 Copilot. Verifique se você está conectado a um locatário que tem 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. Nos bastidores, o kit de ferramentas cria um registro de aplicativo e o Serviço de Bot no Serviço de Bot do Azure, além de implantar o projeto no locatário com um manifesto.

   

2. Depois de fazer isso, você deverá ver a carga do Microsoft 365 Copilot e poder fazer perguntas, adicionar pontos de interrupção, além de depurar, conforme necessário, diretamente no Microsoft 365 Copilot:

   

Resumo

Agora você tem êxito:

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