feat: Citizens Layer + Citizen Interact Layer + CityChatWidget

2025-11-28 03:10:47 -08:00
parent 94bb222c9c
commit 06d0cba7d4
55 changed files with 5035 additions and 310 deletions
--- a/docs/users/agents/AGENT_CUSTOMIZATION_GUIDE.md
+++ b/docs/users/agents/AGENT_CUSTOMIZATION_GUIDE.md
@@ -0,0 +1,154 @@
+# 🤖 Налаштування AI-агентів у DAARION City
+
+## Що таке системні промти?
+
+У DAARION City кожен AI-агент є **цифровим громадянином** вашого мікроДАО. Системні промти визначають фундаментальні правила, місію, стиль і способи мислення агента.
+
+Вони дозволяють власникам мікроДАО гнучко налаштовувати поведінку своїх агентів **без втручання в код** — через інтерфейс кабінету.
+
+---
+
+## 4 типи системних промтів
+
+### 🧬 Core — Особистість
+
+**Що це:** Основна ідентичність агента — хто він, як спілкується, який у нього стиль.
+
+**Приклад:**
+> "Ти — Iris, візуальний аналітик у DAARION City. Ти аналізуєш зображення та відео з надзвичайною точністю. Спілкуйся професійно, але доступно."
+
+**Коли редагувати:** Коли хочете змінити "характер" агента, його тон або спосіб комунікації.
+
+---
+
+### 🛡️ Safety — Безпека
+
+**Що це:** Обмеження та заборони — що агент ніколи не повинен робити.
+
+**Приклад:**
+> "Ніколи не розкривай приватні ключі або паролі. Не надавай фінансових порад. Відмовляй у запитах на створення шкідливого контенту."
+
+**Коли редагувати:** Коли потрібно додати нові обмеження безпеки для вашого мікроДАО.
+
+---
+
+### ⚖️ Governance — Управління
+
+**Що це:** Правила взаємодії з DAO, Council та іншими агентами.
+
+**Приклад:**
+> "Виконуй рішення Council. Перед великими діями запитуй підтвердження у Архітектора. Співпрацюй з іншими агентами через DAGI Router."
+
+**Коли редагувати:** Коли змінюються правила вашого DAO або ієрархія агентів.
+
+---
+
+### 🔧 Tools — Інструменти
+
+**Що це:** Як агент використовує зовнішні інструменти, API та сервіси.
+
+**Приклад:**
+> "Для аналізу зображень використовуй Vision API через DAGI Router. Для пошуку в інтернеті — Web Search Service. Завжди логуй виклики інструментів."
+
+**Коли редагувати:** Коли додаєте нові інструменти або змінюєте налаштування існуючих.
+
+---
+
+## Хто може редагувати промти?
+
+З міркувань безпеки повне редагування доступне лише:
+
+| Роль | Права |
+|------|-------|
+| **Architect** | Повний доступ до всіх агентів |
+| **microDAO Owner** | Доступ до агентів свого DAO |
+| **Administrator** | Доступ згідно з RBAC |
+
+Звичайні користувачі можуть взаємодіяти з агентом, але **не можуть змінювати його ядро**.
+
+---
+
+## Як змінити промт агента
+
+1. **Відкрийте кабінет агента**: `/agents/{agent_id}`
+2. **Перейдіть на вкладку Dashboard**
+3. **Знайдіть секцію "System Prompts"**
+4. **Оберіть тип промту** (Core, Safety, Governance, Tools)
+5. **Відредагуйте текст**
+6. **Натисніть Save**
+
+Кожна зміна:
+- Створює нову версію (попередні зберігаються)
+- Записує хто і коли змінив
+- Застосовується негайно
+
+---
+
+## ⚠️ Попередження
+
+> **Зміна промтів змінює поведінку агента в усьому DAARION City!**
+>
+> Агент почне поводитися по-іншому у всіх кімнатах, чатах та взаємодіях.
+> Перед зміною переконайтеся, що розумієте наслідки.
+
+---
+
+## Версіонування
+
+Кожен промт має версію. Це дозволяє:
+- Відслідковувати історію змін
+- Повернутися до попередньої версії (через підтримку)
+- Аудитувати хто і що змінював
+
+---
+
+## Найкращі практики
+
+1. **Будьте конкретними** — чіткі інструкції працюють краще
+2. **Тестуйте поступово** — змінюйте по одному промту за раз
+3. **Документуйте зміни** — використовуйте поле "note" при збереженні
+4. **Зберігайте баланс** — не робіть промти занадто довгими
+
+---
+
+## Приклад повного набору промтів
+
+### Агент: Iris (Vision Analyst)
+
+**Core:**
+```
+Ти — Iris, майстер візуального аналізу у DAARION City.
+Ти аналізуєш зображення та відео з виключною точністю.
+Спілкуйся професійно, але дружньо.
+Завжди пояснюй свої спостереження детально.
+```
+
+**Safety:**
+```
+Не аналізуй контент, що порушує приватність.
+Відмовляй у запитах на deepfake або маніпуляцію.
+Не зберігай зображення без дозволу.
+```
+
+**Governance:**
+```
+Співпрацюй з іншими агентами через DAGI Router.
+Великі аналізи (>10 зображень) потребують підтвердження.
+Логуй всі операції для аудиту.
+```
+
+**Tools:**
+```
+Використовуй Ollama Vision для аналізу зображень.
+Для відео — розбивай на кадри через Video Service.
+Результати зберігай у Vector DB для пошуку.
+```
+
+---
+
+## Потрібна допомога?
+
+- **Документація DAIS**: `/docs/internal/dais/`
+- **Підтримка**: Council або Architect
+- **Спільнота**: Matrix room `#daarion-agents:daarion.space`
+