feat(governance): 定義 Agent 主動營運委派契約
This commit is contained in:
Your Name
@@ -635,6 +635,52 @@ Alert / Sentry / SigNoz / Gitea / Market Watch / Operator
|
||||
| `apps/api/src/services/ai_agent_communication_learning_contract.py` | 只讀 loader；強制驗證 runtime / migration / Telegram / SDK / route 權限都未開 |
|
||||
| `GET /api/v1/agents/agent-communication-learning-contract` | 治理 API；只回傳 committed contract，不啟動 worker、不碰 DB/Redis、不呼叫外部服務 |
|
||||
|
||||
#### 3.2.1c 2026-06-11 AI Agent 主動營運委派與版本生命週期契約
|
||||
|
||||
**核心裁決**：所有 AI Agent、套件、服務、工具、主機與網站前後台都要進版本生命週期；Agent 可以主動偵測、整理、評分、產生批准包，但不得自行升版、重啟、pull image、auto merge、發 Telegram 或改 production route。
|
||||
|
||||
**版本生命週期資料流：**
|
||||
|
||||
```text
|
||||
Repo / registry / release notes / K8s / host / observability / backup evidence
|
||||
→ Hermes 建立 version delta + changelog + SBOM / CVE / license 證據
|
||||
→ OpenClaw 仲裁風險、相依性、rollback、dry-run、Telegram action-required
|
||||
→ NemoTron 對 AI Agent / model / prompt / tool-call 變更跑 sanitized replay
|
||||
→ 產生 upgrade approval package / owner packet / PR plan
|
||||
→ 人工批准後才可進 draft PR / dry-run / smoke / canary
|
||||
→ 成功或失敗回寫 version_history / upgrade_outcomes / KM
|
||||
```
|
||||
|
||||
**可委派給 Agent 的工作全景：**
|
||||
|
||||
| 類別 | 可主動做 | 需批准才可做 | 主責 |
|
||||
|---|---|---|---|
|
||||
| 版本與依賴 | 版本發現、新鮮度、changelog 摘要、升級批准包 | 套件升級、lockfile 寫入、PR 建立、auto merge | Hermes / OpenClaw |
|
||||
| AI Agent / 模型 | 市場 watch、scorecard、sanitized replay 計畫 | SDK 安裝、付費 API、shadow/canary、生產路由 | NemoTron / OpenClaw |
|
||||
| 主機 / K3s / stateful | version skew 報告、maintenance window 草案 | apt upgrade、kernel / K3s / DB 升級、reboot、restart | OpenClaw |
|
||||
| 資安 / SBOM / CVE | SBOM/SCA 工具採用評估、CVE triage、license delta | 安裝 Trivy / OSV / Syft / Grype、外部掃描、修補套件 | Hermes / OpenClaw |
|
||||
| 監控與告警 | 告警噪音分析、Telegram 送達稽核、fallback gap | 改 Alertmanager route、receiver、silence、直接發 Bot | Hermes / OpenClaw |
|
||||
| 備份 / DR | 新鮮度、完整性、restore readiness、DR 批准包 | restore、prune、offsite sync、credential marker | OpenClaw |
|
||||
| 成本 / 容量 | resource / provider / fallback / cost delta 建議 | 增費、切付費 provider、修改 runtime limit | OpenClaw |
|
||||
| 前後台 / 文件 / KM | UI smoke、overflow、a11y、runbook / postmortem 草稿 | 修改 UI、寫 KM canonical、發布文件 | Hermes |
|
||||
| 合規 / owner response | evidence pack、owner packet、audit gap | 接受 owner response、開 runtime gate | Hermes / OpenClaw |
|
||||
|
||||
**本波已建立的可執行契約（只讀，不授權更新）：**
|
||||
|
||||
| 檔案 / API | 用途 |
|
||||
|---|---|
|
||||
| `docs/schemas/ai_agent_proactive_operations_contract_v1.schema.json` | 主動營運委派、版本生命週期、MCP、RAG、Telegram policy、approval boundary 契約 |
|
||||
| `docs/evaluations/ai_agent_proactive_operations_contract_2026-06-11.json` | 12 類版本 domain、24 類可委派能力、5 種 cadence、8 類 MCP、4 類 RAG memory；完成度 `30%` |
|
||||
| `apps/api/src/services/ai_agent_proactive_operations_contract.py` | 只讀 loader；強制 runtime update / package upgrade / host upgrade / workflow schedule / auto merge / Telegram direct send 全部 false |
|
||||
| `GET /api/v1/agents/agent-proactive-operations-contract` | 治理 API；只回傳 committed snapshot，不啟用排程、不升級、不呼叫付費服務 |
|
||||
|
||||
**採用順序：**
|
||||
|
||||
1. 先做 repo-only daily freshness：manifest / lockfile / Dockerfile / K8s YAML / runbook / snapshot。
|
||||
2. 再評估 external primary source weekly watch：Renovate、OSV-Scanner、Trivy、Syft、Grype、Kubernetes skew policy、Docker Scout。
|
||||
3. 再進 Gitea PR 草案 lane：grouping、automerge=false、tests、rollback、owner response。
|
||||
4. 最後才進人工批准後的 dry-run / smoke / canary / production rollout。
|
||||
|
||||
#### 3.2.2 核心缺口與災難場景
|
||||
|
||||
| 場景 | 現況 | 有 D2 協作後 |
|
||||
@@ -1267,6 +1313,7 @@ Alert / Sentry / SigNoz / Gitea / Market Watch / Operator
|
||||
| Agent Session 表 | DB migration | 新增 `agent_sessions` 表（session_id / agent_role / input_hash / output / latency）| L7×D2 |
|
||||
| 決策路由 | `services/decision_manager.py` | 新路徑：收到 EvidenceSnapshot → 送 Orchestrator → 等 Coordinator 結果 | L4×D2 |
|
||||
| 主動溝通與學習契約 | `docs/evaluations/ai_agent_communication_learning_contract_2026-06-11.json` + `GET /api/v1/agents/agent-communication-learning-contract` | 先固定 OpenClaw / Hermes / NemoTron 主動溝通、MCP、RAG、學習與 redaction 邊界；不啟動 runtime worker | L4×D2 / L7×D4 |
|
||||
| 主動營運委派與版本生命週期契約 | `docs/evaluations/ai_agent_proactive_operations_contract_2026-06-11.json` + `GET /api/v1/agents/agent-proactive-operations-contract` | 先固定 12 類版本 domain、24 類可委派能力、MCP/RAG/Telegram 邊界；不啟用排程、不自動升版 | L4×D2 / L7×D4 / L6×D6 |
|
||||
|
||||
**退出條件（量化）**
|
||||
|
||||
@@ -1632,6 +1679,12 @@ Phase 6 完成後
|
||||
- 新增 §3.4.3 智慧成長資料層補強，明確 Hot / Warm / Cold memory、MCP Gateway、PostgreSQL + pgvector、OpenTelemetry、Langfuse / Phoenix、Qdrant / Milvus 的採用順序。
|
||||
- Phase 2 核心改造項加入 `ai_agent_communication_learning_contract_v1` 與 `GET /api/v1/agents/agent-communication-learning-contract`，本波只讀、完成度 35%，未授權 worker / migration / Telegram / SDK / production route。
|
||||
|
||||
### 2026-06-11 21:30 (台北) — §3.2 / §5 — 新增 AI Agent 主動營運委派與版本生命週期契約 — 回應統帥要求讓 Agent 定期更新版本情報並專業評估更多可委派工作
|
||||
|
||||
- 新增 §3.2.1c，定義 AI Agent 可主動處理的版本生命週期、營運能力委派、自主等級、MCP/RAG/Telegram policy 與採用順序。
|
||||
- 新增 `ai_agent_proactive_operations_contract_v1` committed snapshot：12 類版本 domain、24 類可委派能力、5 種 cadence、8 類 MCP、4 類 RAG memory。
|
||||
- 新增 `GET /api/v1/agents/agent-proactive-operations-contract`；本波只讀，完成度 30%，未授權排程、升級、host update、container pull、auto merge、Telegram direct send、付費服務或 production route。
|
||||
|
||||
### 2026-04-15 (台北) — 全檔 — 建立 v2 骨架，§0/§1 完成 — 統帥批准「單 MASTER + 4 道閘門」結構
|
||||
|
||||
- 從 v1（plans/2026-04-15-MASTER-ai-autonomous-flywheel.md）繼承核心發現
|
||||
|
||||
Reference in New Issue
Block a user