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

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