# 🤖 Налаштування 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`