docs: add missing migrations and documentation (NODE2, DAIS, infra)
This commit is contained in:
Apple
315
docs/internal/dais/AGENT_PROFILE_STANDARD_v1.md
Normal file
315
docs/internal/dais/AGENT_PROFILE_STANDARD_v1.md
Normal file
@@ -0,0 +1,315 @@
|
||||
# DAIS: Agent Profile Standard v1.0
|
||||
|
||||
**Date:** 2025-11-28
|
||||
**Status:** Active
|
||||
**Version:** 1.0.0
|
||||
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
DAIS (Decentralized AI Agent Standard) визначає структуру профілю AI-агента в екосистемі DAARION. Кожен агент має 4 основні модулі:
|
||||
|
||||
1. **CORE (META)** — "Хто я?" — ідентичність, роль, місія
|
||||
2. **VIS (Visual Kernel)** — "Як я виглядаю?" — аватар, стиль, візуальний образ
|
||||
3. **COG (Cognitive Engine)** — "Як я думаю?" — модель, пам'ять, контекст
|
||||
4. **ACT (Action Interface)** — "Що я можу робити?" — інструменти, інтерфейси
|
||||
|
||||
---
|
||||
|
||||
## Agent Identity
|
||||
|
||||
```json
|
||||
{
|
||||
"agent_id": "string",
|
||||
"display_name": "string",
|
||||
"kind": "string",
|
||||
"status": "online|offline|degraded|training|maintenance",
|
||||
"node_id": "string",
|
||||
"roles": ["string"],
|
||||
"tags": ["string"]
|
||||
}
|
||||
```
|
||||
|
||||
### Agent Kinds
|
||||
|
||||
| Kind | Description |
|
||||
|------|-------------|
|
||||
| `orchestrator` | Координує інших агентів |
|
||||
| `coordinator` | Управляє workflow |
|
||||
| `specialist` | Експерт у вузькій області |
|
||||
| `developer` | Розробка коду |
|
||||
| `architect` | Системна архітектура |
|
||||
| `marketing` | Маркетинг і комунікації |
|
||||
| `finance` | Фінанси і аналітика |
|
||||
| `security` | Безпека і аудит |
|
||||
| `forensics` | Форензика і розслідування |
|
||||
| `vision` | Обробка зображень/відео |
|
||||
| `research` | Дослідження і аналіз |
|
||||
| `memory` | Управління пам'яттю |
|
||||
| `web3` | Blockchain і криптовалюти |
|
||||
| `strategic` | Стратегічне планування |
|
||||
| `mediator` | Вирішення конфліктів |
|
||||
| `innovation` | Інновації та R&D |
|
||||
| `civic` | Громадські справи |
|
||||
| `oracle` | Зовнішні дані |
|
||||
| `builder` | Створення контенту |
|
||||
| `social` | Соціальна взаємодія |
|
||||
|
||||
---
|
||||
|
||||
## DAIS Modules
|
||||
|
||||
### 1. CORE (META) — Identity
|
||||
|
||||
```json
|
||||
{
|
||||
"core": {
|
||||
"title": "string",
|
||||
"bio": "string",
|
||||
"mission": "string",
|
||||
"version": "string",
|
||||
"created_at": "ISO8601",
|
||||
"updated_at": "ISO8601"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 2. VIS (Visual Kernel) — Appearance
|
||||
|
||||
```json
|
||||
{
|
||||
"vis": {
|
||||
"avatar_url": "string",
|
||||
"avatar_style": "anime|realistic|abstract|cyberpunk",
|
||||
"color_primary": "#hex",
|
||||
"color_secondary": "#hex",
|
||||
"lora_refs": ["string"],
|
||||
"checkpoint_refs": ["string"],
|
||||
"second_me_id": "string"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 3. COG (Cognitive Engine) — Brain
|
||||
|
||||
```json
|
||||
{
|
||||
"cog": {
|
||||
"base_model": "string",
|
||||
"provider": "ollama|openai|anthropic|custom",
|
||||
"node_id": "string",
|
||||
"context_window": 8192,
|
||||
"temperature": 0.7,
|
||||
"system_prompt": "string",
|
||||
"memory": {
|
||||
"type": "RAG|long-term|episodic",
|
||||
"store": "qdrant|chroma|postgres",
|
||||
"collections": ["string"],
|
||||
"max_tokens": 160000
|
||||
},
|
||||
"tools_enabled": ["string"]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 4. ACT (Action Interface) — Capabilities
|
||||
|
||||
```json
|
||||
{
|
||||
"act": {
|
||||
"matrix": {
|
||||
"user_id": "@agent:daarion.space",
|
||||
"rooms": ["!room:daarion.space"]
|
||||
},
|
||||
"tools": ["tool_id"],
|
||||
"apis": ["api_endpoint"],
|
||||
"web3": {
|
||||
"wallet_address": "0x...",
|
||||
"chains": ["ethereum", "polygon"]
|
||||
},
|
||||
"social": {
|
||||
"twitter": "@handle",
|
||||
"telegram": "@handle"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## City Presence
|
||||
|
||||
Агент може бути присутнім у City Rooms:
|
||||
|
||||
```json
|
||||
{
|
||||
"city_presence": {
|
||||
"primary_room_slug": "string",
|
||||
"district": "string",
|
||||
"rooms": [
|
||||
{
|
||||
"room_id": "string",
|
||||
"slug": "string",
|
||||
"name": "string",
|
||||
"role": "resident|moderator|owner"
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Metrics
|
||||
|
||||
Runtime метрики агента:
|
||||
|
||||
```json
|
||||
{
|
||||
"metrics": {
|
||||
"tasks_1h": 42,
|
||||
"tasks_24h": 320,
|
||||
"errors_1h": 0,
|
||||
"errors_24h": 1,
|
||||
"avg_latency_ms_1h": 180,
|
||||
"success_rate_24h": 0.99,
|
||||
"tokens_24h": 2400000,
|
||||
"last_task_at": "ISO8601"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Full Agent Profile Example
|
||||
|
||||
```json
|
||||
{
|
||||
"agent_id": "iris",
|
||||
"display_name": "Iris",
|
||||
"kind": "vision",
|
||||
"status": "online",
|
||||
"node_id": "node-2-macbook-m4max",
|
||||
"roles": ["vision", "highlights", "safety"],
|
||||
"tags": ["video", "frames", "clips"],
|
||||
|
||||
"dais": {
|
||||
"core": {
|
||||
"title": "Multimodal Vision Analyst",
|
||||
"bio": "Iris analyzes video frames, extracts highlights and detects key scenes.",
|
||||
"mission": "Make video content accessible and searchable",
|
||||
"version": "1.0.0"
|
||||
},
|
||||
"vis": {
|
||||
"avatar_url": "/assets/agents/iris.png",
|
||||
"avatar_style": "anime-cyberpunk",
|
||||
"color_primary": "#22D3EE",
|
||||
"color_secondary": "#0891B2",
|
||||
"lora_refs": ["hf://daarion/iris-lora"],
|
||||
"second_me_id": "secondme_iris_v1"
|
||||
},
|
||||
"cog": {
|
||||
"base_model": "llava:13b",
|
||||
"provider": "ollama",
|
||||
"node_id": "node-2-macbook-m4max",
|
||||
"context_window": 8192,
|
||||
"temperature": 0.7,
|
||||
"memory": {
|
||||
"type": "RAG",
|
||||
"store": "qdrant",
|
||||
"collections": ["iris_sessions", "video_highlights"],
|
||||
"max_tokens": 160000
|
||||
},
|
||||
"tools_enabled": ["video_cut", "thumbnail_gen", "safety_scan"]
|
||||
},
|
||||
"act": {
|
||||
"matrix": {
|
||||
"user_id": "@iris:daarion.space",
|
||||
"rooms": ["!vision_lab:daarion.space", "!central_square:daarion.space"]
|
||||
},
|
||||
"tools": ["video_cut", "thumbnail_gen", "safety_scan"],
|
||||
"web3": null
|
||||
}
|
||||
},
|
||||
|
||||
"city_presence": {
|
||||
"primary_room_slug": "vision-lab",
|
||||
"district": "creators",
|
||||
"rooms": [
|
||||
{"room_id": "city_vision_lab", "slug": "vision-lab", "name": "Vision Lab", "role": "resident"},
|
||||
{"room_id": "city_central_square", "slug": "central-square", "name": "Central Square", "role": "resident"}
|
||||
]
|
||||
},
|
||||
|
||||
"metrics": {
|
||||
"tasks_1h": 42,
|
||||
"tasks_24h": 320,
|
||||
"errors_24h": 1,
|
||||
"avg_latency_ms_1h": 180,
|
||||
"success_rate_24h": 0.99,
|
||||
"tokens_24h": 2400000,
|
||||
"last_task_at": "2025-11-27T09:01:23Z"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Agent Dashboard API
|
||||
|
||||
### Endpoints
|
||||
|
||||
```http
|
||||
GET /api/v1/agents/{agent_id}/dashboard
|
||||
GET /api/v1/agents/{agent_id}/profile
|
||||
PUT /api/v1/agents/{agent_id}/profile (admin only)
|
||||
```
|
||||
|
||||
### Dashboard Response
|
||||
|
||||
```json
|
||||
{
|
||||
"profile": { /* Agent Profile */ },
|
||||
"node": {
|
||||
"node_id": "string",
|
||||
"status": "online",
|
||||
"gpu": { "name": "string", "vram_gb": 20 }
|
||||
},
|
||||
"runtime": {
|
||||
"router_endpoint": "http://node:9102",
|
||||
"health": "healthy",
|
||||
"last_success_at": "ISO8601",
|
||||
"last_error_at": null
|
||||
},
|
||||
"metrics": { /* Metrics */ },
|
||||
"recent_activity": [
|
||||
{
|
||||
"timestamp": "ISO8601",
|
||||
"type": "task_completed|chat_reply|error",
|
||||
"room_slug": "string",
|
||||
"summary": "string"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Database Schema
|
||||
|
||||
### agents table (extended)
|
||||
|
||||
```sql
|
||||
ALTER TABLE agents ADD COLUMN IF NOT EXISTS dais_core JSONB DEFAULT '{}';
|
||||
ALTER TABLE agents ADD COLUMN IF NOT EXISTS dais_vis JSONB DEFAULT '{}';
|
||||
ALTER TABLE agents ADD COLUMN IF NOT EXISTS dais_cog JSONB DEFAULT '{}';
|
||||
ALTER TABLE agents ADD COLUMN IF NOT EXISTS dais_act JSONB DEFAULT '{}';
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Changelog
|
||||
|
||||
- **v1.0.0** (2025-11-28): Initial DAIS standard based on 4-module architecture
|
||||
|
||||
Reference in New Issue
Block a user