microdao-daarion/docs/agents.md

title, version, status, last_updated

title	version	status	last_updated
Agents Map — DAARION.city	1.0.0	canonical	2024-11-14

Цей документ є актуальною картою всіх агентів у DAARION.city.
Інтегрується з microdao-architecture.md та ієрархією A1-A4.

Agents Map — DAARION.city

Консолідована карта всіх агентів екосистеми DAARION.city з ієрархією A1-A4

---

1. Overview

DAARION.city працює на багаторівневій системі агентів, організованих за ієрархією MicroDAO:

• A1 — DAARION.city (системні агенти, DAARWIZZ)
• A2 — Міські платформи (платформні агенти)
• A3 — Публічні MicroDAO (DAO-агенти)
• A4 — Приватні MicroDAO (приватні агенти)

Кожен рівень має своїх агентів з відповідними правами, пам'яттю та інтеграціями.

---

2. A1 — DAARION.city (Root Level Agents)

2.1 DAARWIZZ — System Orchestrator Agent

Роль: Головний системний агент міста, маршрутизатор та планувальник Swarm-OS

Призначення:

• Оркестрація DAGI (Distributed AI Grid)
• Роутинг запитів між моделями та агентами
• Multi-agent сценарії та планування
• Телеметрія та моніторинг якості

Агентські модулі:

• Router Agent — розподіляє запити між моделями та агентами
• Planner Agent — декомпозує задачі, запускає ланцюжки інструментів
• Observer/Telemetry Agent — відстежує якість, латентність, бюджет

Capabilities:

• router.invoke
• router.plan.run
• router.tool.call
• telemetry.events.write
• telemetry.events.read:aggregate

Доступ:

• Користувацькі microDAO отримують DAARWIZZ-keys через:
  • Wallet Agent (оплата DAAR / 1T)
  • План Platformium

---

2.2 City-Level Agents

City Governance Agent

• Міські правила, дух міста
• Governance proposals, voting, policies
• Інтеграція з AI Governance Agent (41_ai_governance_agent_design.md)

City Registry Agent

• Реєстр мешканців, громадянство
• Управління citizenship, рівнями доступу
• DAARION-статус та права

City Bridges Agent

• Зв'язки між city ↔ платформи ↔ microDAO
• Синхронізація подій між рівнями
• City events broadcast

City Co-Memory Agent

• Загальноміський простір знань
• City Knowledge Spaces (City.Ecology, City.Energy, City.Food, City.Governance)
• Публікація фактів від платформ у City Co-Memory

Second Me Agent

• Персональний цифровий двійник резидента
• Особистий контекст та пам'ять

Citizenship Agent

• Керує резидентством, рівнями доступу, DAARION-статусом
• Capabilities: citizenship.status.view, citizenship.level.upgrade

Gift Fabric Agent

• Відстежує акти взаємодії й відгук міста (MJD)
• Capabilities: gift.act.register

---

3. A2 — Platform Agents (Міські платформи)

Кожна платформа має власних агентів, які працюють на рівні платформи.

3.1 GREENFOOD Platform Agents

Warehouse Agent

• Облік партій/залишків
• Capabilities: platform.greenfood.inventory.view/update

Logistics Agent

• Маршрути та хаби
• Capabilities: platform.greenfood.shipment.create

Accounting Agent

• Автоматичні нарахування/розподіл по кооперативу
• Capabilities: platform.greenfood.coop.balance.view

Sales Agent

• Інтеграція з маркетплейсами
• Capabilities: platform.greenfood.member.register

Community Coordinator Agent

• Координація між учасниками спільноти

Embassy Integration:

• rwa.claim (сертифікати продуктів)
• rwa.stock.update (запаси на складах)

---

3.2 Energy Union Platform Agents

Metering Agent

• Читає лічильники генерації/споживання
• Capabilities: energy.meter.read

Oracle Agent

• Агрегує дані, формує виплати KWT/1T
• Capabilities: energy.payout.compute

Facility Agent

• Агент об'єкта (сонячна станція, дата-центр)
• Capabilities: energy.asset.read

Energy Market Agent

• Узгоджує акти енергетичного дарообміну
• Capabilities: wallet.payout.view/claim

Embassy Integration:

• embassy.energy.update
• embassy.rwa.claim (сертифікати енергетичних часток)

---

3.3 Water Union Platform Agents

Sensor Agent

• Збір даних з сенсорів (якість/об'єм води)
• Capabilities: water.sensor.read, water.sensor.update

Infrastructure Agent

• Стан насосів, резервуарів
• Capabilities: water.infrastructure.view

Community Water Agent

• Координація доступу громад, планування ремонтів

Water RWA Agent

• Сертифікати дару на водні ініціативи
• Capabilities: rwa.water.claim

---

3.4 Essence Stream Platform Agents

Curator Agent

• Формує програми, добирає контент
• Capabilities: essence.event.publish

Event Agent

• Події, квитки (як сертифікати дару)
• Capabilities: essence.event.register

Mentor Agent

• Персоналізовані навчальні траєкторії
• Capabilities: essence.course.view

Quest Agent

• Квести/ігрові сценарії в DAARION.city
• Capabilities: essence.quest.progress.update

---

3.5 Helion Platform Agents

Energy Production Agent

• Управління енергетичними об'єктами
• Моніторинг генерації

Energy Distribution Agent

• Розподіл енергії між споживачами
• Балансування навантаження

---

3.6 Soul Platform Agents

Social Graph Agent

• Управління соціальними зв'язками
• Рекомендації та мережі

Community Builder Agent

• Створення та координація спільнот
• Інтеграція з microDAO

---

3.7 Dario Platform Agents

City Services Agent

• Управління міськими сервісами
• Координація з міською інфраструктурою

---

3.8 Nutra Platform Agents

Health & Nutrition Agent

• Управління здоров'ям та нутрицією
• Персоналізовані рекомендації

---

4. A3 — Public MicroDAO Agents

Публічні MicroDAO мають стандартний набір агентів, доступних для всіх резидентів.

4.1 Team Assistant (Core Agent)

Призначення:

• Основний помічник команди
• Відповіді у спільних чатах
• Автоматичні підсумки
• Створення follow-ups
• Пропозиції задач

Capabilities:

• agent.run.invoke
• chat.message.send
• project.task.create
• followup.create

---

4.2 Messenger Agent

Призначення:

• Управління чатами та каналами
• Фільтрація та пошук повідомлень
• Розумні папки та огляди

Capabilities:

• chat.message.read
• chat.message.send
• channel.manage

---

4.3 Projects Agent

Призначення:

• Управління проєктами та задачами
• Канбан-дошки
• Авто-генерація тасок з діалогів

Capabilities:

• project.create
• project.manage
• task.create
• task.manage

---

4.4 Follow-ups & Reminders Agent

Призначення:

• Перетворення повідомлень на задачі
• Планування часу
• Нагадування

Capabilities:

• followup.create
• followup.remind

---

4.5 Co-Memory & Knowledge Space Agent

Призначення:

• Документи, wiki, нотатки
• RAG по документах та пам'яті
• Інтерфейс "покажи, що ми вже знаємо про X"

Capabilities:

• comemory.item.read
• comemory.item.write

---

4.6 Governance & Access Agent

Призначення:

• Голосування, пропозиції, кворум
• Зв'язок з 1T / RINGK / іншими токенами
• Train-to-Earn з точки зору агента

Capabilities:

• governance.proposal.create
• governance.vote.cast
• governance.policy.manage

---

4.7 Notifications & Attention Agent

Призначення:

• Які події важливі, які — ні
• Digest-и, дайджести, персональні огляди дня/тижня

Capabilities:

• notification.send
• attention.prioritize

---

4.8 Integrations & Bridges Agent

Призначення:

• Telegram / WhatsApp / email / календар
• Як мости працюють через агентську логіку
• Маршрутизація повідомлень і контексту

Capabilities:

• integration.bridge.create
• integration.message.route

---

5. A4 — Private MicroDAO Agents

Приватні MicroDAO мають повну автономію та можуть мати власних агентів.

5.1 Personal Agents

Призначення:

• Особистий супутник користувача
• Особистий контекст та пам'ять
• Приватні нотатки, документи, нагадування
• Приватний інтерфейс до DAGI

Права:

• Тільки personal_space
• Немає доступу до командних просторів без спеціального дозволу

Operator Mode:

• Може працювати як оператор лише в особистому просторі
• Обмежені інструменти: create_personal_note, create_personal_task, personal_digest

---

5.2 Private Team Agents

Призначення:

• Аналогічні до A3 агентів, але з обмеженим доступом
• Працюють тільки в межах приватного MicroDAO
• Не мають доступу до публічних даних

Особливості:

• Confidential mode за замовчуванням
• Обмежений доступ до LLM Proxy (тільки summary/embeddings)
• Немає публічного індексування

---

6. Agent Hierarchy & Integration

6.1 Hierarchy Flow

A1: DAARION.city
  ├── DAARWIZZ (System Orchestrator)
  ├── City Governance Agent
  ├── City Registry Agent
  ├── City Bridges Agent
  └── City Co-Memory Agent
      │
      ├── A2: Platforms
      │   ├── GREENFOOD Agents
      │   ├── Energy Union Agents
      │   ├── Water Union Agents
      │   └── Essence Stream Agents
      │
      ├── A3: Public MicroDAO
      │   ├── Team Assistant
      │   ├── Messenger Agent
      │   ├── Projects Agent
      │   └── ... (standard agents)
      │
      └── A4: Private MicroDAO
          ├── Personal Agents
          └── Private Team Agents

6.2 Integration Points

DAARWIZZ Integration:

• Всі агенти можуть використовувати DAARWIZZ для роутингу та планування
• Доступ через DAAR/1T оплату або Platformium план

PDP Integration:

• Всі агенти перевіряються через PDP для доступу до ресурсів
• Capability-based access control

Wallet Integration:

• Агенти можуть працювати з UTIL токенами
• Не можуть змінювати баланси DAAR/DAARION

Embassy Integration:

• Платформні агенти (A2) мають доступ до Embassy для RWA
• City-level агенти мають обмежений доступ до Embassy

---

7. Agent Memory & Context

7.1 Memory Scopes

A1 Agents:

• City-level memory (загальноміський контекст)
• Доступ до всіх платформ та публічних MicroDAO

A2 Agents:

• Platform-level memory (контекст платформи)
• Доступ до City Co-Memory для публікації фактів

A3 Agents:

• Team-level memory (контекст команди)
• Обмежений доступ до City Co-Memory

A4 Agents:

• Personal/Private memory (особистий/приватний контекст)
• Немає доступу до City Co-Memory

7.2 Confidential Mode

A4 Agents (Private MicroDAO):

• Confidential mode за замовчуванням
• LLM Proxy отримує тільки summary/embeddings
• Немає публічного індексування

A3 Agents (Public MicroDAO):

• Можуть мати confidential канали
• Обмежений доступ до plaintext у confidential каналах

---

8. Agent Capabilities Matrix

Agent Type	Router Access	Wallet Access	Embassy Access	City Co-Memory
DAARWIZZ	✅ Full	❌ No	❌ No	✅ Read/Write
City Agents	✅ Via DAARWIZZ	❌ No	⚠️ Limited	✅ Read/Write
Platform Agents	✅ Via DAARWIZZ	⚠️ UTIL only	✅ Full	✅ Publish
A3 Agents	✅ Via DAARWIZZ	⚠️ UTIL only	❌ No	⚠️ Read only
A4 Agents	✅ Via DAARWIZZ	⚠️ UTIL only	❌ No	❌ No

---

9. Agent Lifecycle

9.1 Creation

A1 Agents:

• Створюються при ініціалізації DAARION.city
• Системні агенти, не можуть бути видалені

A2 Agents:

• Створюються при реєстрації платформи
• Управляються платформою

A3/A4 Agents:

• Створюються через DAOFactory (1 DAAR або 0.01 DAARION)
• Управляються власниками MicroDAO

9.2 Configuration

Всі агенти налаштовуються через:

• Agent Config (роль, системний промпт, пам'ять)
• Capabilities (доступ до інструментів)
• Memory Scope (channel, team, global)

9.3 Updates

• Агенти можуть оновлюватися через Governance
• Еволюційні агенти можуть самонавчатися (з дозволу користувача)

---

10. Integration with Other Docs

Цей документ інтегрується з:

• microdao-architecture.md — архітектура MicroDAO (A1-A4)
• tokenomics/city-tokenomics.md — токеноміка та доступ
• cursor/12_agent_runtime_core.md — Agent Runtime Core
• cursor/13_agent_memory_system.md — Agent Memory System
• cursor/22_operator_modes_and_system_agents.md — System Agents
• cursor/38_private_agents_lifecycle_and_management.md — Private Agents
• cursor/41_ai_governance_agent_design.md — AI Governance Agent
• cursor/46_router_orchestrator_design.md — Router/Orchestrator
• DAARION_city_platforms_catalog.md — Платформи та їх агенти

---

11. Changelog

v1.0.0 — 2024-11-14

• Початкова версія карти агентів
• Додано DAARWIZZ як системний агент A1
• Додано City-level агенти
• Додано Platform Agents (A2)
• Додано Public MicroDAO Agents (A3)
• Додано Private MicroDAO Agents (A4)
• Додано Agent Hierarchy & Integration
• Додано Agent Capabilities Matrix

---

Версія: 1.0.0
Останнє оновлення: 2024-11-14
Документ готовий до інтеграції у Cursor, GitHub або будь-який інший проект.