Principais conclusões
- Licença MIT — completamente gratuita para usar, modificar e hospedar você mesmo, sem limites de uso sobre a biblioteca em si
- Desenvolvido pela LangChain Inc., lançado pela primeira vez como pacote instalável independente em janeiro de 2024, após existir como módulo experimental de agentes dentro do LangChain
- Mais de 41.000 estrelas no GitHub no repositório principal langchain-ai/langgraph
- O LangGraph 1.0 alcançou disponibilidade geral em outubro de 2025 junto com o LangChain 1.0, com o compromisso conjunto de não introduzir mudanças que quebrem compatibilidade até a versão 2.0
- Modelo mental central: agentes como nós e arestas em um grafo, com um objeto de estado compartilhado que persiste a cada etapa
- O checkpointing integrado (por meio de um checkpointer intercambiável, como um armazenamento em memória ou um baseado em banco de dados) permite que um grafo pause, retome a partir de qualquer ponto e se recupere após um reinício do processo
- A hospedagem em produção de agentes LangGraph — comercializada como "LangGraph Platform" até 2025 — agora é vendida como LangSmith Deployment, um recurso cobrado por uso dentro dos planos pagos do LangSmith, e não como um produto independente com sua própria tabela de preços
📍 Em uma frase
O LangGraph é um framework gratuito, de código aberto e com licença MIT, desenvolvido pela LangChain Inc. para modelar agentes de IA como grafos de nós e arestas, com estado explícito, checkpointing e interrupções human-in-the-loop.
💬 Em termos simples
Em vez de escrever um agente como um único loop que chama um modelo e espera pelo melhor resultado, o LangGraph faz você desenhar o agente como um fluxograma — cada etapa é um nó, cada caminho possível entre etapas é uma aresta, e o progresso atual do agente é um estado salvo após cada etapa, para que ele possa pausar, retomar ou se recuperar após uma falha.
📌Nota: O LangGraph é uma biblioteca contra a qual se escreve código, não um aplicativo para baixar — não há interface gráfica para instalar no framework de código aberto em si (o LangGraph Studio, uma ferramenta visual de depuração separada, é opcional). Esta análise cobre juntas a biblioteca de código aberto LangGraph e sua opção paga de implantação em produção, já que a LangChain Inc. desenvolve e vende ambas como uma pilha conectada.
Quem criou o LangGraph, e como ele se tornou um produto próprio?
A LangChain Inc. desenvolveu o LangGraph como uma extensão do LangChain para agentes que precisavam de mais confiabilidade do que um loop simples poderia oferecer, e depois o separou em seu próprio pacote instalável. As primeiras abstrações de agentes do LangChain (o padrão "agent executor" anterior a 2024) funcionavam como um loop fixo com controle limitado sobre as etapas intermediárias, o que dificultava adicionar novas tentativas, pausar para uma decisão humana ou se recuperar de forma limpa após uma falha. O LangGraph resolveu isso modelando explicitamente um agente como um grafo, inspirando-se em ideias do Pregel do Google e do Apache Beam sobre como o estado se move entre as etapas de computação.
O LangGraph foi lançado como um pacote Python independente em janeiro de 2024, separado do pacote principal langchain, permitindo que as equipes adotassem o runtime baseado em grafos sem depender do restante do framework LangChain. A LangChain Inc. então construiu um produto de implantação hospedada em torno dele: uma versão beta chamada LangGraph Cloud em meados de 2024, que alcançou disponibilidade geral em maio de 2025 sob o nome LangGraph Platform. Em outubro de 2025, junto com os lançamentos de disponibilidade geral do LangChain 1.0 e do LangGraph 1.0, esse produto de hospedagem foi incorporado à família de produtos LangSmith e agora é vendido como LangSmith Deployment, em vez de como uma plataforma com marca própria e separada.
Módulo experimental dentro do LangChain
- Data:
- 2023
- O que significa:
- Ideias iniciais de agentes baseados em grafos existem no código do LangChain, em resposta às limitações do loop fixo do agent-executor
LangGraph como pacote independente
- Data:
- 2024-01
- O que significa:
- O LangGraph é lançado como seu próprio pacote Python instalável, independente do pacote principal langchain
LangGraph Cloud (beta)
- Data:
- 2024-06
- O que significa:
- Primeira oferta de implantação hospedada para agentes LangGraph, em fase beta
LangGraph Platform (GA)
- Data:
- 2025-05
- O que significa:
- O produto de implantação hospedada alcança disponibilidade geral sob o nome LangGraph Platform
LangGraph 1.0
- Data:
- 2025-10
- O que significa:
- Disponibilidade geral junto com o LangChain 1.0; compromisso público de não introduzir mudanças que quebrem compatibilidade até a versão 2.0
Incorporação ao LangSmith Deployment
- Data:
- 2025-10
- O que significa:
- A implantação hospedada é revendida como um recurso do LangSmith cobrado por uso, em vez de uma plataforma com marca própria e separada
📌Nota: A licença MIT da biblioteca de código aberto LangGraph não é afetada por esse reposicionamento — apenas o nome e a estrutura de preços do produto de implantação hospedada mudaram, não o status gratuito da biblioteca obtida via pip install.
O que é o LangGraph?
O LangGraph é uma biblioteca de código aberto (licença MIT, github.com/langchain-ai/langgraph) para construir agentes como grafos com estado, disponível para Python e JavaScript/TypeScript (como LangGraph.js). Em vez de uma cadeia linear de chamadas, um agente construído com o LangGraph é um grafo direcionado: os nós são unidades de trabalho (uma chamada de modelo, uma chamada de ferramenta, uma lógica de negócio), e as arestas definem qual nó é executado em seguida — incluindo arestas condicionais que se ramificam de acordo com o estado atual, e ciclos que permitem que o agente volte atrás para tentar novamente ou replanejar.
- Estado: um único objeto tipado (geralmente um
TypedDictdo Python) que cada nó lê e escreve, de modo que todo o grafo compartilha uma única fonte de verdade sobre o que aconteceu até então - Nós e arestas: os nós são funções simples que recebem o estado atual e retornam atualizações para ele; as arestas (incluindo arestas condicionais) decidem qual nó é executado em seguida com base nesse estado
- Checkpointing e persistência: um checkpointer intercambiável (um armazenamento em memória para desenvolvimento, ou um baseado em banco de dados como o Postgres para produção) salva o estado do grafo após cada etapa, vinculado a um ID de thread, para que uma execução possa pausar e retomar exatamente de onde parou
- Human-in-the-loop: a função
interrupt()pausa a execução dentro de um nó e devolve o controle ao código chamador; retomar com umCommand(resume=...)continua a mesma execução do grafo exatamente daquele ponto — é assim que o LangGraph implementa etapas de aprovação sem perder o estado - Grafos multiagente e hierárquicos: como um nó pode, por si só, invocar um subgrafo compilado, o LangGraph suporta arquiteturas de agente único, multiagente e hierárquicas (supervisor mais trabalhadores) com as mesmas primitivas
- LangGraph Studio: uma ferramenta visual opcional para inspecionar e percorrer passo a passo um grafo em execução, separada da biblioteca principal
from typing_extensions import TypedDict
from langgraph.graph import StateGraph, START, END
from langgraph.checkpoint.memory import MemorySaver
class State(TypedDict):
topic: str
draft: str
def write_draft(state: State) -> dict:
return {"draft": f"Draft about {state['topic']}"}
def review_draft(state: State) -> dict:
return {"draft": state["draft"] + " (reviewed)"}
builder = StateGraph(State)
builder.add_node("write", write_draft)
builder.add_node("review", review_draft)
builder.add_edge(START, "write")
builder.add_edge("write", "review")
builder.add_edge("review", END)
graph = builder.compile(checkpointer=MemorySaver())
result = graph.invoke(
{"topic": "local LLMs"},
config={"configurable": {"thread_id": "1"}},
)
print(result["draft"])Quanto custa o LangGraph?
A biblioteca LangGraph em si é totalmente gratuita sob a licença MIT — a hospedagem em produção de agentes LangGraph é o complemento pago cobrado por uso. A LangChain Inc. não cobra pela biblioteca de código aberto, seja ela autogerenciada, usada comercialmente ou modificada; sua receita de implantação vem dos planos do LangSmith, o mesmo produto da empresa que também vende o nível separado de observabilidade/rastreamento do LangSmith discutido na análise do LangChain do PromptQuorum.
- LangGraph (a biblioteca): gratuita para sempre sob a licença MIT, para Python e JavaScript/TypeScript, autogerenciada ou incorporada em qualquer aplicação
- Hospedar você mesmo seus próprios agentes: você pode executar grafos LangGraph compilados em seus próprios servidores com seu próprio checkpointer (por exemplo, Postgres) sem custo algum para a LangChain Inc. — sem taxa de licença para uso em produção autogerenciado
- Nível LangSmith Developer: US$ 0 por assento por mês, um assento, até 5.000 traces base por mês, depois pagamento por uso — não inclui implantação gerenciada
- Nível LangSmith Plus: US$ 39 por assento por mês, assentos ilimitados, até 10.000 traces base por mês incluídos, e inclui uma implantação serverless pequena e gratuita do LangGraph, além de acesso a Deployment, Engine e infraestrutura relacionada cobrados por uso
- LangSmith Enterprise: preço personalizado, adiciona opções de implantação autogerenciada/híbrida e SLAs personalizados
- O uso de implantação além da cota incluída é cobrado separadamente do uso de traces: a computação é cobrada em LCUs (1 LCU = US$ 1,50) e o uso de banco de dados em LSUs (1 LSU = US$ 1,00), por vCPU-hora e GiB-hora
- O que era comercializado como "LangGraph Platform" até 2025 hoje é cobrado como LangSmith Deployment — não existe mais uma tabela de preços separada do LangGraph Platform para orçamento; é um item de linha dentro de um plano do LangSmith
Nível | Preço | Ideal para |
|---|---|---|
| Biblioteca LangGraph | Gratuita (licença MIT) | Todos — autogerenciada, sem custo |
| LangSmith Developer | US$ 0/assento/mês, 5K traces | Devs individuais, prototipagem |
| LangSmith Plus | US$ 39/assento/mês, +medição | Equipes que precisam de hospedagem |
| LangSmith Enterprise | Preço personalizado | Autogerenciado/híbrido, conformidade |
Preços verificados na página oficial de preços da LangChain em setembro de 2026 e cobrados em USD em todo o mundo — a página não mostra preços específicos por região, então verifique a página ativa antes de orçar, já que os níveis de SaaS e as taxas de medição mudam sem muito aviso prévio.
Como instalar e começar a usar o LangGraph?
Instalar o LangGraph exige apenas um comando pip ou npm — nenhuma conta, chave de licença ou servidor é necessário para a biblioteca de código aberto. A implantação gerenciada via LangSmith é opcional e só é necessária quando você deseja hospedar um agente para que outros o chamem.
- 1Instale o pacote:
pip install -U langgraph(Python) ounpm install @langchain/langgraph(JavaScript/TypeScript). - 2Defina a chave de API do seu provedor de modelo como uma variável de ambiente (por exemplo,
OPENAI_API_KEY) — o LangGraph em si não fornece nem intermedia o acesso ao modelo; você chama o modelo escolhido de dentro de um nó. - 3Defina um esquema de estado (um
TypedDictou similar), construa umStateGrapha partir dele, registre nós comadd_node, e conecte-os comadd_edgeou uma aresta condicional. - 4Compile o grafo com
.compile(), passando umcheckpointer(umMemorySaverem memória para desenvolvimento, ou um baseado em banco de dados para produção) para que o estado persista entre etapas e reinícios do processo. - 5Use
interrupt()dentro de qualquer nó em que uma decisão humana seja necessária antes de continuar, e retome a execução pausada com umCommand(resume=...)no mesmo ID de thread. - 6Leia a documentação oficial do LangGraph e navegue pelo repositório no GitHub para a referência de API atual e o guia rápido de JavaScript/TypeScript.
- 7Opcionalmente, implante no LangSmith Deployment ou hospede você mesmo o grafo compilado atrás do seu próprio servidor de API quando precisar de hospedagem em produção em vez de uma execução local.
É preciso ter uma conta na LangChain Inc. para usar o LangGraph?
Não. A biblioteca LangGraph é instalada e executada sem nenhuma conta, e você fornece suas próprias chaves de API do provedor de modelo. Uma conta só é necessária se você optar por usar o LangSmith para rastreamento ou implantação gerenciada.
Instalar o LangGraph exige o LangChain?
Não. O LangGraph é lançado como seu próprio pacote e pode ser instalado e usado sem o pacote principal langchain, embora muitas equipes usem a abstração create_agent do LangChain (que, por sua vez, roda sobre o LangGraph) como ponto de partida de nível mais alto.
Para quem o LangGraph é indicado?
O LangGraph é indicado para equipes que constroem agentes em produção que precisam de controle explícito sobre estado, novas tentativas ou aprovação humana — nem todo agente precisa de um grafo. Ele se encaixa pior em um agente simples e linear de chamadas de ferramentas sem requisitos de ramificação ou persistência.
Quando você NÃO deveria usar o LangGraph?
Evite o LangGraph para um fluxo de trabalho linear simples, sem novas tentativas, ramificações ou necessidade de persistir o estado através de uma pausa — a abstração de grafo adiciona uma sobrecarga que um script direto não precisa. Algumas situações concretas em que outra ferramenta é melhor.
- Um fluxo de trabalho que sempre executa a mesma sequência fixa de etapas uma vez e retorna um resultado — uma simples cadeia de chamadas de função, ou o
create_agentdo LangChain, cobre isso com menos código - Uma equipe que quer um modelo mental baseado em papéis — agentes nomeados com personas, metas e subtarefas delegadas — em vez de pensar em nós e arestas explícitos; o CrewAI é projetado em torno dessa abstração
- Uma equipe que ainda não está investida no ecossistema LangChain, quer a menor pegada de dependências possível e está confortável gerenciando estado e novas tentativas manualmente
- Um projeto cuja necessidade principal são padrões de conversa multiagente (agentes debatendo ou revisando a saída um do outro em um loop de chat) em vez de um grafo de fluxo de controle explícito — o AutoGen é construído em torno desse padrão
- Use o LangGraph em vez disso quando o fluxo de trabalho realmente tiver ciclos, ramificações condicionais, necessidade de pausar para entrada humana, ou precisar sobreviver a um reinício no meio da tarefa
LangGraph vs. Alternativas
O LangGraph compete com outros frameworks de orquestração de agentes, cada um construído em torno de um modelo mental diferente de como um agente deve ser estruturado.
Ferramenta | Modelo mental | Licença | Apoio | Ideal para |
|---|---|---|---|---|
| LangGraph | Grafo de estado explícito | MIT | LangChain Inc. (financiada por VC) | Agentes de produção com estado |
| LangChain | Chains + create_agent | MIT | LangChain Inc. (financiada por VC) | Aplicações LLM de propósito geral |
| CrewAI | Equipes de agentes baseadas em papéis | MIT | CrewAI Inc. (financiada por VC) | Equipes multiagente com papéis nomeados |
| AutoGen | Conversa multiagente | MIT / CC-BY | Microsoft Research | Padrões de agentes em loop de chat |
| Semantic Kernel | Plugins + planejadores | MIT | Microsoft | Aplicações empresariais .NET-first |
Erros comuns ao avaliar o LangGraph
Esses erros vêm de confundir o LangGraph com o LangChain ou o LangGraph Platform, ou de recorrer a um grafo quando uma ferramenta mais simples resolveria.
Perguntas frequentes
O LangGraph é gratuito para usar?
Sim. A biblioteca LangGraph é de código aberto sob a licença MIT e gratuita para qualquer uso, incluindo produtos comerciais, sem limites de uso e sem taxa de licença para hospedar você mesmo seus próprios agentes em produção.
Quem criou o LangGraph?
O LangGraph foi desenvolvido pela LangChain Inc., a empresa financiada por capital de risco por trás do LangChain, fundada por Harrison Chase. Ele começou como um módulo experimental de agentes dentro do LangChain e foi lançado como pacote independente em janeiro de 2024.
Qual é a diferença entre LangGraph e LangChain?
O LangChain oferece um framework geral para chains, prompts e a abstração de nível mais alto create_agent. O LangGraph é o runtime de nível mais baixo, baseado em grafos, sobre o qual o próprio create_agent roda — use o LangGraph diretamente quando precisar de estado explícito, ciclos ou controle human-in-the-loop que o create_agent não expõe.
O que aconteceu com o LangGraph Platform?
O LangGraph Platform era o nome do produto de implantação de agentes hospedada da LangChain Inc., desde sua disponibilidade geral em maio de 2025 até outubro de 2025. Depois disso, ele foi incorporado à família de produtos LangSmith e agora é vendido como LangSmith Deployment, um recurso cobrado por uso dentro dos planos pagos do LangSmith, em vez de uma plataforma com marca própria e separada com sua própria tabela de preços.
Quanto custa hospedar um agente LangGraph em produção?
O nível LangSmith Plus (US$ 39 por assento por mês) inclui uma implantação serverless pequena gratuita; o uso acima disso é cobrado separadamente em LCUs para computação (1 LCU = US$ 1,50) e LSUs para uso de banco de dados (1 LSU = US$ 1,00), por vCPU-hora e GiB-hora. O preço do Enterprise é personalizado.
É possível hospedar você mesmo agentes LangGraph em vez de pagar por implantação gerenciada?
Sim. Como o LangGraph tem licença MIT, você pode compilar um grafo, escolher seu próprio checkpointer (como um banco de dados Postgres autogerenciado) e executá-lo atrás do seu próprio servidor de API ou infraestrutura sem custo de licença — a implantação gerenciada via LangSmith é uma conveniência opcional, não uma exigência.
O que é um checkpointer no LangGraph?
Um checkpointer é um componente intercambiável que salva o estado de um grafo após cada etapa, vinculado a um ID de thread. Um MemorySaver em memória é comum para desenvolvimento e testes; implantações em produção normalmente usam um checkpointer baseado em banco de dados para que uma execução possa ser retomada após um reinício do processo.
Como funciona o human-in-the-loop no LangGraph?
Chamar interrupt() dentro de um nó pausa a execução do grafo naquele ponto e devolve o controle ao código chamador, com o estado já salvo por checkpoint. Retomar com uma chamada Command(resume=...) no mesmo ID de thread continua a execução exatamente de onde ela pausou.
Quantas estrelas no GitHub o LangGraph tem?
O repositório principal langchain-ai/langgraph passou de 41.000 estrelas no GitHub — menos que o repositório principal do LangChain (mais de 140.000), o que reflete que o LangGraph é uma biblioteca mais especializada e de nível mais baixo, em vez de um framework de propósito geral.
O LangGraph é melhor que o CrewAI para sistemas multiagente?
Nenhum é estritamente melhor — eles modelam sistemas multiagente de forma diferente. O LangGraph expõe um grafo de estado explícito que você controla nó por nó, o que serve bem a equipes que precisam de controle fino ou etapas de aprovação humana. O CrewAI oferece uma abstração baseada em papéis (agentes nomeados com metas e tarefas delegadas), mais rápida de configurar para equipes confortáveis com menos controle de baixo nível.
