Импорт приложения LangGraph — один граф и его механизм контрольных точек
langgraph.json приложения LangGraph — один граф, хранящий своё состояние в PostgreSQL, — преобразованный командой aggrega import в черновики файлов Aggrega, с моделью, которую вызывает граф, и образом приложения, указанными один раз в файле ответов, и собранный для Docker Compose.
Импорт приложения LangGraph пошагово разбирает этот процесс: команду, что она запрашивает, файлы, которые она записывает, и зачем в них каждая строка, сборку и работу графа. В этой папке хранится каждый этап этого руководства:
| папка или файл | что содержит |
|---|---|
source/ | langgraph.json приложения, файл .aggrega-config.yaml, который делает папку рабочим пространством, и import-answers.yaml — значения, которых не содержит ни одна конфигурация: модель, образ приложения и имена Kubernetes Secrets, из которых сборка для Kubernetes читает ключ и пароль базы данных |
draft/ | файлы, которые записала команда aggrega import . --target compose, без изменений, включая release.lock, и то, что она вывела: stdout.txt — стандартный вывод, import.txt — стандартный поток ошибок |
Конфигурация написана для этого примера. Код приложения в пример не входит: импорт никогда его не читает, а образ, в котором работает приложение, указывает Release.
В клоне репозитория документации check.sh повторно запускает импорт, сравнивает то, что он записывает и выводит, с draft/, сравнивает блоки, которые цитирует руководство, с этими файлами, а также валидирует и собирает то, что записал импорт. Для этого каталог стандартной библиотеки (где его взять) должен быть извлечён рядом с этим репозиторием или его директория должна быть указана в AGGREGA_CATALOG_DIRS.
Создание примера
Импорт этого примера можно запустить командами ниже или поручить его запуск своему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example import-langgraphЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:
cd import-langgraphСборка
Импорт создаёт черновики файлов Aggrega рядом с проектом, в source/. Он сопоставляет проект с каталогом стандартной библиотеки, который реестр рабочего пространства по умолчанию публикует как подписанный снимок: первый импорт загружает его, проверяет, сохраняет в кэше содержимого рабочего пространства и называет по дайджесту в записи, которую создаёт рядом с черновиками. Рабочее пространство, которое называет собственные папки каталога — в AGGREGA_CATALOG_DIRS или в workspace.catalog_dirs, — вместо этого импортирует относительно них. Импорт читает модель и образ из import-answers.yaml, а затем загружает то, от чего зависит черновик сущности Release, поэтому сборка может последовать сразу:
cd sourceaggrega import . --target composeaggrega build --release release.yamlОбраз, который называет пример, заменяет тот, что вы собираете из своего проекта; его сборка и запуск стека описаны в руководстве по ссылке выше.
С ИИ-ассистентом
ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.
Используйте только инструменты Aggrega и не создавайте папки самостоятельно. Если в папке рабочей области ещё нет папки `import-langgraph`, вызовите один раз инструмент `scaffold`, задав для `example` значение `import-langgraph` и не указывая `dir`: он запишет пример в новую папку `import-langgraph`, папка `source` которой содержит то, что импортирует этот пример. Затем вызовите инструмент `import`, задав `workspace_root` значение `import-langgraph/source`, `source` — `.`, а `target` — `compose`: он читает нужные ему ответы из `import-answers.yaml` рядом с `langgraph.json`, записывает свои черновики в `import-langgraph/source` и загружает то, что им нужно. Затем вызовите инструмент `validate`, задав `workspace_root` значение `import-langgraph/source`, а `release` — `release.yaml`, и инструмент `build`, задав `workspace_root` значение `import-langgraph/source`, `release` — `release.yaml`, а `write` — true. Скажите мне, какие файлы записала сборка; они находятся в `import-langgraph/source/dist/`.Тестирование
Когда стек работает так, как его запускает пошаговое руководство, один запрос доходит до графа. Приведённый ниже маршрут принадлежит собственной программе руководства, небольшому HTTP-серверу на порту 8000; ваша собственная программа определяет свой. Сущность Release публикует граф на 127.0.0.1:8000, поэтому запрос отправляется с вашей машины:
curl -sS -X POST http://127.0.0.1:8000/threads/order-1234/runs -H 'Content-Type: application/json' \ -d '{"message": "Where is my order 1234? It has not arrived yet."}'{ "thread": "order-1234", "error": "the run failed: OpenAIAuthenticationError: Error code: 401 - Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key]"}Ключ этого запуска был заполнителем, поэтому ответом является отказ OpenAI принять его. В Kubernetes перенаправьте локальный порт на Deployment, у которого нет Service, и отправьте ему тот же запрос из другого терминала:
kubectl port-forward deploy/support 8000:8000curl -sS -X POST http://127.0.0.1:8000/threads/order-1234/runs -H 'Content-Type: application/json' \ -d '{"message": "Where is my order 1234? It has not arrived yet."}'Ответ тот же.