Início rápido: Configurar e executar o agente de exemplo JavaScript LangChain

Neste Quickstart, explique como configurar um agente JavaScript LangChain funcional usando ferramentas Agent 365, notificações, observabilidade e testar o agente usando o Agents Playground e Teams.

Pré-requisitos

Se planeias usar Visual Studio Code, tens de ter o .NET instalado. É recomendado o TLS 1.2.
Node.js versão 20 ou superior
LangChain
Parque infantil dos agentes
O acesso ao Npm (Gestor de Pacotes de Node) é instalado com o NodeJS
Acesso ao GitHub
Um projeto existente de agente de IA. Este quick start utiliza um agente de exemplo Agent 365 do Microsoft 365 agent toolkit , também conhecido como ATK no VS Code.
A365 CLI
Autenticação da Identidade do Agente

Configurar o exemplo LangChain + Node.js a partir do Microsoft 365 Agents Toolkit

Para preparar tudo, instalas o Microsoft 365 Agents Toolkit no VS Code, abres a galeria de exemplos e instalas localmente o LangChain + Node.js exemplo para poderes configurá-lo e executá-lo mais tarde. As capturas de ecrã seguintes mostram o que deve esperar ver à medida que avança.

Abre o Visual Studio Code, depois abre o painel de Extensões Ctrl+Shift+X.
Na barra de pesquisa, escreva "Agents Toolkit".
Deves ver o resultado mostrado na captura de ecrã aqui:
Selecione o Microsoft 365 Agents Toolkit.
Selecione Instalar.

O VS Code mostra a visualização de detalhes da extensão de forma semelhante a:
Uma vez instalado, o ícone M365 Agents Toolkit aparece na barra de navegação esquerda.
Seleciona-o para abrir a experiência de boas-vindas.

Agora deverá ver opções como Construir um Agente Declarativo, Criar um Novo Agente/Aplicação e Ver Exemplos, como mostrado aqui:
Selecionar Ver Amostras.
Na lista de exemplos, desloce-se para encontrar o exemplo do agente LangChain + Node.js .
Selecione-a.

Verás duas opções: Criar (andaime localmente) ou Visualizar no GitHub.
Escolha Criar.
Quando solicitado, selecione uma pasta na sua máquina onde a amostra deve ser gerada. Por exemplo: C:\A365-Ignite-Demo

O kit de ferramentas estrutura a amostra LangChain + Node.js numa subpasta (como sample_agent) e depois abre-a automaticamente no VS Code.

Quando a estrutura estiver concluída, terá agora um projeto LangChain + agente Node.js totalmente funcional na sua máquina

Instalação necessária dos pacotes Agent 365

Antes de executar o exemplo, abra o package.json no seu projeto e confirme que todas as dependências necessárias do Agent 365 e do framework Agent estão listadas. O exemplo gerado pelo Microsoft 365 Agents Toolkit já inclui estas entradas.

Depois de rever o package.json, instale tudo correndo:

npm install

Isto retira todas as bibliotecas do Agent 365, dependências do framework do Agent, componentes de alojamento e quaisquer outras dependências definidas no exemplo. Após a instalação, verifica se o projeto se constrói e corre iniciando o dev server

npm run dev

Adicionar ferramentas Microsoft 365 (servidores MCP)

Pode explorar e gerir servidores MCP usando os comandos de desenvolvimento a365 na linha de código.

Ao trabalhar com servidores MCP, pode:

Descubra quais os servidores MCP disponíveis para utilização
Adicione um ou mais servidores MCP à configuração do seu agente
Revise os servidores MCP atualmente configurados
Remova os servidores MCP de que já não precisa

Depois de adicionados servidores MCP, o manifesto de ferramentas do seu agente expande-se para incluir entradas semelhantes a:

{
   "mcpServers": [
      {
         "mcpServerName": "mcp_MailTools",
         "mcpServerUniqueName": "mcp_MailTools",
         "scope": "McpServers.Mail.All",
         "audience": "api://00001111-aaaa-2222-bbbb-3333cccc4444"
      }
   ]
}

Aprenda a adicionar e gerir ferramentas

Subscrição e gestão de notificações

O agente de exemplo subscreve todas as notificações do Agente 365 usando onAgentNotification("*") e encaminha-as para um único handler. Este handler permite ao agente reagir a eventos em segundo plano ou do sistema, não apenas a mensagens diretas do utilizador.

Aprenda como notificar os agentes

O código seguinte mostra como a notificação está configurada no agent.ts ficheiro.

constructor() {
   super();

   this.onAgentNotification("agents:*", async(context, state, activity) => {

      await this.handleAgentNotificationActivity(context, state, activity);

   });
}

async handleAgentNotificationActivity(context, state, activity)
{
   await context.sendActivity("Received an AgentNotification!");

   // Add custom handling here
}

Observabilidade

Este excerto mostra as alterações mínimas necessárias para permitir a observabilidade na amostra. Inicializa o SDK de Observabilidade do Agente 365 e envolve cada invocação do agente de modo InferenceScope a capturar automaticamente entradas, saídas e metadados.

O código seguinte mostra um exemplo de observabilidade simplificada no client.ts ficheiro.

const sdk = ObservabilityManager.configure(b =>
   b.withService('<service-name>', '<version>')
);

sdk.start();

async invokeAgentWithScope(prompt: string) {

   const scope = InferenceScope.start(
      { 
         operationName: InferenceOperationType.CHAT, 
         model: '<llm-name>' 
      },
      { 
         agentId: '<agent-id>', 
         agentName: '<agent-name>', 
         conversationId: '<conv-id>' 
      },
      { tenantId: '<tenant-id>' }
   );

   const response = await this.invokeAgent(prompt);
   scope?.recordInputMessages([prompt]);
   scope?.recordOutputMessages([response]);
   scope?.recordResponseId(`resp-${Date.now()}`);
   return response;

}

Este excerto mostra o padrão central para permitir a observabilidade na amostra Node.js + LangChain. Para a configuração completa da observabilidade, veja Saiba mais sobre observabilidade

Teste o seu agente.

Defina as variáveis de ambiente necessárias, selecione um modo de autenticação e inicie o agente localmente. Podes testar tudo de ponta a ponta com o Agents Playground sem precisares de um tenant Microsoft 365, a menos que queiras publicar o agente e usá-lo em aplicações como o Teams ou o Outlook. Por favor, consulte para os passos detalhados em Saiba mais sobre testes para configurar o teste do agente com o Agents Playground.

Visão geral dos passos de teste

Adicione as suas chaves de API e definições de modelo a um .env ficheiro para que o exemplo possa comunicar com um LLM.
Escolhe o teu modo de autenticação. Para desenvolvimento local, a amostra suporta a Autenticação Agential usando valores criados a partir do seu Agente Blueprint.
Inicia o agente localmente, o que o expõe a ferramentas como o Agents Playground.
Usa o Agents Playground para testar mensagens, ferramentas e notificações sem configurar um tenant ou implementar nada.
Quando estiver pronto para comportamentos reais, publique um tenant Microsoft 365 e teste o agente dentro do Teams, Outlook ou outras superfícies Microsoft 365.

Publicar o seu agente

Quando o seu agente estiver pronto para experiências reais do Microsoft 365, como chats no Teams, mensagens do Outlook, Word @mentions, publica tudo num tenant do Microsoft 365. O comando Agent 365 CLI publish trata da embalagem: atualiza o seu manifesto, agrupa tudo e carrega o agente no Microsoft Admin Center.

Durante a publicação, revise e personalize o nome, descrição, ícones e versão do agente antes de concluir o carregamento. Uma vez publicado, o seu agente torna-se detectável e instalável dentro do inquilino.

Pode ver os agentes publicados aqui: https://admin.cloud.microsoft/#/agents/all

Saiba mais sobre o fluxo de trabalho completo e as instruções passo a passo

Feedback

Esta página foi útil?

Last updated on 2025-12-02