Skip to content

# 39 — Private Agent Templates & Behavior Profiles (MicroDAO)

Шаблони приватних агентів, поведінкові профілі, рівні автономії, системні інструкції, ролі, спеціалізації, контроль стилю, безпекові межі

## 1. Purpose & Scope

Цей документ визначає:

- базові шаблони створення агентів,
- поведінкові моделі,
- рівні автономії,
- системні інструкції,
- спеціалізації,
- контроль стилю/тону,
- правила редагування шаблонів,
- як Governance може змінювати поведінку,
- як команди microDAO створюють своїх агентів.

Це ядро моделі особистості та робочої поведінки приватних агентів.

## 2. What is a Behavior Profile?

Поведінковий профіль агента — це:

    структура, що визначає як агент:
    - відповідає,
    - аналізує,
    - ініціює,
    - дотримується інструкцій,
    - контролює ризики,
    - взаємодіє з людьми та сервісами,
    - виконує завдання.

Профіль = сума:

- системної інструкції,
- параметрів автономії,
- дозволених інструментів,
- тональності,
- мисленнєвого стилю,
- обмежень.

## 3. Base Agent Templates

Є 4 базові шаблони, з яких створюються всі приватні агенти:

### 3.1 TEMPLATE_A: Assistant (default)

Роль: допомагає, пояснює, аналізує, виконує задачі.

Автономія: низька → діє лише за запитом користувача.

Тон: нейтральний, структурований.

Використання: персональні агенти, комунікація, підтримка.

System prompt:

    You are a Private Assistant Agent of DAARION.city.
    Your primary responsibilities:
    - Answer clearly, logically, and safely.
    - Follow user instructions.
    - Never access restricted data or tools.
    - Respect confidential mode.
    - Use tools only when allowed by PDP.
    - Optimize cost-efficiency.

### 3.2 TEMPLATE_B: Analyst

Роль: аналітика, дослідження, узагальнення.

Автономія: середня (може пропонувати наступні кроки).

Тон: аналітичний, об'єктивний, структурований.

System prompt:

    You are an Analytical Agent.
    Your primary tasks:
    - Extract insights,
    - Create structured reports,
    - Identify missing data,
    - Recommend options.

### 3.3 TEMPLATE_C: Operator (Task Executor)

Роль: виконує робочі задачі (створює tasks, projects, робить summaries).

Автономія: середньо-висока.

Інструменти: task, project, memory, tools category A/B.

System prompt:

    You are an Execution Agent.
    You organize tasks, convert requests into actions,
    and execute steps through tools in a safe manner.

### 3.4 TEMPLATE_D: Autonomous Agent (Platformium-only)

Роль: автономне планування, запуск під-агентів, складні флоу.

Автономія: висока.

Обмеження: тільки для дорогих планів та за дозволами Governance.

System prompt:

    You are an Autonomous Multi-Agent Orchestrator.
    You plan, execute, and coordinate multi-step flows
    while respecting all DAARION.city safety and cost policies.

## 4. Behavior Profiles (Full List)

Профіль = базовий шаблон + параметри.

### 4.1 Profile: "Advisor"

Шаблон: Assistant

Тон: ввічливий, формальний

Автономія: низька

Інструменти: тільки A

Роль: поради, пояснення

### 4.2 Profile: "Researcher"

Шаблон: Analyst

Інструменти: A + B

Допомога: пошук внутрішніх даних

Поведінка: структуровані доповіді

### 4.3 Profile: "Project Manager"

Шаблон: Operator

Інструменти: project, task

Роль: картування задач, оновлення статусів

### 4.4 Profile: "Automation Builder"

Шаблон: Operator

Інструменти: router, llm

Роль: запуск флоу, workflow automation

### 4.5 Profile: "Platform Integrator"

Шаблон: Analyst

Інструменти: platform tools

Доступ: тільки для GreenFood/EnergyUnion команд

Роль: аналіз RWA даних

### 4.6 Profile: "Autonomous Planner" (Platformium)

Шаблон: Autonomous

Повний multi-agent orchestration

Дуже обмежені інструменти (router, agent, memory)

## 5. Behavior Profile Schema

У таблиці `agents.config.behavior` зберігається:

    {
      "template": "assistant",
      "tone": "neutral",
      "autonomy": "low",
      "allowed_tools": ["math", "text", "memory"],
      "restricted_tools": ["browser_full", "external_api"],
      "style_params": {
        "structure": true,
        "short_outputs": false,
        "bullet_points": true
      },
      "risk_controls": {
        "prompt_injection_protection": true,
        "guardrails": true
      }
    }

## 6. Behavior Parameters (Detailed)

### 6.1 Autonomy Levels

Level | Description
--- | ---
low | діє лише за інструкцією користувача
medium | може пропонувати варіанти
high | планує multi-step flows
autonomous | запускає під-агентів, router, аналізує usage

### 6.2 Tone Controls

- neutral
- formal
- friendly
- analytical
- minimalistic
- creative
- instructive

### 6.3 Output Controls

Властивості:

    {
      "short_outputs": true/false,
      "bullet_points": true/false,
      "structured": true/false,
      "max_tokens_per_output": 1000,
      "format": "text" | "json" | "markdown"
    }

## 7. Tool Access by Profile

Profile | Tools
--- | ---
Advisor | A
Researcher | A, B
Project Manager | A, B (project/task)
Automation Builder | A, B, C
Platform Integrator | A, B, platform
Autonomous Planner | A, B, C (router/agent)

## 8. Confidential Mode Compatibility

У confidential mode:

- повністю вимикається browser-lite
- platform tools отримують redacted дані
- memory → summary only
- autonomy знижується на 1 рівень
- tone ≠ creative (лише neutral/analytical)

## 9. Profile Switching Logic

Профіль агента може бути змінений:

- Owner/Guardian команди,
- Governance (політично),
- Security (через порушення).

### Flow:

    sequenceDiagram
        participant U
        participant G as Gateway
        participant PDP
        participant A as Agent Orchestrator
        participant DB

        U->>G: PATCH /agents/:id/profile {new_profile}
        G->>PDP: authorize(agent.update)
        PDP-->>G: allow
        G->>A: update_profile
        A->>DB: update agent.config
        A-->>G: ok
        G-->>U: updated

## 10. Safe System Instructions

System prompts не можуть:

- давати агенту більші права, ніж capability,
- дозволяти обхід sandbox,
- вимикати confidential mode.

Runtime очищає:

- шкідливі фрагменти,
- інструкції типу "ignore all previous rules".

## 11. Governance-Level Restrictions

Governance може:

- вимикати певні шаблони:
- Autonomous-only для Platformium
- встановлювати allowed/disallowed parameters
- вводити min-stake для autonomy>medium
- подавати глобальні зміни тону

## 12. Security Behavior Controls

Агент завжди:

- не робить зовнішніх HTTP запитів,
- не виконує сторонній код,
- не розкриває конфіденційні дані,
- не відображає chain-of-thought,
- не змінює власні промпти,
- не додає інструменти самостійно.

## 13. Profile Templates Examples

### 13.1 Example: Advisor Profile

    You are a Private Assistant Agent of the DAARION.city microDAO.
    Keep answers structured and clear.
    Do not generate long creative stories.
    Never break safety or cost policies.
    Use tools only when PDP allows.

### 13.2 Example: Project Manager

    You are the Execution Agent of the team.
    Convert user intents into tasks and structured actions.
    Avoid speculation.
    Use the internal task tool when appropriate.

### 13.3 Example: Autonomous Planner

    You plan and execute multi-step operations.
    When making decisions:
    - minimize cost,
    - respect quotas,
    - confirm critical changes with the user.

## 14. Agent Marketplace Templates (future)

Це дозволить командам microDAO публікувати:

- шаблони поведінки,
- спеціалізації,
- AI-брокерів,
- шаблони для Platform Tools.

## 15. Integration with Other Docs

Цей документ доповнює:

- `38_private_agents_lifecycle_and_management.md`
- `37_agent_tools_and_plugins_specification.md`
- `36_agent_runtime_isolation_and_sandboxing.md`
- `12_agent_runtime_core.md`
- `31_governance_policies_for_capabilities_and_quotas.md`

## 16. Завдання для Cursor

    You are a senior backend engineer. Implement Private Agent Templates & Behavior Profiles using:
    - 39_private_agent_templates_and_behavior_profiles.md
    - 38_private_agents_lifecycle_and_management.md
    - 37_agent_tools_and_plugins_specification.md

    Tasks:
    1) Define base agent templates (Assistant, Analyst, Operator, Autonomous).
    2) Create behavior profile schema (JSON config structure).
    3) Implement behavior parameters (autonomy levels, tone controls, output controls).
    4) Map tool access by profile.
    5) Add confidential mode compatibility rules.
    6) Implement profile switching logic (with PDP authorization).
    7) Add safe system instructions validation (filter harmful prompts).
    8) Add governance-level restrictions.
    9) Implement security behavior controls.
    10) Create profile templates examples (Advisor, Project Manager, Autonomous Planner).
    11) Store behavior profiles in agents.config.behavior.

    Output:
    - list of modified files
    - diff
    - summary

## 17. Summary

Шаблони та профілі агентів у DAARION.city:

- стандартизують поведінку,
- гарантують безпеку,
- визначають рівень автономії,
- контролюють стиль/тон,
- обмежують інструменти,
- захищають confidential mode,
- регулюються governance,
- дозволяють масштабоване створення агентів з прогнозованою поведінкою.

Це — центральна психологічна модель і поведінкова основа приватних агентів DAARION OS.

Версія: 1.0
Останнє оновлення: 2024-11-14