Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Импорт приложения 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.

Создание примера

Импорт этого примера можно запустить командами ниже или поручить его запуск своему ИИ-ассистенту.

Запишите пример в новую папку, названную по его имени:

Terminal window
aggrega scaffold --example import-langgraph

Затем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку:

Terminal window
cd import-langgraph

Сборка

Импорт создаёт черновики файлов Aggrega рядом с проектом, в source/. Он сопоставляет проект с каталогом стандартной библиотеки, который реестр рабочего пространства по умолчанию публикует как подписанный снимок: первый импорт загружает его, проверяет, сохраняет в кэше содержимого рабочего пространства и называет по дайджесту в записи, которую создаёт рядом с черновиками. Рабочее пространство, которое называет собственные папки каталога — в AGGREGA_CATALOG_DIRS или в workspace.catalog_dirs, — вместо этого импортирует относительно них. Импорт читает модель и образ из import-answers.yaml, а затем загружает то, от чего зависит черновик сущности Release, поэтому сборка может последовать сразу:

Terminal window
cd source
aggrega import . --target compose
aggrega 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, поэтому запрос отправляется с вашей машины:

Terminal window
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, и отправьте ему тот же запрос из другого терминала:

Terminal window
kubectl port-forward deploy/support 8000:8000
Terminal window
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."}'

Ответ тот же.