LangGraph
LangGraph описывает агента как граф: узлы — функции, рёбра — переходы, состояние — общий объект, который узлы читают и обновляют. Это не «фреймворк для всего», а низкоуровневый оркестратор: маршрут виден в коде, а не возникает в промпте.
Модель программирования
Заголовок раздела «Модель программирования»class ResearchState(TypedDict): query: str search_results: list report: str
graph = StateGraph(ResearchState)graph.add_node("search", search_web)graph.add_node("synthesize", synthesize_report)graph.set_entry_point("search")graph.add_edge("search", "synthesize")graph.add_edge("synthesize", END)agent = graph.compile()Три свойства определяют всё остальное:
- Состояние явное. Поля описаны типами, а не живут в прозе диалога.
- Переходы явные. Видно, куда пойдёт выполнение; условные рёбра задают ветвление.
- Компиляция. Граф собирается один раз и исполняется как объект, а не интерпретируется на каждом шаге.
Именно так устроены 01, 13 и 19.
Чекпойнты и прерывания
Заголовок раздела «Чекпойнты и прерывания»Главная причина выбрать LangGraph — долгие задачи с участием человека. Чекпойнтер сохраняет состояние после каждого шага: задача переживает перезапуск процесса, а на нужном узле можно прерваться и дождаться подтверждения.
Практический сценарий: агент подготовил действие с побочным эффектом (списание, публикация), граф останавливается, человек подтверждает, выполнение продолжается с того же места. Без чекпойнтов это пишется вручную и обычно с ошибками.
Когда LangGraph оправдан
Заголовок раздела «Когда LangGraph оправдан»- Задача многошаговая и может длиться дольше одного запроса.
- Нужен аудит: по трассе видно, какой узел что решил.
- Нужны прерывания и возобновление.
- Нужен контроль над маршрутом: разработчик определяет ветки, модель — только аргументы.
Когда не нужен
Заголовок раздела «Когда не нужен»- Фиксированный маршрут из двух-трёх шагов: хватит функции и одного вызова модели.
- Простой RAG: индекс и запрос без графа.
- Команда ролей, где важнее декларативное описание, чем маршрут — там естественнее CrewAI.
Чем платите
Заголовок раздела «Чем платите»- Порог входа. Нужно думать состоянием и переходами, а не диалогом.
- Многословность. Простой агент требует больше кода, чем в «ролевых» фреймворках.
- Связность с экосистемой. LangGraph строится поверх LangChain, поэтому тянет его абстракции и обновления.
- Версионные изменения. API развивается быстро; фиксируйте версию и перечитывайте документацию при обновлении.
Место в экосистеме
Заголовок раздела «Место в экосистеме»LangGraph — часть стека LangChain: модели и интеграции берутся из LangChain, оркестрация — из LangGraph. Если нужен только доступ к модели и инструментам без графа, LangGraph избыточен.
Материалы и источники
Заголовок раздела «Материалы и источники»- LangGraph: concepts — состояние, чекпойнты, прерывания.
- LangGraph: persistence — как устроены чекпойнты.