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

Импорт чат-потока Flowise

Это пошаговое руководство импортирует чат-поток, экспортированный из Flowise, — цепочку диалога с чат-моделью и памятью, — в сущности Aggregate, Release и Manifest, которые в том виде, в каком они написаны, собирают Flowise с этим чат-потоком для Docker Compose, затем собирает их и запускает результат. Каждый файл и каждый блок вывода ниже взяты из реального запуска; чат-поток и каждый этап руководства находятся в примере import-flowise, где проверочный скрипт заново запускает импорт, сравнивает то, что он записывает, то, что он выводит, и блоки, которые цитирует эта страница, с хранящимися там файлами, а также проверяет и собирает то, что записал импорт.

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

Этот импорт можно выполнить командами с этой страницы или поручить его вашему ИИ-ассистенту.

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

Terminal window
aggrega scaffold --example import-flowise

Затем она выводит команды, которые нужно выполнить дальше. Первая переходит в новую папку; следующая, ниже, переходит в её папку source, в которой выполняется импорт. Эта папка содержит файл chatflow, support-chat.json, который эта страница описывает, а не цитирует:

Terminal window
cd import-flowise

Папка source сгенерированного примера, открытая в Visual Studio Code, с экспортом chatflow Flowise чата поддержки, открытым на узле ChatOpenAI.

Чат-поток

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:

Terminal window
cd source

Запуск импорта

Terminal window
aggrega import support-chat.json --target compose

В стандартный вывод он выводит список записанного:

wrote aggregate.yaml
wrote release.yaml
wrote manifest.yaml
wrote .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_KEY
info: 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 applied
mapped chatOpenAI_0 (chatOpenAI) to core/ai-model/openai as a reference, HIGH at 0.9
made 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)

Импорт, запущенный из редактора: черновики сущностей Aggregate, Release и Manifest появляются рядом с экспортом chatflow, вывод Aggrega перечисляет, как сопоставлен каждый узел, и записанные файлы, а уведомление сообщает, что импорт создал черновики 3 файлов, распознанных как flowise.

  • Строка 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/v1beta1
kind: Aggregate
metadata:
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/v1beta1
kind: Release
metadata:
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/v1beta1
kind: Manifest
metadata:
name: imported/support-chat
version: 0.1.0
spec:
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, по версии и дайджесту.

Проверка и сборка

Terminal window
aggrega validate --release release.yaml
aggrega build --release release.yaml

Черновик сущности Release, открытый в редакторе после валидации; вывод Aggrega и уведомление сообщают, что проблем не найдено.

Сборка черновика сущности Release: в проводнике появляется папка dist, вывод Aggrega перечисляет записанный файл Docker Compose, а уведомление сообщает, что записан 1 файл.

Проверка выводит:

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

Terminal window
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 flowise
docker 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.com
flowise-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, отвечает на своей конечной точке предсказаний без ключа. Задайте ему вопрос:

Terminal window
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, в пространстве имён, к которому вы применяли, и оставьте команду запущенной:

Terminal window
kubectl port-forward -n <namespace> svc/flowise-default 3000:3000

Из другого терминала приведённый выше вопрос доходит до чат-потока по тому же адресу без изменений; запуск получил тот же отказ для ключа-заполнителя.

Остановите стек приведённой ниже командой. -v также удаляет том данных Flowise, а вместе с ним учётную запись владельца и chatflow, записанный сервисом начального заполнения:

Terminal window
docker compose -p support-chat -f dist/compose/docker-compose.yaml down -v

В Kubernetes

Тот же чат-поток импортируется для Kubernetes с целью helm. Черновики для Docker Compose уже лежат в source, а импорт никогда не перезаписывает находящуюся там сущность Aggregate, поэтому создайте эти черновики в отдельной папке с помощью --output-dir, затем валидируйте и собирайте из неё:

Terminal window
aggrega import support-chat.json --target helm --output-dir helm
cd helm
aggrega validate --release release.yaml
aggrega 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, затем примените папку, как объясняет шаг запуска в Как выполняется импорт.