c552199eed
- Create /docs structure (microdao, daarion, agents) - Organize 61 cursor technical docs - Add README files for each category - Copy key documents to public categories - Add GitHub setup instructions and scripts
541 lines
17 KiB
Markdown
541 lines
17 KiB
Markdown
---
|
||
title: Agents Map — DAARION.city
|
||
version: 1.0.0
|
||
status: canonical
|
||
last_updated: 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
|
||
|
||
```text
|
||
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 або будь-який інший проект.*
|
||
|
||
|