docs(adr): 更新 ADR-006/009/015 狀態
ADR-015: 標記為「已實作」✅ (Phase 16 R1 完成) ADR-009: 標記為「已實作」✅ (Phase 9.1-9.5 全部完成) ADR-006: 新增智能路由整合章節 (Phase 13.3) 首席架構師 ADR 審計 P0/P1 完成 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -286,11 +286,84 @@ AI 用量監控面板應顯示:
|
||||
|
||||
---
|
||||
|
||||
---
|
||||
|
||||
## 智能路由整合 (Phase 13.3 - 2026-03-26)
|
||||
|
||||
> 參考: [ADR-016 智能路由](ADR-016-smart-routing.md)
|
||||
|
||||
Phase 13.3 引入**智能路由**機制,動態選擇最適合的模型:
|
||||
|
||||
### 路由決策流程
|
||||
|
||||
```
|
||||
User Request
|
||||
│
|
||||
▼
|
||||
┌─────────────┐
|
||||
│ Intent │ 分類意圖 (ALERT/QUERY/CODE_REVIEW/...)
|
||||
│ Classifier │
|
||||
└─────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────┐
|
||||
│ Complexity │ 評估複雜度 (1-5)
|
||||
│ Scorer │
|
||||
└─────────────┘
|
||||
│
|
||||
▼
|
||||
┌─────────────┐
|
||||
│ AIRouter │ Intent + Complexity → Model Selection
|
||||
└─────────────┘
|
||||
│
|
||||
├── Low (1-2) → Ollama llama3.2:3b
|
||||
├── Medium (3) → Ollama qwen2.5:7b-instruct
|
||||
└── High (4-5) → Gemini / Claude
|
||||
```
|
||||
|
||||
### 意圖覆寫規則
|
||||
|
||||
| 意圖 | 強制模型 | 原因 |
|
||||
|------|---------|------|
|
||||
| CODE_REVIEW | qwen2.5:7b | 需要程式碼理解能力 |
|
||||
| ALERT_TRIAGE (複雜) | Cloud | 多服務關聯分析 |
|
||||
| QUERY | llama3.2:3b | 簡單查詢不需大模型 |
|
||||
|
||||
### 與原有 Fallback 整合
|
||||
|
||||
```
|
||||
AIRouter 選擇模型
|
||||
│
|
||||
▼
|
||||
┌─────────────┐
|
||||
│ Primary │ (依路由決策選擇)
|
||||
│ Model │
|
||||
└─────────────┘
|
||||
│ 失敗
|
||||
▼
|
||||
┌─────────────┐
|
||||
│ Fallback │ ADR-006 原有順序
|
||||
│ Chain │ Ollama → Gemini → Claude → Static
|
||||
└─────────────┘
|
||||
```
|
||||
|
||||
### 實作位置
|
||||
|
||||
```
|
||||
apps/api/src/services/
|
||||
├── intent_classifier.py # IntentClassifier
|
||||
├── complexity_scorer.py # ComplexityScorer
|
||||
└── ai_router.py # AIRouter
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 變更記錄
|
||||
|
||||
| 日期 | 版本 | 變更 | 作者 |
|
||||
|------|------|------|------|
|
||||
| 2026-03-20 | v1.0 | 初版建立 | CTO |
|
||||
| 2026-03-26 | v1.1 | 新增智能路由整合章節 (Phase 13.3) | 首席架構師 |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
# ADR-009: OpenClaw Agent Teams 架構
|
||||
|
||||
**狀態**: 提議中 → 研究完成
|
||||
**狀態**: **已實作** ✅
|
||||
**日期**: 2026-03-23
|
||||
**實作完成**: 2026-03-24 (Phase 9.1-9.5 全部完成)
|
||||
**決策者**: 統帥 + AI 架構師
|
||||
**Phase**: 9.1-9.2 (SDK 研究 + 架構設計)
|
||||
**Phase**: 9.1-9.5 (SDK 研究 → 完整實作)
|
||||
|
||||
## 背景
|
||||
|
||||
@@ -511,18 +512,32 @@ class OpenClawRouter:
|
||||
return severity in ["P3", "P4"] and len(affected) <= 1
|
||||
```
|
||||
|
||||
## 實作計劃 (更新版)
|
||||
## 實作驗收 (2026-03-24)
|
||||
|
||||
| Phase | 內容 | 狀態 | 預估 |
|
||||
| Phase | 內容 | 狀態 | 實際 |
|
||||
|-------|------|------|------|
|
||||
| 9.1 | ADR 審核 + SDK 研究 | ✅ 完成 | 0.5 天 |
|
||||
| 9.2 | SDK 整合 + POC | 🔜 下一步 | 1 天 |
|
||||
| 9.3 | 3 專家 Agent 實作 | | 2 天 |
|
||||
| 9.4 | ConsensusEngine + leWOOOgo 整合 | | 1.5 天 |
|
||||
| 9.5 | API 端點 + UI 呈現 | | 1.5 天 |
|
||||
| 9.6 | 測試 + 文檔 + ADR-006 整合 | | 1 天 |
|
||||
| 9.2 | SDK 整合 + POC | ✅ 完成 | 1 天 |
|
||||
| 9.3 | 3 專家 Agent 實作 | ✅ 完成 | 1.5 天 |
|
||||
| 9.4 | ConsensusEngine + leWOOOgo 整合 | ✅ 完成 | 1 天 |
|
||||
| 9.5 | API 端點 + UI 呈現 | ✅ 完成 | 1 天 |
|
||||
|
||||
**總計: 7.5 天** (原估 10 天,因 SDK 簡化減少)
|
||||
**總計: 5 天** (比預估提前完成)
|
||||
|
||||
### 實作檔案
|
||||
|
||||
```
|
||||
apps/api/src/agents/
|
||||
├── __init__.py
|
||||
├── security_agent.py # SecurityAgent
|
||||
├── blast_radius_agent.py # BlastRadiusAgent
|
||||
├── action_planner_agent.py # ActionPlannerAgent
|
||||
└── coordinator.py # OpenClawCoordinator
|
||||
|
||||
apps/api/src/services/
|
||||
├── consensus_engine.py # ConsensusEngine
|
||||
└── openclaw_team.py # OpenClawTeam 整合
|
||||
```
|
||||
|
||||
### Phase 9.2 POC 驗證項目
|
||||
|
||||
|
||||
@@ -2,8 +2,9 @@
|
||||
|
||||
| 欄位 | 值 |
|
||||
|------|-----|
|
||||
| **狀態** | 已批准 |
|
||||
| **狀態** | **已實作** ✅ |
|
||||
| **決策日期** | 2026-03-26 |
|
||||
| **實作完成** | 2026-03-26 (Phase 16 R1) |
|
||||
| **決策者** | 統帥 + 首席架構師 |
|
||||
| **觸發原因** | Code Review 發現嚴重模組化違規 |
|
||||
|
||||
@@ -132,6 +133,22 @@ async def call_tool(self, server_name: str, tool_name: str, parameters: dict):
|
||||
|
||||
---
|
||||
|
||||
## 實作驗收 (2026-03-26)
|
||||
|
||||
| 項目 | 狀態 |
|
||||
|------|------|
|
||||
| interfaces.py | ✅ 已建立 MCPToolProvider ABC |
|
||||
| registry.py | ✅ 已建立 ProviderRegistry |
|
||||
| k8s_provider.py | ✅ 已實作 |
|
||||
| signoz_provider.py | ✅ 已實作 |
|
||||
| database_provider.py | ✅ 已實作 |
|
||||
| mcp_bridge.py 重構 | ✅ 透過 DI 注入 |
|
||||
| 測試驗證 | ✅ 28/28 通過 |
|
||||
|
||||
**驗收人**: 首席架構師 (Phase 16 R1.3 審查)
|
||||
|
||||
---
|
||||
|
||||
## 相關文件
|
||||
|
||||
- [feedback_modular_architecture.md](../../memory/feedback_modular_architecture.md)
|
||||
|
||||
Reference in New Issue
Block a user