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
Pausando para uma decisão humana com interrupt()
Chamar interrupt("Approve this draft?") dentro de um nó interrompe o grafo naquele ponto e retorna o payload da interrupção para quem chamou, em vez de um erro — o estado até esse nó já está salvo por checkpoint. Retomar com graph.invoke(Command(resume=True), config=...) no mesmo ID de thread continua a execução exatamente de onde ela pausou — o padrão que o LangGraph usa para portões de aprovação em vez de um mecanismo de workflow separado.
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.
Use o LangGraph se
- Seu agente precisa pausar para uma etapa de aprovação humana e retomar mais tarde sem perder o lugar — a função
interrupt()e o checkpointing do LangGraph lidam com isso nativamente - Seu agente precisa sobreviver a um reinício de servidor ou falha no meio da tarefa — um checkpointer baseado em banco de dados retoma exatamente de onde o processo parou
- Seu fluxo de trabalho tem ciclos ou ramificações condicionais — um agente que replaneja, tenta novamente uma etapa que falhou, ou direciona entre vários nós especializados com base no estado
- Você está construindo um sistema multiagente ou hierárquico (um nó supervisor direcionando para subgrafos trabalhadores) e quer um conjunto consistente de primitivas para tudo isso
- Você quer um objeto de estado explícito e inspecionável em vez de um loop de agente opaco, por razões de depuração ou conformidade
Evite o LangGraph se
- Seu fluxo de trabalho é uma sequência simples e linear sem novas tentativas, ramificações ou necessidade de pausar — o LangChain simples com
create_agent, ou até mesmo um script Python curto chamando um modelo diretamente, tem menos sobrecarga - Sua equipe quer uma abstração multiagente baseada em papéis (agentes nomeados com papéis, metas e tarefas delegadas) em vez de um grafo de estado explícito — o CrewAI é construído especificamente em torno desse modelo mental
- Você ainda não usa o ecossistema LangChain e não quer essa pegada de dependências, mesmo que o LangGraph possa ser instalado de forma independente
- Você precisa de um framework multiagente de padrão conversacional (agentes conversando entre si em um loop de chat) em vez de um grafo direcionado — o AutoGen é especializado nesse padrão
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.
Erro 1: assumir que LangGraph e LangChain são o mesmo produto
O LangGraph é uma biblioteca distinta, de nível mais baixo, para orquestração de agentes baseada em grafos, desenvolvida pela mesma empresa que o LangChain, mas totalmente instalável e utilizável de forma independente. A abstração create_agent do LangChain roda sobre o LangGraph, mas muitas implantações de LangGraph em produção nunca importam o pacote principal langchain.
Erro 2: procurar uma tabela de preços do "LangGraph Platform" que não existe mais
O que era rotulado como LangGraph Platform até 2025 foi incorporado ao LangSmith Deployment em outubro de 2025. Faça o orçamento com base nos preços Plus/Enterprise do LangSmith e sua medição por vCPU-hora e GiB-hora, não em uma tabela de preços separada do LangGraph Platform — procurar por ela só trará à tona posts de blog e calculadoras de preços desatualizados.
Erro 3: recorrer a um grafo de estado completo quando uma cadeia linear resolveria
Nem todo agente precisa de nós, arestas e um checkpointer explícitos. Um único loop de chamada de ferramenta sem novas tentativas, ramificações ou necessidade de pausa é bem atendido pelo create_agent do LangChain ou por um script simples. Recorra à API de grafo de nível mais baixo do LangGraph quando você precisar especificamente de ciclos, roteamento condicional ou interrupções human-in-the-loop que uma abstração mais simples não expõe.
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.
