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 Azure OpenAI no portal do Microsoft Foundry. Você precisa dos seguintes dados sobre o modelo:

  • Nome
  • URI de destino
  • Chave

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

Criar um projeto novo

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.

1. Em Visual Studio Code, abra o painel lateral de extensão do Kit de Ferramentas do Microsoft 365 Agents selecionando o ícone Microsoft 365 Agentes na barra lateral.

2. Para criar um novo projeto de agente, selecione Criar um Novo Agente/Aplicativo. 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.

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

Criar um novo 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 selecionar:

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

O agente do mecanismo personalizado básico é um agente sem nada predefinido. Você precisa adicionar um orquestrador de IA, como Kernel semântico ou LangChain, e seu conhecimento, para que o agente seja útil.

1. Neste exemplo, selecione Weather Agent para criar um agente que usa LangChain e Fábrica de IA do Azure, dependendo do idioma escolhido.

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

1. Selecione o Azure OpenAI para seu modelo.

   

   Você será solicitado a fornecer seu Key, Target URI e o Name de seu modelo openai Azure do portal do Microsoft Foundry. Você pode encontrar essas informações em Meus ativos , modelos e pontos de extremidade no portal do Foundry.

2. Insira os detalhes do modelo, começando com a chave de serviço Azure OpenAI.

   

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

   

4. 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ê seguir o guia e usar o modelo predefinido com LangChain e Fábrica de IA do Azure, poderá 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 no teclado 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 Azure Serviço de Bot registro em Azure Serviço de Bot e implanta seu projeto em seu locatário junto com um manifesto.

   

2. Depois que o projeto for implantado, você deverá ver o Microsoft 365 Copilot se carregar e você poderá fazer perguntas, adicionar pontos de interrupção e 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