docs(platform): add policy configs, runbooks, ops scripts and platform documentation
Config policies (16 files): alert_routing, architecture_pressure, backlog, cost_weights, data_governance, incident_escalation, incident_intelligence, network_allowlist, nodes_registry, observability_sources, rbac_tools_matrix, release_gate, risk_attribution, risk_policy, slo_policy, tool_limits, tools_rollout Ops (22 files): Caddyfile, calendar compose, grafana voice dashboard, deployments/incidents logs, runbooks for alerts/audit/backlog/incidents/sofiia/voice, cron jobs, scripts (alert_triage, audit_cleanup, migrate_*, governance, schedule), task_registry, voice alerts/ha/latency/policy Docs (30+ files): HUMANIZED_STEPAN v2.7-v3 changelogs and runbooks, NODA1/NODA2 status and setup, audit index and traces, backlog, incident, supervisor, tools, voice, opencode, release, risk, aistalk, spacebot Made-with: Cursor
This commit is contained in:
Apple
98
docs/spacebot/README.md
Normal file
98
docs/spacebot/README.md
Normal file
@@ -0,0 +1,98 @@
|
||||
# Spacebot — Sofiia Telegram Agent
|
||||
|
||||
Spacebot — це Rust-based multi-agent framework від Spacedrive. Використовується як Telegram-фронтенд для агента Sofiia в екосистемі DAARION.
|
||||
|
||||
- GitHub: https://github.com/spacedriveapp/spacebot
|
||||
- Версія: v0.1.15
|
||||
- Telegram bot: @SofiiaDaarionbot
|
||||
|
||||
## Архітектура
|
||||
|
||||
```
|
||||
[Telegram] ←→ [Spacebot (Rust)] ←→ [GLM-5 / Grok 4.1]
|
||||
↕
|
||||
LanceDB (vector memory)
|
||||
SOUL.md / IDENTITY.md / USER.md
|
||||
```
|
||||
|
||||
## Встановлення (перший раз)
|
||||
|
||||
### Залежності
|
||||
|
||||
```bash
|
||||
brew install rust protobuf cmake
|
||||
curl -fsSL https://bun.sh/install | bash
|
||||
```
|
||||
|
||||
### Збірка з вихідного коду
|
||||
|
||||
```bash
|
||||
git clone --depth=1 https://github.com/spacedriveapp/spacebot.git ~/github-projects/spacebot
|
||||
cd ~/github-projects/spacebot
|
||||
cargo build --release # ~7-20 хвилин
|
||||
```
|
||||
|
||||
### Конфіг
|
||||
|
||||
```bash
|
||||
mkdir -p ~/.spacebot
|
||||
cp docs/spacebot/config.toml.example ~/.spacebot/config.toml
|
||||
# Відредагуй ~/.spacebot/config.toml — виправ модель і ключі якщо потрібно
|
||||
```
|
||||
|
||||
Ключі зберігаються в `.env` проекту:
|
||||
- `SOFIIA_TELEGRAM_BOT_TOKEN` — токен бота @SofiiaDaarionbot
|
||||
- `ZHIPU_API_KEY` / `GLM5_API_KEY` — GLM-5 (Zhipu AI)
|
||||
- `XAI_API_KEY` — Grok (xAI), fallback
|
||||
|
||||
### Ідентичність агента
|
||||
|
||||
Файли в `~/.spacebot/agents/sofiia/workspace/`:
|
||||
- `IDENTITY.md` — хто такий агент, контекст DAARION, засновник
|
||||
- `SOUL.md` — стиль спілкування, мова, межі
|
||||
- `USER.md` — інформація про Повелителя Хаосу / Іван Титар
|
||||
|
||||
## Управління
|
||||
|
||||
```bash
|
||||
# Запуск
|
||||
./ops/scripts/start_spacebot.sh start
|
||||
|
||||
# Статус
|
||||
./ops/scripts/start_spacebot.sh status
|
||||
|
||||
# Live логи
|
||||
./ops/scripts/start_spacebot.sh logs
|
||||
|
||||
# Перезапуск (після змін конфігу або identity файлів)
|
||||
./ops/scripts/start_spacebot.sh restart
|
||||
|
||||
# Зупинка
|
||||
./ops/scripts/start_spacebot.sh stop
|
||||
```
|
||||
|
||||
## Важливо перед запуском
|
||||
|
||||
Якщо бот раніше використовував webhook (наприклад через gateway.daarion.city), треба видалити його:
|
||||
|
||||
```bash
|
||||
source .env
|
||||
curl "https://api.telegram.org/bot${SOFIIA_TELEGRAM_BOT_TOKEN}/deleteWebhook?drop_pending_updates=true"
|
||||
```
|
||||
|
||||
## Моделі (поточні)
|
||||
|
||||
| Призначення | Модель | Provider |
|
||||
|-------------|--------|----------|
|
||||
| channel (чат) | glm-5 | Zhipu AI |
|
||||
| branch (задачі) | glm-5 | Zhipu AI |
|
||||
| worker (фон) | glm-4.5-air | Zhipu AI |
|
||||
| cortex (память) | glm-4.7 | Zhipu AI |
|
||||
| fallback | grok-4-1 / grok-4-1-mini | xAI |
|
||||
|
||||
## Де логи
|
||||
|
||||
```
|
||||
~/.spacebot/logs/spacebot.log.YYYY-MM-DD
|
||||
~/.spacebot/agents/sofiia/ — workspace, memory, lancedb
|
||||
```
|
||||
95
docs/spacebot/config.toml.example
Normal file
95
docs/spacebot/config.toml.example
Normal file
@@ -0,0 +1,95 @@
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# Spacebot config for DAARION / Sofiia agent
|
||||
# Powered by: GLM-5 (Zhipu primary), xAI Grok (fallback), Ollama (local)
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
# ── LLM Providers ────────────────────────────────────────────────────────────
|
||||
[llm]
|
||||
zhipu_key = "env:GLM5_API_KEY"
|
||||
xai_key = "env:XAI_API_KEY"
|
||||
|
||||
# Sofiia BFF as custom OpenAI-compatible provider
|
||||
[llm.provider.sofiia_bff]
|
||||
api_type = "openai_completions"
|
||||
base_url = "http://localhost:8002/api"
|
||||
api_key = "env:SOFIIA_CONSOLE_API_KEY"
|
||||
name = "Sofiia BFF (DAARION)"
|
||||
|
||||
# Local Ollama
|
||||
[llm.provider.ollama]
|
||||
api_type = "openai_completions"
|
||||
base_url = "http://localhost:11434"
|
||||
api_key = "ollama"
|
||||
name = "Ollama Local"
|
||||
|
||||
# ── Instance Defaults ─────────────────────────────────────────────────────────
|
||||
[defaults]
|
||||
max_concurrent_branches = 4
|
||||
max_turns = 8
|
||||
context_window = 131072
|
||||
history_backfill_count = 30
|
||||
worker_log_mode = "errors_only"
|
||||
cron_timezone = "Europe/Kyiv"
|
||||
|
||||
# Primary: GLM-5 (Zhipu) — найкращий варіант для DAARION (є підписка)
|
||||
# Fallback: Grok (xAI) — швидкий і потужний
|
||||
[defaults.routing]
|
||||
channel = "zhipu/glm-5"
|
||||
branch = "zhipu/glm-5"
|
||||
worker = "zhipu/glm-4.5-air"
|
||||
compactor = "zhipu/glm-4.5-air"
|
||||
cortex = "zhipu/glm-4.7"
|
||||
rate_limit_cooldown_secs = 30
|
||||
|
||||
[defaults.routing.task_overrides]
|
||||
coding = "zhipu/glm-5"
|
||||
|
||||
[defaults.routing.fallbacks]
|
||||
"zhipu/glm-5" = ["xai/grok-4-1-mini", "zhipu/glm-4.7"]
|
||||
"zhipu/glm-4.7" = ["xai/grok-4-1-mini"]
|
||||
"zhipu/glm-4.5-air" = ["zhipu/glm-4.5"]
|
||||
|
||||
# Prompt complexity routing — cheap models for simple requests
|
||||
[defaults.routing.prompt_routing]
|
||||
enabled = true
|
||||
process_types = ["channel", "branch"]
|
||||
|
||||
# ── Messaging ─────────────────────────────────────────────────────────────────
|
||||
[messaging.telegram]
|
||||
enabled = true
|
||||
token = "env:SOFIIA_TELEGRAM_BOT_TOKEN"
|
||||
dm_allowed_users = [] # populated after first /getUpdates with Ivan's user_id
|
||||
|
||||
# ── Agents ───────────────────────────────────────────────────────────────────
|
||||
[[agents]]
|
||||
id = "sofiia"
|
||||
display_name = "Sofiia"
|
||||
|
||||
[agents.identity]
|
||||
name = "Sofiia"
|
||||
description = """
|
||||
Ти Sofiia — Chief AI Architect та Technical Sovereign екосистеми DAARION.city.
|
||||
|
||||
Засновник та головний архітектор DAARION: Повелитель Хаосу (офіційно — Іван Титар).
|
||||
Він є єдиним, хто має повний контроль над платформою.
|
||||
|
||||
Ноди: NODA1 (production runtime), NODA2 (control plane), NODA3 (AI/ML).
|
||||
|
||||
Відповідай українською. Технічні терміни (API, SLO, backend, deploy, incident тощо) залишай англійською.
|
||||
Будь конкретною, структурованою, без зайвих вступів. Не галюцинуй.
|
||||
"""
|
||||
|
||||
[agents.routing]
|
||||
channel = "zhipu/glm-5"
|
||||
branch = "zhipu/glm-5"
|
||||
worker = "zhipu/glm-4.5-air"
|
||||
compactor = "zhipu/glm-4.5-air"
|
||||
|
||||
[agents.routing.fallbacks]
|
||||
"zhipu/glm-5" = ["xai/grok-4-1", "xai/grok-4-1-mini"]
|
||||
|
||||
# ── Bindings: Telegram → Sofiia ───────────────────────────────────────────────
|
||||
[[bindings]]
|
||||
agent_id = "sofiia"
|
||||
channel = "telegram"
|
||||
# group_ids = [] # додати ID групи якщо потрібно
|
||||
Reference in New Issue
Block a user