Импорт потока Langflow
Это пошаговое руководство импортирует поток, экспортированный из Langflow, — Basic Prompting, стартовый проект, поставляемый с Langflow 1.6.0, — в сущности Aggregate, Release и Manifest, которые в том виде, в каком они записаны, собирают Langflow с этим потоком для Docker Compose, затем собирает их и запускает результат. Каждый файл и каждый блок вывода ниже взяты из реального запуска; поток и каждый этап руководства находятся в примере import-langflow, где проверочный скрипт заново запускает импорт, сравнивает то, что он записывает, то, что он выводит, и блоки, которые цитирует эта страница, с хранящимися там файлами, а также валидирует и собирает то, что записал импорт.
Создание примера
Этот импорт можно выполнить командами с этой страницы или поручить его вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example import-langflowЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку; следующая, ниже, переходит в её папку source, в которой выполняется импорт. Эта папка содержит файл потока, basic-prompting.json, который эта страница описывает, а не цитирует:
cd import-langflow
Поток
Basic Prompting выстраивает в цепочку четыре узла: Chat Input, Prompt, Language Model, вызывающий gpt-4.1 от OpenAI, и Chat Output. В том виде, в каком его поставляет Langflow, он представляет собой один файл JSON, basic-prompting.json, размером около 54 КБ, который несёт исходный код каждого компонента, а также сам поток. Его узел Language Model считывает ключ из глобальной переменной OPENAI_API_KEY, которую Langflow считывает из своего окружения, если переменная с таким именем не сохранена.
Рядом с потоком файл .aggrega-config.yaml делает папку рабочим пространством:
# The workspace key marks this directory as the workspace root, so an import run# here writes its drafts beside basic-prompting.json.workspace: {}# The registry the importer is fetched from the first time an import needs it.default_registry: hub.aggrega.aiа import-answers.yaml содержит ответы на то, чего не может содержать ни один поток. Импорту для Docker Compose ни один из них не нужен: он подключает каждый секрет через ссылку на переменную, которую Docker Compose заполняет из вашей оболочки. Импорт для Kubernetes подключает каждый секрет через имя объекта Secret Kubernetes, которое можете указать только вы, поэтому файл называет два объекта Secret, которые запрашивает этот импорт (см. В Kubernetes):
# Values the import could not draft from the source, keyed by the drafted file and the key path inside# it. Write each one beside its key; an import of the same source, and a sync, read them from here and# ask nothing. A secret is never written here: its key asks where the secret comes from — a variable# name, ${NAME}, or the name of a Kubernetes Secret.release.yaml: # The origin of the secret value, written by the operator in the Release. Read exactly as # values.origin is. Write it here or in values.origin, never in both. A secret: name where it comes # from, never the value. spec.components.langflow.features.admin_password.infra.origin: "langflow-admin" # The origin of the secret value, written by the operator in the Release. Read exactly as # values.origin is. Write it here or in values.origin, never in both. A secret: name where it comes # from, never the value. spec.components.langflow.uses.model.languagemodelcomponent-kboja.features.credential.infra.origin: "openai-api-key"Каждый ответ — это имя объекта Secret, но никогда не сам секрет, поэтому файл можно хранить вместе с потоком. Файл ответов импорта описывает этот файл полностью.
Импорт оценивает каждый узел относительно сущностей Components из каталога рабочего пространства, а --target создаёт черновик сущности Manifest из сущностей Recipes этого каталога. Рабочее пространство не указывает ни одной папки каталога, поэтому импорт читает каталог стандартной библиотеки из реестра, из которого получает свой импортёр: подписанный снимок опубликованного каталога, который первый импорт получает, проверяет и сохраняет в кэше содержимого рабочего пространства и который запись, создаваемая импортом рядом с черновиками, называет по его дайджесту. Рабочее пространство, указывающее собственные папки каталога — в AGGREGA_CATALOG_DIRS или в workspace.catalog_dirs, — вместо этого импортирует на их основе. Перейдите в source:
cd sourceЗапуск импорта
aggrega import basic-prompting.json --target composeВ стандартный вывод он выводит список записанного:
wrote aggregate.yamlwrote release.yamlwrote manifest.yamlwrote .aggrega-import.jsonВ стандартный поток ошибок, где <workspace> обозначает папку, в которой вы его запустили:
[… omitted: a warning that the importer runs unverified, printed where its module is read from beside its Plugin entity in a catalog folder rather than fetched]read as the langflow format, with drafted paths relative to <workspace>warn: the flow is carried in values.flow_definition with the handles of all 3 of its edges written as Langflow's editor writes them — the same handles, their keys in order with no space between them — since the editor compares an edge's handles with the ones it writes for the nodes the edge joins, character for character, when it opens the flow, and drops every edge whose handles differwarn: node LanguageModelComponent-kBOja reaches languagemodelcomponent-kboja through the model connection languagemodelcomponent-kboja of core/ai-agent/langflow: its field api_key names the variable OPENAI_API_KEY, which the platform delivers for this connection and Langflow reads as a global variable; no field of it gives its API's address, so the OpenAI client it runs takes OPENAI_BASE_URL, the address the platform delivers for this connection, from the environmentmade no choice for ChatInput-SzjnT (ChatInput)made no choice for Prompt-tOH5D (Prompt)made no choice for ChatOutput-8ZWWB (ChatOutput)mapped LanguageModelComponent-kBOja (LanguageModelComponent) to core/ai-model/openai as a reference, HIGH at 0.9 warning: node "langflow" (provider "compose"): artifact "langflow-flow/langflow-flow.yaml": skipped provenance label injection — the fragment declares no compose service. Compose carries build provenance as service labels, so a fragment contributing only top-level networks, volumes or configs carries none; the services this component emits elsewhere carry the full set.Pull complete: <workspace>/release.lock (entities=8, source_artifacts=0, external_inputs=0)
- Строка
mappedсообщает, чем стал узел Language Model: моделью OpenAI из стандартной библиотеки,core/ai-model/openai, на которую сослались, а не создали в черновике, поскольку она совпала на высоком уровне, с оценкой 0.9. Это отдельный компонент, подключённый к сокетуmodelплатформы. По умолчанию черновик запускает весь поток на платформе, которая запускает Langflow, и выделяет отдельный компонент только узлу, который принимает сокет этой платформы, — модели, инструменту, векторному хранилищу, — если узел распознан как таковой. - Первая строка
warnсообщает, что поток перенесён с дескрипторами каждого ребра, записанными так, как их записывает редактор Langflow. Langflow хранит свои стартовые проекты с пробелом после каждого двоеточия и каждой запятой в дескрипторах ребра; его редактор, открывая поток, отбрасывает каждое ребро, дескрипторы которого записаны не в точности так, как записывает их он, а затем сохраняет поток без него. Записанный так, поток открывается со своими тремя соединениями и выполняется с ними. - Строка
warn, называющая узел, сообщает, как поток достигает этой модели. Узел считывает свой ключ из переменнойOPENAI_API_KEY, а свой адрес — изOPENAI_BASE_URL, и платформа передаёт оба значения для соединения с моделью, поэтому поток не нуждается в правке. - Строки
made no choiceназывают узлы, которые не принимает ни один сокет платформы: они остаются внутри потока, который Langflow запускает в экспортированном виде. - Последние две строки — это загрузка. Отвечать было больше не на что, поэтому импорт загрузил зависимости черновой сущности Release, как это делает
aggrega pull, и записалrelease.lock; сборке ниже больше ничего не нужно. Строкуwarningвыводит и сборка, а Проверка и сборка её объясняет.
Файл ответов называет два объекта Secret, которые этот импорт не запрашивает: для них он не оставляет ничего пустого, поэтому не применяет ни один из них и оставляет файл как есть.
Что он записывает
Сущности Aggregate, Release и Manifest получают имя imported/basic-prompting по собственному имени потока, Basic Prompting, сокращённому до basic-prompting — поток без имени получает имя по своему файлу — в пространстве имён, которое задаёт настройка target_namespace импортера, то есть imported, если вы не зададите другое (Настройки).
aggregate.yaml — один экземпляр платформы Langflow из стандартной библиотеки, core/ai-agent/langflow, несущий поток в том виде, в каком он был экспортирован, за исключением дескрипторов его рёбер, записанных так, как их записывает редактор Langflow, — более тысячи его строк здесь опущено, — и модель, к которой поток обращается:
apiVersion: aggrega.ai/v1beta1kind: Aggregatemetadata: name: imported/basic-prompting version: 0.1.0 description: Draft Aggregate imported from a source in the langflow format.spec: components: langflow: type: core/ai-agent/langflow features: # For the compose target, the lines below declare admin_password on langflow: a secret the Release alone attaches arrives under the key value, so each is declared with a key of its own and no two arrive under one; the Release attaches its origin, naming this type or none. admin_password: type: core/secret-value values: key: LANGFLOW_SUPERUSER_PASSWORD values: flow_id: '0dbee653-41ae-4e51-af2e-55757fb24be3' flow_definition: |- { "data": { "edges": [ [… omitted: the rest of the flow] } uses: model: languagemodelcomponent-kboja: target: languagemodelcomponent-kboja # For the compose target, the lines below declare credential on languagemodelcomponent-kboja: a secret the Release alone attaches arrives under the key value, so each is declared with a key of its own and no two arrive under one; the Release attaches its origin, naming this type or none. features: credential: type: core/secret-value values: key: OPENAI_API_KEY # swap to core/ai-model/azure-openai (score 0.4000) by setting type: core/ai-model/azure-openai languagemodelcomponent-kboja: type: core/ai-model/openai values: model: |- gpt-4.1- Модель — это
core/ai-model/openaiс моделью, которую выбирает узел потока,gpt-4.1. Комментарий над ней называет другую сущность Component из каталога, на которую похож узел, вместе с её оценкой, для читателя, которому нужна именно она. - Два секрета — пароль администратора, который запрашивает редактор Langflow, и ключ OpenAI, который платформа предъявляет модели, — объявлены здесь вместе с переменной, под которой каждый поступает в окружение Langflow,
LANGFLOW_SUPERUSER_PASSWORDиOPENAI_API_KEY. В Docker Compose секрет, прикреплённый только сущностью Release, пришёл бы под ключомvalue, и оба конфликтовали бы; объявленный здесь, каждый получает собственный ключ. Сущность Release указывает, откуда поступает каждый. flow_id— это идентификатор, который экспорт присваивает потоку.
release.yaml — сущность Release, которая развёртывает сущность Aggregate с сущностью Manifest:
apiVersion: aggrega.ai/v1beta1kind: Releasemetadata: name: imported/basic-prompting # environment is a drafted default, since no source names the environment this Release deploys to; change it to name the one it deploys to. environment: development version: 0.1.0 description: Draft Release imported from a source in the langflow format.spec: aggregate: imported/basic-prompting manifest: imported/basic-prompting components: langflow: infra: # The image running core/ai-agent/langflow, at the version this importer drafts, which the catalog's Recipes for it are known to run; the import does not raise or lower it to follow the source. The source states version "1.5.0" of the platform. image: "langflowai/langflow:1.6.0" # Published on this machine's loopback address, 127.0.0.1: reachable from this machine only, by any process running on it. Delete this line to keep the service internal. published_port: 7860 features: admin_password: type: core/secret-value infra: # Attached by reference, never as a value: the administrator's password, read while values.require_authentication stays true, read from the variable LANGFLOW_ADMIN_PASSWORD, which a target substituting variable references, as Docker Compose does when the stack starts, reads from the environment, so no file carries the value. origin: "${LANGFLOW_ADMIN_PASSWORD}" uses: model: languagemodelcomponent-kboja: features: credential: type: core/secret-value infra: # Attached by reference, never as a value: the credential langflow presents to languagemodelcomponent-kboja on its model connection, read from the variable OPENAI_API_KEY, which a target substituting variable references, as Docker Compose does when the stack starts, reads from the environment, so no file carries the value. origin: "${OPENAI_API_KEY}" languagemodelcomponent-kboja: {}environmentимеет значениеdevelopment— значение по умолчанию, которое, как говорит комментарий над ним, следует заменить на среду, в которую развёртывается сущность Release.- Образ — Langflow 1.6.0, версия, которую запускают сущности Recipes из каталога для Langflow. Поток в последний раз тестировался на Langflow 1.5.0, как указано в комментарии; импорт сохраняет версию, которую запускают сущности Recipes, а не следует версии потока.
published_portравен 7860, порту, на котором работает Langflow, поэтому редактор отвечает по адресуhttp://127.0.0.1:7860на вашей машине. Как говорит его комментарий, любой процесс на этой машине может обратиться к нему там, а ничто другое — нет; удалите строку, чтобы оставить Langflow только в сети стека.- Два секрета — это ссылки на переменные,
${LANGFLOW_ADMIN_PASSWORD}и${OPENAI_API_KEY}, которые Docker Compose заполняет из вашей оболочки при запуске стека, поэтому ни один файл не содержит ни одного из этих значений.
manifest.yaml — сущности Recipes для Compose для платформы и модели, а также реализация, которая записывает ссылку на переменную секрета в файл Compose как есть:
apiVersion: aggrega.ai/v1beta1kind: Manifestmetadata: name: imported/basic-prompting version: 0.1.0spec: mappings: components: type: core/ai-agent/langflow: compose/langflow core/ai-model/openai: compose/openai features: type: core/secret-value: compose/dotenv-secret.aggrega-import.json — это запись того, что записал импорт, которую читает последующий aggrega import --sync, а release.lock закрепляет каждую сущность каталога, в которую разрешается сущность Release, по версии и дайджесту.
Проверка и сборка
aggrega validate --release release.yamlaggrega build --release release.yaml

Проверка выводит:
notice: LINT: Feature "core/secret-value" at core/secret-value:1.0.0 declares property "origin" in both values: and infra: pillars (path: origin)release dependency validation passed: release.yaml (schema-pillar + dependency pillars)и сборка, где <workspace> обозначает папку с черновиками:
warning: node "langflow" (provider "compose"): artifact "langflow-flow/langflow-flow.yaml": skipped provenance label injection — the fragment declares no compose service. Compose carries build provenance as service labels, so a fragment contributing only top-level networks, volumes or configs carries none; the services this component emits elsewhere carry the full set. notice: LINT: Feature "core/secret-value" at core/secret-value:1.0.0 declares property "origin" in both values: and infra: pillars (path: origin)[… omitted: a total build time, which differs per run]Build completed: 1 file written to <workspace>/distСтрока warning касается части файла Compose, которая несёт поток, — записи configs верхнего уровня, у которой нет сервиса, на который можно было бы поставить метки сборки. Строка notice носит рекомендательный характер: сущность Feature для секрета принимает свой origin из values сущности Aggregate или из infra сущности Release, и уведомление сообщает, что один листовой элемент объявлен в обоих. Ни одна из них не меняет вердикта.
dist/compose/docker-compose.yaml содержит Langflow и сервис, который запускается один раз перед ним:
services: langflow: image: langflowai/langflow:1.6.0 environment: LANGFLOW_CONFIG_DIR: /app/langflow LANGFLOW_SAVE_DB_IN_CONFIG_DIR: "true" LANGFLOW_AUTO_LOGIN: "false" LANGFLOW_SUPERUSER: admin LANGFLOW_SUPERUSER_PASSWORD: ${LANGFLOW_ADMIN_PASSWORD} OPENAI_BASE_URL: https://api.openai.com/v1 OPENAI_API_KEY: ${OPENAI_API_KEY} LANGFLOW_LOAD_FLOWS_PATH: /app/flows ports: - 127.0.0.1:7860:7860 [… omitted: the labels the build writes on every service, naming the Aggregate, the component, the environment and the compiler's version] volumes: - type: volume source: langflow--data target: /app/langflow networks: - compose depends_on: langflow--data-owner: condition: service_completed_successfully [… omitted: the service's health check] configs: - source: langflow-flow target: /app/flows/flow.json langflow--data-owner: image: langflowai/langflow:1.6.0 entrypoint: - chown - "1000:0" - /app/langflow [… omitted: the labels the build writes on every service] volumes: - type: volume source: langflow--data target: /app/langflow networks: - compose restart: "no" user: "0"Поток попадает в Langflow как /app/flows/flow.json из записи configs, содержащей поток, который несёт сущность Aggregate, и Langflow загружает его из LANGFLOW_LOAD_FLOWS_PATH при каждом запуске. Ключ и пароль — это ссылки на переменные, которые заполняются из вашей оболочки при запуске стека. Сущность Recipe для Compose платформы Langflow публикует порт на вашей машине только там, где сущность Release задаёт published_port в infra платформы Langflow, и тогда только на адресе обратной петли, 127.0.0.1; без этого к сервису можно обратиться только в сети стека.
langflow--data-owner запускает образ Langflow от имени root, передаёт том данных пользователю 1000 и группе 0, от имени которых работает образ Langflow, и завершается. Langflow запускается после того, как этот сервис завершится: Docker создаёт том, владельцем которого является root, и иначе Langflow не смог бы записывать туда свои данные.
С ИИ-ассистентом
ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.
Используй только инструменты Aggrega и не создавай никаких папок самостоятельно. Если папка Workspace ещё не содержит папку `import-langflow`, вызови один раз инструмент `scaffold` с `example`, установленным в `import-langflow`, и без `dir`: он записывает пример в новую папку `import-langflow`, папка `source` которой содержит то, что импортирует эта страница. Затем вызови инструмент `import` с `workspace_root`, установленным в `import-langflow/source`, `source`, установленным в `basic-prompting.json`, и `target`, установленным в `compose`: он считывает нужные ему ответы из `import-answers.yaml` рядом с `basic-prompting.json`, записывает свои черновики в `import-langflow/source` и загружает то, что им нужно. Затем вызови инструмент `validate` с `workspace_root`, установленным в `import-langflow/source`, и `release`, установленным в `release.yaml`, и инструмент `build` с `workspace_root`, установленным в `import-langflow/source`, `release`, установленным в `release.yaml`, и `write`, установленным в true. Скажи мне, какие файлы записала сборка; они находятся в `import-langflow/source/dist/`.Открытие в VS Code
Когда расширение Aggrega для Visual Studio Code установлено, откройте в VS Code папку import-langflow/source, куда импорт записал свои черновики. Папка содержит одну сущность Release, созданный release.yaml, поэтому редактор выбирает её за вас и проверяет черновики относительно этой сущности Release по мере их редактирования, отмечая найденное в файле и на панели «Проблемы». Aggrega: Show topology graph в палитре команд рисует компоненты сущности Release и соединения между ними. Aggrega: Build, Aggrega: Preview build и Aggrega: Pull действуют на ту же сущность Release, и каждая из них также является кнопкой на панели Commands представления Aggrega на панели действий; Build записывает свои файлы в dist/ папки. Использование Aggrega в Visual Studio Code описывает остальное.
Запуск
Задайте ключ и пароль администратора в своей оболочке, затем запустите стек:
export OPENAI_API_KEY='your OpenAI key'export LANGFLOW_ADMIN_PASSWORD='a password of your own'docker compose -p basic-prompting -f dist/compose/docker-compose.yaml up -d --wait-p задаёт имя проекта, как объясняет шаг запуска в Как выполняется импорт. --wait возвращает управление, как только langflow--data-owner завершится, а Langflow сообщит о работоспособном состоянии.
Тестирование
Откройте http://127.0.0.1:7860, адрес, который публикует published_port, и войдите как admin с заданным паролем: Basic Prompting находится в редакторе со своими тремя соединениями.
Langflow выполняет поток через свой API только для ключа API, который администратор создаёт после входа. Войдите:
curl -sS -X POST http://127.0.0.1:7860/api/v1/login \ -d username=admin --data-urlencode "password=$LANGFLOW_ADMIN_PASSWORD"{"access_token":"[… omitted: the access token]","refresh_token":"[… omitted: the refresh token]","token_type":"bearer"}создайте ключ с помощью токена доступа:
curl -sS -X POST http://127.0.0.1:7860/api/v1/api_key/ \ -H 'Authorization: Bearer <access_token>' -H 'Content-Type: application/json' -d '{"name": "test-it"}'{"name":"test-it","last_used_at":null,"total_uses":0,"is_active":true,"id":"[… omitted: the key's identifier]","api_key":"[… omitted: the key]","user_id":"[… omitted: the owner's identifier]"}и запустите поток с этим ключом:
curl -sS -X POST 'http://127.0.0.1:7860/api/v1/run/0dbee653-41ae-4e51-af2e-55757fb24be3?stream=false' \ -H 'x-api-key: <api_key>' -H 'Content-Type: application/json' \ -d '{"input_value": "In one short sentence: what is Docker Compose?", "input_type": "chat", "output_type": "chat"}'Запуск использовал заполнитель вместо ключа OpenAI, поэтому ответом является отказ OpenAI принять ключ, что показывает, что поток выполнился вплоть до своего вызова модели:
{"detail":"{\"message\":\"Error running graph: Error building Component Language Model: \\n\\nError code: 401 - {'error': {'message': 'Incorrect API key provided: sk-place*****************-key. You can find your API key at https://platform.openai.com/account/api-keys.', 'type': 'invalid_request_error', 'code': 'invalid_api_key', 'param': None}, 'status': 401}\",[… omitted: three empty fields, and a suggestion to update three of the flow's components]}"}С вашим ключом ответ содержит ответ модели в outputs[0].outputs[0].results.message.text.
В Kubernetes, когда сборка, описанная в В Kubernetes, применена, перенаправьте локальный порт на Service платформы Langflow, langflow-default, в пространстве имён, к которому вы применили сборку, и оставьте команду запущенной:
kubectl port-forward -n <namespace> svc/langflow-default 7860:7860Из другого терминала три приведённых выше запроса достигают Langflow по тому же адресу без изменений; запуск получил тот же отказ для ключа-заполнителя.
Остановите стек командой ниже. -v также удаляет том данных Langflow, а вместе с ним учётную запись администратора, ключ API и историю запусков потока:
docker compose -p basic-prompting -f dist/compose/docker-compose.yaml down -vВ Kubernetes
Тот же поток импортируется для Kubernetes с целью helm. Черновики для Docker Compose уже лежат в source, а импорт никогда не перезаписывает находящуюся там сущность Aggregate, поэтому создайте эти черновики в отдельной папке с помощью --output-dir, а затем валидируйте и собирайте из неё:
aggrega import basic-prompting.json --target helm --output-dir helmcd helmaggrega validate --release release.yamlaggrega build --release release.yamlЧерновики различаются там, где различается цель. Сущность Manifest сопоставляет платформу с helm/langflow, модель — с helm/openai, а каждый секрет — с helm/k8s-existing-secret, который читает его из объекта Secret, уже существующего в пространстве имён. Сущность Release подключает оба секрета как core/referenced-secret, каждый из которых указывает имя этого Secret, и именно эти имена хранит файл ответов:
features: admin_password: type: core/referenced-secret infra: # Left for the Release, since the source cannot supply it: the name of a Kubernetes Secret already in the namespace holding, under the data key value, the administrator's password, read while values.require_authentication stays true. origin: "langflow-admin"Без файла ответов импорт запрашивает оба имени в терминале и записывает ваши ответы в новый файл ответов. Там, где ничего нельзя запросить, он записывает этот файл с обоими ключами и пустыми ответами и завершается со статусом 1 и этой строкой, где <workspace> обозначает папку, в которой вы его запустили:
2 values the drafts leave empty are still owed, listed in the answers file <workspace>/import-answers.yaml: write each beside its key there, then run the import againСборка записывает обычные манифесты Kubernetes в dist/helm/ в корне рабочего пространства, source, что из helm является ../dist/helm/. Создайте два объекта Secrets в пространстве имён, к которому применяете, каждый со своим значением под ключом данных value, затем примените папку, как объясняет шаг запуска в Как выполняется импорт.