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
350 lines
11 KiB
Markdown
350 lines
11 KiB
Markdown
# 24 — Agent Cards and Console Tasks (MicroDAO)
|
||
|
||
Структурований список задач для реалізації Agent Cards та Console
|
||
|
||
Цей документ містить детальні технічні задачі для поетапної реалізації системи карток агентів та Agent Console.
|
||
|
||
**Базовий документ:** `23_agent_cards_and_console.md`
|
||
|
||
---
|
||
|
||
# Task 1 — Agent-Cards-Grid (плитки агентів)
|
||
|
||
## Мета
|
||
|
||
Створити компонент AgentCard та AgentGrid для відображення агентів у вигляді "живих карток" з метриками досвіду, репутації та присутності.
|
||
|
||
## Специфікація
|
||
|
||
### 1. Компонент AgentCard
|
||
|
||
* Розмір: 280x360px (рекомендовано)
|
||
* Структура:
|
||
|
||
* Верхній блок: Аватар + відео-аватар (64x64px)
|
||
* Імʼя та роль
|
||
* Метрики: Вік, Досвід 1T, Репутація
|
||
* Присутність: бейджі каналів/проєктів
|
||
* Статус підключення
|
||
|
||
### 2. Компонент AgentGrid
|
||
|
||
* Сітка карток (responsive: 1-4 колонки)
|
||
* Фільтри: "Всі", "Підключені", "Доступні"
|
||
* Пошук по імені/ролі
|
||
|
||
### 3. Дані
|
||
|
||
* API: `GET /agents?team_id=...`
|
||
* Метрики: `GET /agents/{id}/metrics`
|
||
* Присутність: `GET /agents/{id}/presence`
|
||
|
||
### 4. Hover ефект
|
||
|
||
* Напівпрозорий оверлей з кнопками:
|
||
* "Почати взаємодію"
|
||
* "Підключити до каналу"
|
||
* "Деталі агента"
|
||
|
||
### 5. Клік
|
||
|
||
* Відкриває Agent Console (Task 2)
|
||
|
||
## Acceptance Criteria
|
||
|
||
* Картки агентів відображаються у сітці
|
||
* Показуються метрики (вік, 1T, репутація)
|
||
* Hover показує опції взаємодії
|
||
* Клік відкриває Agent Console
|
||
* Фільтри та пошук працюють
|
||
|
||
## Приклад промта для Cursor
|
||
|
||
```
|
||
Implement Agent Cards Grid using:
|
||
|
||
- 23_agent_cards_and_console.md
|
||
- 10_agent_ui_system.md
|
||
- 05_coding_standards.md
|
||
|
||
Deliverables:
|
||
|
||
1) AgentCard component with avatar, name, role, metrics (age, 1T, reputation).
|
||
2) AgentGrid component with responsive layout (1-4 columns).
|
||
3) Hover overlay with action buttons.
|
||
4) Filters: All / Connected / Available.
|
||
5) Search by name/role.
|
||
|
||
Output: list of files + diff + summary.
|
||
```
|
||
|
||
---
|
||
|
||
# Task 2 — Agent-Console-UI (повний інтерфейс)
|
||
|
||
## Мета
|
||
|
||
Створити Agent Console — повний інтерфейс для взаємодії з агентом з 5 вкладками.
|
||
|
||
## Специфікація
|
||
|
||
### 1. Структура Agent Console
|
||
|
||
* Верхня панель: Аватар, імʼя, метрики
|
||
* Вкладки: Чат, Файли, Памʼять, Присутність, Еволюція
|
||
* Контент вкладок (деталі нижче)
|
||
|
||
### 2. Вкладка "Чат"
|
||
|
||
* Використовує `AgentChatWindow` з `10_agent_ui_system.md`
|
||
* Додатково: кнопка "Голосовий діалог" (stub для MVP)
|
||
* Показ поточного контексту
|
||
|
||
### 3. Вкладка "Файли та Документи"
|
||
|
||
* Список файлів (з API або stub)
|
||
* Кнопка "Завантажити файл"
|
||
* Індикатор: "Документи зберігаються в просторі вашої microDAO"
|
||
|
||
### 4. Вкладка "Памʼять і Знання"
|
||
|
||
* Використовує компоненти з `13_agent_memory_system.md`
|
||
* Короткострокова та довгострокова памʼять
|
||
* Кнопки управління памʼяттю
|
||
|
||
### 5. Вкладка "Присутність / Права доступу"
|
||
|
||
* Таблиця просторів (канали, проєкти)
|
||
* Перемикачі підключення
|
||
* Рівні доступу
|
||
* Кнопка "Додати до нового каналу/проєкту"
|
||
|
||
### 6. Вкладка "Еволюція та дух спільноти"
|
||
|
||
* Лог внеску агента
|
||
* Статистика запитів
|
||
* Репутація від спільноти
|
||
* Без фінансових термінів
|
||
|
||
## Acceptance Criteria
|
||
|
||
* Agent Console відкривається при кліку на картку
|
||
* Всі 5 вкладок працюють
|
||
* Чат інтегрований з Agent Runtime Core
|
||
* Файли показуються (stub дані OK)
|
||
* Памʼять інтегрована з Memory System
|
||
* Присутність показує реальні дані
|
||
* Еволюція показує лог (stub OK)
|
||
|
||
## Приклад промта для Cursor
|
||
|
||
```
|
||
Implement Agent Console UI using:
|
||
|
||
- 23_agent_cards_and_console.md
|
||
- 10_agent_ui_system.md
|
||
- 13_agent_memory_system.md
|
||
- 12_agent_runtime_core.md
|
||
- 05_coding_standards.md
|
||
|
||
Deliverables:
|
||
|
||
1) AgentConsole component with 5 tabs.
|
||
2) Chat tab: integrate AgentChatWindow.
|
||
3) Files tab: file list + upload button (stub).
|
||
4) Memory tab: integrate memory components.
|
||
5) Presence tab: table with connect/disconnect toggles.
|
||
6) Evolution tab: log display (stub data OK).
|
||
|
||
Output: list of files + diff + summary.
|
||
```
|
||
|
||
---
|
||
|
||
# Task 3 — Agent-Experience-Metrics (1T + репутація)
|
||
|
||
## Мета
|
||
|
||
Реалізувати систему метрик досвіду агентів: вік, досвід 1T, репутація спільноти.
|
||
|
||
## Специфікація
|
||
|
||
### 1. Вік агента
|
||
|
||
* Розрахунок: `created_at` до поточної дати
|
||
* Формат: "3 тижні", "6 місяців", "1 рік 2 місяці"
|
||
* API: `GET /agents/{id}/metrics` → `{ age: { weeks, months, years } }`
|
||
|
||
### 2. Досвід 1T
|
||
|
||
* Лічильник: велике число з розділювачами (12 340 1T)
|
||
* Tooltip: "1T — це внутрішня одиниця обчислень і досвіду агента"
|
||
* API: `GET /agents/{id}/metrics` → `{ experience1T: number }`
|
||
* Візуалізація: великий текст з іконкою
|
||
|
||
### 3. Репутація спільноти
|
||
|
||
* Шкала: 0-100 або 0-5 зірок
|
||
* Розрахунок: на основі фідбеку від учасників
|
||
* API: `GET /agents/{id}/metrics` → `{ reputation: { score, type } }`
|
||
* Візуалізація: прогрес-бар або зірки
|
||
|
||
### 4. Компонент AgentMetrics
|
||
|
||
```tsx
|
||
interface AgentMetricsProps {
|
||
agentId: string;
|
||
compact?: boolean; // для картки vs консолі
|
||
}
|
||
|
||
export function AgentMetrics({ agentId, compact }: AgentMetricsProps) {
|
||
// Відображення метрик
|
||
}
|
||
```
|
||
|
||
## Acceptance Criteria
|
||
|
||
* Вік агента розраховується правильно
|
||
* 1T показується з tooltip
|
||
* Репутація відображається візуально
|
||
* Метрики оновлюються при зміні даних
|
||
|
||
## Приклад промта для Cursor
|
||
|
||
```
|
||
Implement Agent Experience Metrics using:
|
||
|
||
- 23_agent_cards_and_console.md
|
||
- 03_api_core_snapshot.md
|
||
- 05_coding_standards.md
|
||
|
||
Deliverables:
|
||
|
||
1) Calculate agent age from created_at.
|
||
2) Display 1T experience with tooltip explanation.
|
||
3) Display reputation (0-100 scale or 0-5 stars).
|
||
4) AgentMetrics component for reuse in Card and Console.
|
||
5) API integration: GET /agents/{id}/metrics.
|
||
|
||
Output: list of files + diff + summary.
|
||
```
|
||
|
||
---
|
||
|
||
# Task 4 — Agent-Connections-Toggles (підключення/відключення)
|
||
|
||
## Мета
|
||
|
||
Реалізувати управління підключеннями агентів до просторів (канали, проєкти) з перемикачами.
|
||
|
||
## Специфікація
|
||
|
||
### 1. На картці агента
|
||
|
||
* Бейджі: "Публічні простори: 2", "Конфіденційні: 1"
|
||
* При кліку — модалка зі списком просторів
|
||
* Перемикачі для кожного простору
|
||
|
||
### 2. У Agent Console (вкладка "Присутність")
|
||
|
||
* Таблиця просторів:
|
||
* Простір / Тип / Доступ / Статус / Дії
|
||
* Перемикач "Підключено/Відʼєднано"
|
||
* Кнопка "Додати до нового простору"
|
||
|
||
### 3. API
|
||
|
||
* `GET /agents/{id}/presence` → список просторів
|
||
* `POST /agents/{id}/presence/connect` → підключити
|
||
* `POST /agents/{id}/presence/disconnect` → відключити
|
||
|
||
### 4. UX
|
||
|
||
* При відключенні: підтвердження
|
||
* При підключенні: вибір прав доступу
|
||
* Оновлення UI після зміни
|
||
|
||
## Acceptance Criteria
|
||
|
||
* Бейджі на картці показують кількість просторів
|
||
* Модалка зі списком просторів працює
|
||
* Перемикачі в консолі працюють
|
||
* API виклики зберігають зміни
|
||
* UI оновлюється після змін
|
||
|
||
## Приклад промта для Cursor
|
||
|
||
```
|
||
Implement Agent Connections Management using:
|
||
|
||
- 23_agent_cards_and_console.md
|
||
- 21_agent_only_interface.md
|
||
- 03_api_core_snapshot.md
|
||
- 05_coding_standards.md
|
||
|
||
Deliverables:
|
||
|
||
1) Badges on agent card showing presence count.
|
||
2) Modal with list of spaces (channels/projects) for agent.
|
||
3) Toggle switches in Agent Console Presence tab.
|
||
4) Connect/disconnect API calls.
|
||
5) UI updates after connection changes.
|
||
|
||
Output: list of files + diff + summary.
|
||
```
|
||
|
||
---
|
||
|
||
# Порядок виконання задач
|
||
|
||
Рекомендований порядок:
|
||
|
||
1. **Task 1** — Agent-Cards-Grid (базова структура карток)
|
||
2. **Task 3** — Agent-Experience-Metrics (метрики для карток)
|
||
3. **Task 2** — Agent-Console-UI (повний інтерфейс)
|
||
4. **Task 4** — Agent-Connections-Toggles (управління підключеннями)
|
||
|
||
---
|
||
|
||
# Залежності між задачами
|
||
|
||
- **Task 1** не залежить від інших
|
||
- **Task 3** може використовуватися в Task 1
|
||
- **Task 2** потребує Task 1 (відкриття консолі з картки)
|
||
- **Task 4** потребує Task 2 (вкладка "Присутність")
|
||
|
||
---
|
||
|
||
# Загальні вимоги
|
||
|
||
## Термінологія
|
||
|
||
**Важливо:** Використовувати тільки людську термінологію:
|
||
|
||
✅ Дозволено:
|
||
- "досвід"
|
||
- "шлях агента"
|
||
- "довіра спільноти"
|
||
- "внесок у колективний розум"
|
||
- "репутація"
|
||
|
||
❌ Заборонено:
|
||
- "інвестиції"
|
||
- "юніти вартості"
|
||
- "ROI"
|
||
- "прибуток"
|
||
- будь-які фінансові терміни
|
||
|
||
## Зберігання даних
|
||
|
||
* Всі файли/документи зберігаються в сховищі microDAO
|
||
* Показувати індикатор: "Документи зберігаються в просторі вашої microDAO"
|
||
* DAGI використовується як "мозок", але не як сховище
|
||
|
||
---
|
||
|
||
**Готово.**
|
||
Це **структурований список задач для Agent Cards та Console**, готовий до використання в Cursor.
|
||
|
||
|