Импорт чат-потока Flowise
Это пошаговое руководство импортирует чат-поток, экспортированный из Flowise, — цепочку диалога с чат-моделью и памятью, — в сущности Aggregate, Release и Manifest, которые в том виде, в каком они написаны, собирают Flowise с этим чат-потоком для Docker Compose, затем собирает их и запускает результат. Каждый файл и каждый блок вывода ниже взяты из реального запуска; чат-поток и каждый этап руководства находятся в примере import-flowise, где проверочный скрипт заново запускает импорт, сравнивает то, что он записывает, то, что он выводит, и блоки, которые цитирует эта страница, с хранящимися там файлами, а также проверяет и собирает то, что записал импорт.
Создание примера
Этот импорт можно выполнить командами с этой страницы или поручить его вашему ИИ-ассистенту.
Запишите пример в новую папку, названную по его имени:
aggrega scaffold --example import-flowiseЗатем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку; следующая, ниже, переходит в её папку source, в которой выполняется импорт. Эта папка содержит файл chatflow, support-chat.json, который эта страница описывает, а не цитирует:
cd import-flowise
Чат-поток
support-chat.json, написанный для этого руководства в том виде, в каком редактор Flowise экспортирует чат-поток, содержит три узла и два ребра между ними: узел ChatOpenAI, выбирающий gpt-4o-mini, узел Buffer Memory и узел Conversation Chain, который принимает оба и отвечает коротким системным сообщением. Узел ChatOpenAI не выбирает никаких сохранённых учётных данных и оставляет свой Base Path пустым, поэтому клиент OpenAI, на котором Flowise его запускает, считывает свой адрес и ключ из окружения Flowise.
Рядом с чат-потоком файл .aggrega-config.yaml делает папку рабочим пространством:
# The workspace key marks this directory as the workspace root, so an import run# here writes its drafts beside support-chat.json.workspace: {}# The registry the importer is fetched from the first time an import needs it.default_registry: hub.aggrega.aiа import-answers.yaml содержит ответы на то, чего не может содержать ни один чат-поток. Flowise не загружает чат-поток из файла при запуске, поэтому сборка загружает его через собственный API Flowise под учётной записью владельца, и ни один экспорт эту учётную запись не называет: её адрес электронной почты — единственный ответ, который нужен импорту для Docker Compose. Импорту для Kubernetes также нужно имя Kubernetes Secret, хранящего каждый секрет, — пароль владельца и ключ OpenAI, — поэтому файл называет и эти два 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: # Email address of the platform's owner account, read only when values.flow_definition is set. The # step that seeds the chatflow registers this account when the instance has no owner yet, which makes # it the owner, and signs in as it; on an instance that already has one, it names an account allowed # to import chatflows, and the password attached to the owner_password slot is that account's. # Required when values.flow_definition is set: the build halts when it is empty. It has no default. spec.components.flowise.infra.owner_email: "owner@example.com" # 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.flowise.features.owner_password.infra.origin: "flowise-owner" # 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.flowise.uses.model.chatopenai-0.features.credential.infra.origin: "openai-api-key"owner@example.com обозначает ваш собственный адрес электронной почты. Без этого файла импорт в терминале запрашивает каждое значение, по одному вопросу за раз, сформулированному по описанию над его ключом, и записывает ваши ответы в новый файл ответов; там, где ничего нельзя спросить, он записывает этот файл с ключами и пустыми ответами, выводит их список и завершается со статусом 1. Файл ответов импорта описывает этот файл полностью.
Импорт оценивает каждый узел относительно сущностей Components из каталога рабочего пространства, а --target создаёт черновик сущности Manifest из сущностей Recipes этого каталога. Рабочее пространство не указывает ни одной папки каталога, поэтому импорт читает каталог стандартной библиотеки из реестра, из которого получает свой импортёр: подписанный снимок опубликованного каталога, который первый импорт получает, проверяет и сохраняет в кэше содержимого рабочего пространства и который запись, создаваемая импортом рядом с черновиками, называет по его дайджесту. Рабочее пространство, указывающее собственные папки каталога — в AGGREGA_CATALOG_DIRS или в workspace.catalog_dirs, — вместо этого импортирует на их основе. Перейдите в source:
cd sourceЗапуск импорта
aggrega import support-chat.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 flowise format, with drafted paths relative to <workspace>warn: node chatOpenAI_0 reaches chatopenai-0 through the model connection chatopenai-0 of core/ai-agent/flowise: its Base Path is empty, so the OpenAI client Flowise runs it on reads the address the platform delivers for this connection, OPENAI_BASE_URL, and, since it selects no credential, the key delivered as OPENAI_API_KEYinfo: the answers file <workspace>/import-answers.yaml also answers spec.components.flowise.features.owner_password.infra.origin in release.yaml, spec.components.flowise.uses.model.chatopenai-0.features.credential.infra.origin in release.yaml, which these drafts do not leave empty; those answers are kept there and not appliedmapped chatOpenAI_0 (chatOpenAI) to core/ai-model/openai as a reference, HIGH at 0.9made no choice for bufferMemory_0 (bufferMemory)made no choice for conversationChain_0 (conversationChain) warning: node "flowise" (provider "compose"): artifact "flowise-flow/flowise-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означает, что узел ChatOpenAI стал моделью OpenAI из стандартной библиотеки,core/ai-model/openai, на которую ссылаются, а не создают черновик, поскольку он совпал на высоком уровне, с оценкой 0.9: отдельный компонент, подключённый к сокетуmodelплатформы. - Строка
warnобъясняет, как чат-поток достигает этой модели: узел считывает адрес и ключ, которые платформа предоставляет для соединения с моделью, поэтому ключ, который сущность Release прикрепляет к соединению, и есть тот ключ, который использует чат-поток. - Строка
infoотносится к файлу ответов. Файл дал адрес электронной почты владельца, который черновики оставили пустым; два имени Secret в нём отвечают на то, что пустым оставляет только импорт для Kubernetes, поэтому они остаются в файле и здесь не используются. - Строки
made no choiceозначают, что память и цепочка остаются внутри чат-потока: ни один сокет платформы их не принимает. - Последние две строки — это pull. Поскольку на каждое значение дан ответ, импорт загрузил зависимости черновика сущности Release, как это делает
aggrega pull, и записалrelease.lock; сборке ниже больше ничего не нужно. Строкуwarningвыводит и сборка, а Валидация и сборка её объясняет.
Что он записывает
Сущности Aggregate, Release и Manifest получают имя imported/support-chat по файлу, support-chat.json, так как экспорт Flowise не несёт собственного имени, в пространстве имён, которое задаёт настройка target_namespace импортера, то есть imported, если вы не зададите другое (Настройки).
aggregate.yaml — один экземпляр платформы Flowise из стандартной библиотеки, core/ai-agent/flowise, несущий чат-поток в том виде, в каком он был экспортирован (большая часть здесь опущена), и модель, подключённую к её сокету model:
apiVersion: aggrega.ai/v1beta1kind: Aggregatemetadata: name: imported/support-chat version: 0.1.0 description: Draft Aggregate imported from a source in the flowise format.spec: components: flowise: type: core/ai-agent/flowise features: # For the compose target, the lines below declare owner_password on flowise: 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. owner_password: type: core/secret-value values: key: OWNER_PASSWORD values: # chatflow_id is derived from the exported flow, which gives no identifier of its own. chatflow_id: '40d9f5c5-5187-54c1-a9f5-a8dac92f88bb' flow_definition: | { "nodes": [ [… omitted: the chatflow's nodes, as exported, up to the Conversation Chain's inputs] "inputs": { "model": "{{"{{"}}chatOpenAI_0.data.instance}}", "memory": "{{"{{"}}bufferMemory_0.data.instance}}", [… omitted: the rest of the chatflow, as exported] } uses: model: chatopenai-0: target: chatopenai-0 # For the compose target, the lines below declare credential on chatopenai-0: 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 chatopenai-0: type: core/ai-model/openai values: model: |- gpt-4o-mini- Модель — это
core/ai-model/openaiс моделью, которую выбирает узел,gpt-4o-mini. Комментарий над ней называет другую сущность Component из каталога, на которую похож узел, вместе с её оценкой. - Два секрета — пароль учётной записи владельца, под которой загружается чат-поток, и ключ OpenAI, который платформа предъявляет модели, — объявлены здесь вместе с переменной, под которой каждый поступает в окружение Flowise,
OWNER_PASSWORDиOPENAI_API_KEY. В Docker Compose секрет, прикреплённый только сущностью Release, поступил бы под ключомvalue, и два секрета столкнулись бы; объявленный здесь, каждый имеет собственный ключ. Сущность Release указывает, откуда поступает каждый. chatflow_idвыводится из чат-потока, поскольку экспорт из редактора Flowise не несёт собственного идентификатора, поэтому один чат-поток всегда даёт один идентификатор. Чат-поток Flowise записывает{{<node id>.data.instance}}для каждого соединения между двумя узлами, а текст сущности Aggregate читается как шаблон, поэтому черновик записывает каждое{{как{{"{{"}}, что сборка превращает обратно в две фигурные скобки.
release.yaml — сущность Release, которая развёртывает сущность Aggregate с сущностью Manifest:
apiVersion: aggrega.ai/v1beta1kind: Releasemetadata: name: imported/support-chat # 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 flowise format.spec: aggregate: imported/support-chat manifest: imported/support-chat components: flowise: infra: # The image running core/ai-agent/flowise, 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. image: "flowiseai/flowise:3.1.3" # Left for the Release, since the source cannot supply it: infra.owner_email, the email address of the platform's owner account, required while values.flow_definition is set owner_email: "owner@example.com" # 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: 3000 features: owner_password: type: core/secret-value infra: # Attached by reference, never as a value: the owner account's password, required while values.flow_definition is set, read from the variable FLOWISE_OWNER_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: "${FLOWISE_OWNER_PASSWORD}" uses: model: chatopenai-0: features: credential: type: core/secret-value infra: # Attached by reference, never as a value: the credential flowise presents to chatopenai-0 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}" chatopenai-0: {}environmentимеет значениеdevelopment— значение по умолчанию, которое, как говорит комментарий над ним, следует заменить на среду, в которую развёртывается сущность Release.- Образ — Flowise 3.1.3, версия, которую запускают сущности Recipes из каталога для Flowise.
published_portравен 3000, порту, на котором работает Flowise, поэтому он отвечает по адресуhttp://127.0.0.1:3000на вашей машине. Как сказано в его комментарии, любой процесс на этой машине может обратиться к нему там, а ничто другое не может; удалите строку, чтобы оставить Flowise только в сети стека.owner_email— ответ из файла ответов. Комментарий над ним объясняет, почему импорт не смог создать для него черновик.- Два секрета — это ссылки на переменные,
${FLOWISE_OWNER_PASSWORD}и${OPENAI_API_KEY}, которые Docker Compose заполняет из вашей оболочки при запуске стека, поэтому ни один файл не содержит ни одного из этих значений.
manifest.yaml — сущности Recipes для Compose для платформы и модели, а также реализация, которая записывает ссылку на переменную секрета в файл Compose как есть:
apiVersion: aggrega.ai/v1beta1kind: Manifestmetadata: name: imported/support-chat version: 0.1.0spec: mappings: components: type: core/ai-agent/flowise: compose/flowise 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 "flowise" (provider "compose"): artifact "flowise-flow/flowise-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 содержит два сервиса. Сам Flowise:
flowise: image: flowiseai/flowise:3.1.3 environment: DATABASE_PATH: /home/node/.flowise SECRETKEY_PATH: /home/node/.flowise OPENAI_BASE_URL: https://api.openai.com/v1 OPENAI_API_KEY: ${OPENAI_API_KEY} ports: - 127.0.0.1:3000:3000 [… 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: flowise--data target: /home/node networks: - compose [… omitted: the service's health check]и сервис, который загружает чат-поток, как только Flowise сообщит о работоспособном состоянии, а затем завершается:
flowise-flow-seed: image: flowiseai/flowise:3.1.3 entrypoint: - node - /seed/seed.js environment: FLOWISE_URL: http://127.0.0.1:3000 OWNER_EMAIL: owner@example.com OWNER_PASSWORD: ${FLOWISE_OWNER_PASSWORD} CHATFLOW_ID: 40d9f5c5-5187-54c1-a9f5-a8dac92f88bb CHATFLOW_NAME: 40d9f5c5-5187-54c1-a9f5-a8dac92f88bb [… omitted: the labels the build writes on every service] network_mode: service:flowise depends_on: flowise: condition: service_healthy restart: "no" configs: - source: flowise-flow target: /seed/flow.json - source: flowise-flow-seed target: /seed/seed.jsОн регистрирует учётную запись владельца в новом экземпляре Flowise или входит под ней и записывает чат-поток по chatflow_id. Ключ и пароль — это ссылки на переменные, которые заполняются из вашей оболочки при запуске стека. Сущность Recipe Compose для Flowise публикует порт на вашей машине, только если сущность Release задаёт published_port в infra Flowise, и тогда только на адресе обратной петли 127.0.0.1; без этого сервис доступен только в сети стека.
С ИИ-ассистентом
ИИ-ассистент, настроенный с инструментами Aggrega, может сделать то же самое: вставьте в него этот промпт.
Используйте только инструменты Aggrega и не создавайте папок самостоятельно. Если папка Workspace ещё не содержит папку `import-flowise`, вызовите один раз инструмент `scaffold` с `example`, равным `import-flowise`, и без `dir`: он записывает пример в новую папку `import-flowise`, папка `source` которой содержит то, что импортирует эта страница. Затем вызовите инструмент `import` с `workspace_root`, равным `import-flowise/source`, `source`, равным `support-chat.json`, и `target`, равным `compose`: он читает нужные ему ответы из `import-answers.yaml` рядом с `support-chat.json`, записывает свои черновики в `import-flowise/source` и загружает то, что им нужно. Затем вызовите инструмент `validate` с `workspace_root`, равным `import-flowise/source`, и `release`, равным `release.yaml`, и инструмент `build` с `workspace_root`, равным `import-flowise/source`, `release`, равным `release.yaml`, и `write`, равным true. Сообщите мне, какие файлы записала сборка; они находятся в `import-flowise/source/dist/`.Открытие в VS Code
С установленным расширением Aggrega для Visual Studio Code откройте в VS Code папку import-flowise/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 описывает остальное.
Запуск
Задайте ключ и пароль владельца в своей оболочке, запустите Flowise, а затем запустите сервис начального заполнения:
export OPENAI_API_KEY='your OpenAI key'export FLOWISE_OWNER_PASSWORD='a password of your own'docker compose -p support-chat -f dist/compose/docker-compose.yaml up -d --wait flowisedocker compose -p support-chat -f dist/compose/docker-compose.yaml up flowise-flow-seed-p задаёт имя проекта, как объясняет шаг запуска в разделе Как выполняется импорт. --wait возвращает управление, как только Flowise сообщит, что он работоспособен; он называет только flowise, потому что считает сбоем любой завершившийся контейнер, а сервис начального заполнения завершается по замыслу. Вторая команда запускает сервис начального заполнения, выводит его журнал и возвращает управление, когда он завершится:
flowise-flow-seed-1 | registered the owner account owner@example.comflowise-flow-seed-1 | imported chatflow 40d9f5c5-5187-54c1-a9f5-a8dac92f88bb as "40d9f5c5-5187-54c1-a9f5-a8dac92f88bb"flowise-flow-seed-1 exited with code 0Если другая программа на вашей машине уже слушает 127.0.0.1:3000, первая команда останавливается с failed to bind host port 127.0.0.1:3000/tcp: address already in use: задайте для published_port свободный порт и выполните сборку снова. Запуск ниже так и сделал, с портом 3002, и использовал этот порт вместо 3000.
Тестирование
Откройте http://127.0.0.1:3000, адрес, который публикует published_port, и войдите с адресом электронной почты и паролем владельца: чат-поток из начального заполнения находится во Flowise.
Чат-поток, который не задаёт собственного ключа API, отвечает на своей конечной точке предсказаний без ключа. Задайте ему вопрос:
curl -sS -X POST http://127.0.0.1:3000/api/v1/prediction/40d9f5c5-5187-54c1-a9f5-a8dac92f88bb \ -H 'Content-Type: application/json' -d '{"question": "In one short sentence: what is Docker Compose?"}'Запуск использовал заполнитель для ключа OpenAI, поэтому ответом является отказ OpenAI принять его, что показывает, что чат-поток выполнился вплоть до вызова модели:
{"statusCode":500,"success":false,"message":"401 Unauthorized – check your API key and ensure it has access to the requested model.","stack":{}}С вашим ключом ответ содержит результат в text.
В Kubernetes, когда сборка, описанная в В Kubernetes, применена и её Job начального заполнения завершён, перенаправьте локальный порт на Service Flowise, flowise-default, в пространстве имён, к которому вы применяли, и оставьте команду запущенной:
kubectl port-forward -n <namespace> svc/flowise-default 3000:3000Из другого терминала приведённый выше вопрос доходит до чат-потока по тому же адресу без изменений; запуск получил тот же отказ для ключа-заполнителя.
Остановите стек приведённой ниже командой. -v также удаляет том данных Flowise, а вместе с ним учётную запись владельца и chatflow, записанный сервисом начального заполнения:
docker compose -p support-chat -f dist/compose/docker-compose.yaml down -vВ Kubernetes
Тот же чат-поток импортируется для Kubernetes с целью helm. Черновики для Docker Compose уже лежат в source, а импорт никогда не перезаписывает находящуюся там сущность Aggregate, поэтому создайте эти черновики в отдельной папке с помощью --output-dir, затем валидируйте и собирайте из неё:
aggrega import support-chat.json --target helm --output-dir helmcd helmaggrega validate --release release.yamlaggrega build --release release.yamlЧерновики различаются там, где различается цель. Сущность Manifest сопоставляет платформу с helm/flowise, модель — с helm/openai, а каждый секрет — с helm/k8s-existing-secret, который читает его из объекта Secret, уже существующего в пространстве имён. Сущность Release прикрепляет пароль владельца и ключ OpenAI как core/referenced-secret, каждый из которых называет свой Secret, и берёт все три ответа из файла ответов: адрес электронной почты владельца, flowise-owner и openai-api-key.
Сборка записывает обычные манифесты Kubernetes в dist/helm/ в корне рабочей области, source, что из helm является ../dist/helm/, среди них seed chatflow в виде Job. Создайте два объекта Secret в пространстве имён, к которому применяете, каждый со своим значением под ключом данных value, затем примените папку, как объясняет шаг запуска в Как выполняется импорт.