docs: expand lint scope batch50 (2 files)
This commit is contained in:
Apple
@@ -6,7 +6,7 @@
|
||||
|
||||
---
|
||||
|
||||
# 1. Ідея
|
||||
## 1. Ідея
|
||||
|
||||
Замість "голої" стрічки чатів у MicroDAO є:
|
||||
|
||||
@@ -26,7 +26,7 @@
|
||||
|
||||
---
|
||||
|
||||
# 2. Ролі агентів у модулі месенджера
|
||||
## 2. Ролі агентів у модулі месенджера
|
||||
|
||||
## 2.1. Messenger Agent (core)
|
||||
|
||||
@@ -66,7 +66,7 @@ User-facing агент делегує запити Messenger Agent'у.
|
||||
|
||||
---
|
||||
|
||||
# 3. Функціональні спроможності Messenger Agent
|
||||
## 3. Функціональні спроможності Messenger Agent
|
||||
|
||||
## 3.1. Базові (класичний месенджер)
|
||||
|
||||
@@ -144,7 +144,7 @@ Messenger Agent вміє:
|
||||
|
||||
---
|
||||
|
||||
# 4. Інтерфейс з точки зору користувача
|
||||
## 4. Інтерфейс з точки зору користувача
|
||||
|
||||
### 4.1. Класичний UI (sidebar + список чатів)
|
||||
|
||||
@@ -189,7 +189,7 @@ Messenger Agent вміє:
|
||||
|
||||
---
|
||||
|
||||
# 5. Інтеграція з Agent Runtime Core (12)
|
||||
## 5. Інтеграція з Agent Runtime Core (12)
|
||||
|
||||
Messenger Agent описується як звичайний агент:
|
||||
|
||||
@@ -210,7 +210,7 @@ const messengerAgentConfig: AgentConfig = {
|
||||
"create_followup_from_message"
|
||||
],
|
||||
};
|
||||
```
|
||||
```text
|
||||
|
||||
Tools реалізуються через Messaging Service:
|
||||
|
||||
@@ -222,51 +222,51 @@ const tools: ToolRegistry = {
|
||||
async open_channel(ctx, args) { ... }, // повертає метаданні каналу
|
||||
async get_daily_digest(ctx, args) { ... },
|
||||
};
|
||||
```
|
||||
```text
|
||||
|
||||
Агент runtime (`runAgentTurn`) вирішує:
|
||||
|
||||
* чи просто відповісти текстом,
|
||||
- чи просто відповісти текстом,
|
||||
|
||||
* чи викликати tools,
|
||||
- чи викликати tools,
|
||||
|
||||
* чи комбінувати.
|
||||
- чи комбінувати.
|
||||
|
||||
---
|
||||
|
||||
# 6. Інтеграція з памʼяттю (13)
|
||||
## 6. Інтеграція з памʼяттю (13)
|
||||
|
||||
Messenger Agent:
|
||||
|
||||
* **Short-term** — поточний контекст каналу/діалогу.
|
||||
- **Short-term** — поточний контекст каналу/діалогу.
|
||||
|
||||
* **Long-term** — факти:
|
||||
- **Long-term** — факти:
|
||||
|
||||
* які канали важливі для яких людей,
|
||||
- які канали важливі для яких людей,
|
||||
|
||||
* які теми зʼявляються часто,
|
||||
- які теми зʼявляються часто,
|
||||
|
||||
* які теги/поняття повʼязані з якими чатами.
|
||||
- які теги/поняття повʼязані з якими чатами.
|
||||
|
||||
Приклад фактів:
|
||||
|
||||
* "Канал #governance використовується для голосувань DAO."
|
||||
- "Канал #governance використовується для голосувань DAO."
|
||||
|
||||
* "Канал #dev-mvp обговорює реалізацію MVP MicroDAO."
|
||||
- "Канал #dev-mvp обговорює реалізацію MVP MicroDAO."
|
||||
|
||||
Це дозволяє агенту:
|
||||
|
||||
* відповідати на питання типу:
|
||||
- відповідати на питання типу:
|
||||
|
||||
* "Де обговорювати зміни в governance?"
|
||||
- "Де обговорювати зміни в governance?"
|
||||
|
||||
* пропонувати:
|
||||
- пропонувати:
|
||||
|
||||
* "Здається, обговорення токеноміки краще перенести в #tokenomics."
|
||||
- "Здається, обговорення токеноміки краще перенести в #tokenomics."
|
||||
|
||||
---
|
||||
|
||||
# 7. Типові сценарії використання
|
||||
## 7. Типові сценарії використання
|
||||
|
||||
### Сценарій 1 — Новий учасник
|
||||
|
||||
@@ -276,11 +276,11 @@ Messenger Agent:
|
||||
|
||||
Messenger Agent:
|
||||
|
||||
* знаходить 2–3 ключові канали,
|
||||
- знаходить 2–3 ключові канали,
|
||||
|
||||
* дає короткі описи,
|
||||
- дає короткі описи,
|
||||
|
||||
* пропонує їх відкрити.
|
||||
- пропонує їх відкрити.
|
||||
|
||||
### Сценарій 2 — Щоденний огляд
|
||||
|
||||
@@ -288,13 +288,13 @@ Messenger Agent:
|
||||
|
||||
Messenger Agent:
|
||||
|
||||
* використовує `get_daily_digest` tool,
|
||||
- використовує `get_daily_digest` tool,
|
||||
|
||||
* збирає важливі повідомлення/канали,
|
||||
- збирає важливі повідомлення/канали,
|
||||
|
||||
* створює summary (через LLM),
|
||||
- створює summary (через LLM),
|
||||
|
||||
* відправляє повідомлення у спеціальний канал або в DM.
|
||||
- відправляє повідомлення у спеціальний канал або в DM.
|
||||
|
||||
### Сценарій 3 — Пошук контексту
|
||||
|
||||
@@ -302,29 +302,29 @@ Messenger Agent:
|
||||
|
||||
Messenger Agent:
|
||||
|
||||
* шукає в повідомленнях (Meilisearch + RAG),
|
||||
- шукає в повідомленнях (Meilisearch + RAG),
|
||||
|
||||
* показує релевантні уривки,
|
||||
- показує релевантні уривки,
|
||||
|
||||
* пропонує створити follow-up або задачу.
|
||||
- пропонує створити follow-up або задачу.
|
||||
|
||||
---
|
||||
|
||||
# 8. Взаємодія з іншими агентами
|
||||
## 8. Взаємодія з іншими агентами
|
||||
|
||||
* **Team Assistant** може делегувати складні запити Messenger Agent'у.
|
||||
- **Team Assistant** може делегувати складні запити Messenger Agent'у.
|
||||
|
||||
* **Evolution Meta-Agent** аналізує:
|
||||
- **Evolution Meta-Agent** аналізує:
|
||||
|
||||
* які канали важливі;
|
||||
- які канали важливі;
|
||||
|
||||
* які патерни запитів до Messenger Agent'а повторюються;
|
||||
- які патерни запитів до Messenger Agent'а повторюються;
|
||||
|
||||
* які нові "розумні фільтри" варто запропонувати.
|
||||
- які нові "розумні фільтри" варто запропонувати.
|
||||
|
||||
---
|
||||
|
||||
# 9. Реалізація Tools
|
||||
## 9. Реалізація Tools
|
||||
|
||||
## 9.1. list_channels
|
||||
|
||||
@@ -355,7 +355,7 @@ async function list_channels(
|
||||
messageCount: ch._count.messages,
|
||||
}));
|
||||
}
|
||||
```
|
||||
```text
|
||||
|
||||
## 9.2. list_unread
|
||||
|
||||
@@ -384,7 +384,7 @@ async function list_unread(
|
||||
lastMessageAt: u.lastReadAt,
|
||||
}));
|
||||
}
|
||||
```
|
||||
```text
|
||||
|
||||
## 9.3. search_messages
|
||||
|
||||
@@ -412,7 +412,7 @@ async function search_messages(
|
||||
createdAt: hit.createdAt,
|
||||
}));
|
||||
}
|
||||
```
|
||||
```text
|
||||
|
||||
## 9.4. get_daily_digest
|
||||
|
||||
@@ -465,11 +465,11 @@ async function get_daily_digest(
|
||||
|
||||
return digest;
|
||||
}
|
||||
```
|
||||
```text
|
||||
|
||||
---
|
||||
|
||||
# 10. System Prompt для Messenger Agent
|
||||
## 10. System Prompt для Messenger Agent
|
||||
|
||||
```txt
|
||||
You are the Messenger Agent for MicroDAO.
|
||||
@@ -486,11 +486,11 @@ You can:
|
||||
Always be concise and helpful. When a user asks to see something, use the appropriate tools to fetch the data and present it clearly.
|
||||
|
||||
If you don't understand a request, ask for clarification.
|
||||
```
|
||||
```text
|
||||
|
||||
---
|
||||
|
||||
# 11. UI Integration
|
||||
## 11. UI Integration
|
||||
|
||||
## 11.1. Agent Query Input
|
||||
|
||||
@@ -512,7 +512,7 @@ If you don't understand a request, ask for clarification.
|
||||
}
|
||||
}}
|
||||
/>
|
||||
```
|
||||
```text
|
||||
|
||||
## 11.2. Smart Filters
|
||||
|
||||
@@ -529,15 +529,15 @@ If you don't understand a request, ask for clarification.
|
||||
applyFilter(result.channels);
|
||||
}}
|
||||
/>
|
||||
```
|
||||
```text
|
||||
|
||||
---
|
||||
|
||||
# 12. Завдання для Cursor
|
||||
## 12. Завдання для Cursor
|
||||
|
||||
Приклад промта:
|
||||
|
||||
```
|
||||
```text
|
||||
You are a senior full-stack engineer.
|
||||
|
||||
Implement the Messenger Agent module using:
|
||||
@@ -567,23 +567,22 @@ Output:
|
||||
- list of modified files
|
||||
- diff
|
||||
- summary
|
||||
```
|
||||
```text
|
||||
|
||||
---
|
||||
|
||||
# 13. Результат
|
||||
## 13. Результат
|
||||
|
||||
Після впровадження Messenger Agent:
|
||||
|
||||
* MicroDAO перестає бути "ще одним месенджером";
|
||||
- MicroDAO перестає бути "ще одним месенджером";
|
||||
|
||||
* користувач взаємодіє з агентом, а не просто з переліком чатів;
|
||||
- користувач взаємодіє з агентом, а не просто з переліком чатів;
|
||||
|
||||
* всі класичні можливості месенджера залишаються, але стають **інструментами** всередині агентської ОС.
|
||||
- всі класичні можливості месенджера залишаються, але стають **інструментами** всередині агентської ОС.
|
||||
|
||||
---
|
||||
|
||||
**Готово.**
|
||||
Це **повна специфікація Messenger Agent модуля**, готова до використання в Cursor.
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user