Pular para o conteúdo
Voltar para Construa seus primeiros agentes

Construa seus primeiros agentes · Capítulo 1 de 8

As bibliotecas, e o que roda aqui

Quais pacotes do LangChain.js e do LangGraph.js um agente precisa, o que cada um faz e como rodam em um navegador.

15 minutos0 de 3 objetivos concluídos

Objetivos

  • Abra os seis pacotes no mapa e leia o que cada um oferece.A fazer
  • Execute o hello-world nesta página e leia a resposta.A fazer
  • Passe na verificação.A fazer

Passo 1 de 4: A leitura

Os pacotes

LangChain.js e LangGraph.js são bibliotecas JavaScript de código aberto para construir com modelos de linguagem. Elas vêm em pacotes separados, então você instala só o que usa.

@langchain/core reúne as peças comuns: mensagens, a interface de modelo de chat, ferramentas e callbacks. @langchain/langgraph é o runtime para agentes como grafos: estado, nós, arestas, checkpoints e pausas para aprovação. Um pacote de provedor, como @langchain/anthropic ou @langchain/openai, oferece a classe de modelo de chat para a API de um provedor; a mesma classe ChatOpenAI também conversa com serviços compatíveis com OpenAI, como OpenRouter, Hugging Face e NVIDIA. zod descreve e valida a entrada das suas ferramentas; o LangChain transforma um schema zod no JSON Schema que o modelo lê. langsmith é opcional e registra traces de cada execução.

Por que uma biblioteca de grafos

Você pode escrever um loop de agente à mão: chamar o modelo, executar as ferramentas que ele pede, repetir. O capítulo 6 constrói esse loop como um grafo de dois nós. O LangGraph adiciona o que falta a um loop escrito à mão: estado salvo depois de cada passo, para que uma execução possa pausar para uma pessoa e continuar depois; ramos que rodam em paralelo; e uma estrutura que você pode inspecionar e desenhar.

O pacote langchain é construído sobre o LangGraph e oferece createAgent, um agente pronto com middleware. Esta trilha primeiro constrói o grafo à mão, para que depois você saiba o que esses atalhos fazem por você.

Instalar

No seu próprio projeto: npm install @langchain/core @langchain/langgraph @langchain/anthropic zod. Esta trilha usa @langchain/core 1.2.18, @langchain/langgraph 1.5.1 e zod 4.6.7. Fixe versões exatas em projetos reais: essas bibliotecas mudam rápido.

O que muda em um navegador

Tudo nesta trilha roda no seu navegador, então importa o LangGraph de @langchain/langgraph/web. O ponto de entrada principal repassa a configuração para chamadas aninhadas com AsyncLocalStorage, que os navegadores não têm. Com /web, você passa config explicitamente para chamadas aninhadas e pausa execuções com breakpoints (interruptBefore) em vez de interrupt(). O resto da API é igual.

Por padrão o modelo é roteirizado, então você não precisa de chave e toda execução dá o mesmo resultado. Neste capítulo é o FakeListChatModel do próprio LangChain, que devolve as respostas que você lhe dá. A partir do capítulo 2 você pode conectar um modelo real com a sua própria chave.

Passo 2 de 4: Experimente: Os pacotes

Os pacotes

Abra cada pacote no mapa para ver o que ele oferece, a versão usada aqui e como importá-lo. Depois execute o hello-world.

Carregando o visual…

Modo:RealSimuladoReal: as versões no mapa são as instaladas aqui, e o @langchain/core roda o hello-world nesta página. Simulado: o modelo é o FakeListChatModel do LangChain, que devolve uma resposta fixa, então nenhuma IA é chamada e nada sai do seu navegador.

Passo 3 de 4: Verificação

Verificação

Pergunta 1 de 4Qual pacote define HumanMessage, AIMessage e tool()?

Próximo: Pergunta 2 de 4

Pergunta 2 de 4Você roda um grafo LangGraph em um navegador. De onde importa StateGraph?
Pergunta 3 de 4O que o zod faz em um agente LangChain?
Pergunta 4 de 4Por que o hello-world usa FakeListChatModel?

Passo 4 de 4: O que você já sabe fazer

O que você já sabe fazer

  • Escolher os pacotes para um agente LangGraph.js e dizer o que cada um faz.
  • Instalá-los com versões fixadas.
  • Explicar o que muda quando o LangGraph roda em um navegador.
  • Rodar código LangChain com um modelo falso, sem precisar de chave.