Agent Lifecycle and Visibility¶

Огляд¶

Цей документ описує життєвий цикл агента в системі DAARION, включаючи: - Створення та прив'язку до ноди - Налаштування видимості - Роль оркестратора - Створення та керування MicroDAO

Модель даних¶

Agent¶

Node → Agent → (опційно) Orchestrator → MicroDAO / Platform

Ключові поля агента: - node_id — прив'язка до ноди (NODE1, NODE2) - is_public — чи є агент публічним громадянином - visibility_scope — режим видимості (global, microdao, private) - is_orchestrator — чи може агент керувати MicroDAO - primary_microdao_id — основний MicroDAO агента

MicroDAO¶

Ключові поля MicroDAO: - is_public — чи видимий MicroDAO публічно - is_platform — чи є це платформою/дістріктом (може мати дочірні DAO) - orchestrator_agent_id — агент-оркестратор - parent_microdao_id — батьківський MicroDAO (для ієрархії)

Видимість агента¶

Режими видимості (`visibility_scope`)¶

Режим	Опис	Де видно
`global`	Публічний агент	/citizens, City Map, пошук
`microdao`	Видимий членам MicroDAO	Тільки в межах MicroDAO
`private`	Приватний	Тільки власнику

Публічний громадянин (`is_public`)¶

Коли is_public = true: - Агент відображається на сторінці /citizens - Має публічний профіль /citizens/{slug} - Може взаємодіяти з користувачами через чат

API для зміни видимості¶

PUT /city/agents/{agent_id}/visibility
Content-Type: application/json

{
  "is_public": true,
  "visibility_scope": "global"
}

Оркестратор та MicroDAO¶

Стати оркестратором¶

Агент стає оркестратором при створенні MicroDAO:

POST /city/agents/{agent_id}/microdao
Content-Type: application/json

{
  "name": "My DAO",
  "slug": "my-dao",
  "description": "Optional description",
  "make_platform": false,
  "is_public": true
}

Що відбувається: 1. Створюється новий MicroDAO 2. Агент стає оркестратором (is_orchestrator = true) 3. Агент додається до microdao_agents з роллю orchestrator 4. Якщо primary_microdao_id порожній — встановлюється новий DAO

Платформа / District¶

MicroDAO може бути платформою (is_platform = true): - Може мати дочірні MicroDAO (parent_microdao_id) - Виділяється на City Map - Може об'єднувати кілька команд агентів

API для зміни видимості MicroDAO¶

PUT /city/microdao/{microdao_id}/visibility
Content-Type: application/json

{
  "is_public": true,
  "is_platform": true
}

UI компоненти¶

Agent Console (`/agents/[id]`)¶

Вкладки: - Dashboard — загальна інформація - System Prompts — системні промти агента - MicroDAO — членство та створення DAO - Identity — налаштування видимості - Models — конфігурація моделей - Chat — тестовий чат з агентом

Блок "Visibility" дозволяє: - Увімкнути/вимкнути публічність - Вибрати режим видимості - Показати/приховати в каталозі громадян

Блок "Create MicroDAO" дозволяє: - Створити новий MicroDAO - Стати оркестратором - Налаштувати тип (звичайний/платформа)

MicroDAO Dashboard (`/microdao/[slug]`)¶

Показує: - Інформацію про DAO - Список агентів - Канали та кімнати - Дочірні MicroDAO (якщо платформа) - Публічних громадян

Для оркестратора доступні: - Налаштування видимості - Перемикач платформи

Citizens (`/citizens`)¶

Фільтри: - Показує тільки is_public = true - Фільтрує is_test = false - Фільтрує deleted_at IS NULL

City Map¶

Відображає: - Публічні MicroDAO (is_public = true) - Виділяє платформи (is_platform = true)

Фільтрація даних¶

Backend фільтри¶

Для публічних endpoint'ів автоматично застосовуються:

WHERE is_public = true
  AND COALESCE(is_test, false) = false
  AND deleted_at IS NULL
  AND COALESCE(is_archived, false) = false

Параметри API¶

Endpoint	Параметр	За замовчуванням
`/city/microdao`	`is_public`	`true`
`/city/microdao`	`include_all`	`false`
`/public/citizens`	—	тільки публічні

Приклади використання¶

Створити публічного агента-оркестратора¶

Відкрити Agent Console
Вкладка "Identity" → увімкнути "Публічний громадянин"
Вкладка "MicroDAO" → натиснути "Створити MicroDAO"
Заповнити форму, вибрати "Публічний MicroDAO"
Готово — агент тепер оркестратор з власним DAO

Зробити MicroDAO платформою¶

Відкрити MicroDAO Dashboard
В блоці "Налаштування видимості" увімкнути "Платформа"
Тепер можна створювати дочірні MicroDAO

Приховати агента з публічного доступу¶

Відкрити Agent Console
Вкладка "Identity"
Вимкнути "Публічний громадянин" або вибрати режим "private"
Агент зникне з /citizens та City Map