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.
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
Próximo: Pergunta 2 de 4
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.