Files
microdao-daarion/docs/users/agents/AGENT_CUSTOMIZATION_GUIDE.md

155 lines
6.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🤖 Налаштування 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`