Merge remote-tracking branch 'origin/master' into ji
This commit is contained in:
吉鑫升 committed
commit
b671b49725
17 files changed
+2784
-130
No files matched your search
@@ -10,14 +10,16 @@
|
||||
|
||||
## 0. 速读
|
||||
|
||||
- 三个圆桌 Router（`intent / recommend / multi_agent`）**全部走 HTTP loopback**：在同进程内通过 `httpx.AsyncClient` 调本机 `127.0.0.1` 的 `/api/threads`、`/api/agents`、`/api/threads/{id}/runs/stream`。
|
||||
- **所有 loopback `httpx.AsyncClient` 必须 `trust_env=False`**。开发机若设了 `HTTP_PROXY` / `HTTPS_PROXY`，httpx 默认会把 loopback 也走代理 → 不可达 → 单次请求多出 40 秒超时（典型症状日志：`headers_in=42.160s`）。
|
||||
- 三个圆桌 Router（`intent / recommend / multi_agent`）**通过 httpx ASGITransport 进程内直调本机 ASGI app**，复用既有 `/api/threads`、`/api/agents`、`/api/threads/{id}/runs/stream` 路由——**不走 TCP / 不经过网络栈**。所有 client 都由 `multi_agent._make_loopback_client(request)` 工厂统一构造。
|
||||
- 历史包袱：早期实现走 `httpx.AsyncClient(trust_env=False)` + `127.0.0.1:<port>`，遇到开发机 `HTTP_PROXY` / `HTTPS_PROXY` 时仍可能把回环走代理（症状 `headers_in=42.160s`）。**改用 ASGITransport 后此问题不再存在**，相关 `trust_env=False` workaround 全部移除。
|
||||
- **席位 agent 持久注册**（磁盘 `.deer-flow/agents/` + `_sync_legacy_agents`），**协调智能体每次新建**（命名 `roundtable-coordinator-{timestamp36}`，DB 累积，需后续 GC）。
|
||||
- **`.deer-flow/` 整个目录被 git ignore**（仓库根 `.gitignore` 第 64 / 74 行），`git clone` 后内置 agent 目录在部署机上**不会存在**——任何环境都必须把 `roundtable-intent` + `roundtable-recommender` 两个**功能型 agent** 持久化进发布物，否则 `/api/intent/stream` 报 500。**互联网 demo 还需要 6 个示例研讨席位**（`roundtable-intelligence` 等），**内网部署用客户自有 agent 替代**这些席位，无需打包。详见 §11.7。
|
||||
- **`init` 是 SSE 而非一次性 JSON**：用 `asyncio.as_completed` 按真实完成顺序推送 `seat_ready`，前端因此能逐个点亮席位。
|
||||
- **`init_done.thread_ids` 包含协调智能体自身**（`agent_threads[main_agent_name] = coord_thread`），前端 Step 3 列文件时需自行过滤。
|
||||
- **澄清协议统一**：Step 1 与 Step 2 leader 都借 `ask_clarification` + 终态 `clarification` 帧驱动同一套选项卡片组件；`allow_multiple` 默认 false（单选、点击即发送）。
|
||||
- **leader 共识 = `status: []` 空数组**；澄清 = `status: "clarification"`（字符串）；派活 = `status: [[name, task], ...]`。这三者**互斥不混用**。
|
||||
- **后端 picks clamp 2–6，前端用户可手动加到 8**。
|
||||
- **不写死任何具体模型名**：`intent / recommend / multi_agent` 三个 router 的 `model_name = str(payload.get("model") or "")`，空串会被下游 `lead_agent._resolve_model_name()` 自动回退到 `config.yaml` 的 `models[0]`（与 `/api/ai-writing` 行为一致）。内网部署只需配 `config.yaml`，前后端均无需改硬编码。
|
||||
|
||||
---
|
||||
|
||||
@@ -57,7 +59,7 @@ Step 3 最终方案展示
|
||||
| 2 | 2 | `multi_agent.py` | 协调智能体（每次新建）+ 用户选定的 `roundtable-*` 席位 |
|
||||
| 3 | 3 | `artifacts.py`（通用） | 无新 agent |
|
||||
|
||||
所有接口需 `Authorization: Bearer <JWT>`。Loopback 调用统一 `trust_env=False`，避免本机 `HTTP_PROXY` 把 `127.0.0.1` 指到不可达代理（症状：`headers_in=40s+`，前端表现为「Step 1 init 卡顿 / Step 2 init 永远不发 seat_ready」）。
|
||||
所有接口需 `Authorization: Bearer <JWT>`。Loopback 调用一律由 `_make_loopback_client(request)` 构造（`httpx.ASGITransport(app=request.app)`，base_url 占位 `http://loopback`），**不经 TCP**，因此不再受本机 `HTTP_PROXY` 干扰。
|
||||
|
||||
---
|
||||
|
||||
@@ -497,7 +499,7 @@ async def _broadcast(client, base, headers, message, agent_threads, skip):
|
||||
(None, captured) — 流结束，captured 是所有 data: 行的字符串列表
|
||||
```
|
||||
|
||||
日志 `[upstream-timing] <agent> headers_in=<>` / `first_line=<>`：排查首 token 慢、代理导致 loopback 超时（见 `trust_env=False`）。
|
||||
日志 `[upstream-timing] <agent> headers_in=<>` / `first_line=<>`：排查上游首字节延迟；改 ASGITransport 后通常 `headers_in` < 10ms，长尾大概率出在路由 handler 内部（不再是网络/代理问题）。
|
||||
|
||||
`_parse_last_messages(captured)` 从倒数往前扫，**跳过 trailing `data: null` end 帧**，找第一条解析为 dict 且含 `messages` key 的 frame；取 `messages` 列表。无可解析帧抛 `502`。
|
||||
|
||||
@@ -591,14 +593,21 @@ Step 3 **没有** 单独的 `multi_agent` 路由；使用既有 artifacts 能力
|
||||
|
||||
## 9. 关键设计决策
|
||||
|
||||
### 9.1 HTTP loopback + `trust_env=False`
|
||||
### 9.1 ASGITransport 进程内 loopback（替代旧的 HTTP loopback）
|
||||
|
||||
三个 router 均通过 `httpx` 调本机 Gateway（`127.0.0.1`），复用鉴权与 LangGraph 路由，代价是额外 HTTP 开销；init 已用 `asyncio.as_completed` 并行化席位准备。
|
||||
三个 router 通过 `httpx.ASGITransport(app=request.app)` 直调本机 ASGI app，**不走 TCP / 不开 socket / 不经网络栈**，但仍然完整复用 FastAPI 路由分发、鉴权 middleware、Pydantic 校验、SSE 流式响应。代价仅是路由层的少量 dispatch 开销（< 1ms），相对 LLM run 本身的数百 ms~数十秒可忽略。
|
||||
|
||||
**每个 `httpx.AsyncClient(timeout=None, trust_env=False)` 都是必须的**：
|
||||
统一入口：`multi_agent._make_loopback_client(request)`，返回：
|
||||
|
||||
- `timeout=None` — SSE 长连接需要
|
||||
- `trust_env=False` — 否则 httpx 会读取 `HTTP_PROXY` / `HTTPS_PROXY` 环境变量，把 loopback `127.0.0.1` 也走代理。开发机常配的「校园网代理 / 公司代理」会把回环地址丢弃，导致单次请求 40+ 秒超时（日志典型症状：`headers_in=42.160s`）
|
||||
```python
|
||||
httpx.AsyncClient(
|
||||
transport=httpx.ASGITransport(app=request.app),
|
||||
base_url="http://loopback", # 占位 host，ASGITransport 不在意
|
||||
timeout=None, # SSE 长连接仍需 None
|
||||
)
|
||||
```
|
||||
|
||||
**已废止的 `trust_env=False` workaround**：旧版本走 `127.0.0.1:<port>` 真实 HTTP，需要 `trust_env=False` 阻止 httpx 读 `HTTP_PROXY` 把回环也走代理（症状日志 `headers_in=42.160s`）。改 ASGITransport 后这个问题在物理上已不存在——根本没走网络栈。
|
||||
|
||||
### 9.2 协调智能体每次新建
|
||||
|
||||
@@ -664,12 +673,249 @@ grep "special-timing" .runtime/logs/*.log # payload_built / first_upstream_l
|
||||
|
||||
`model` 写入 run 的 `context.model_name`；前端可按席位覆盖 special 调用的模型（见前端文档 §5.5 Persona 抽屉）。
|
||||
|
||||
**绝不在路由里硬编码具体模型名**。三个 router 一律 `str(payload.get("model") or "")`：
|
||||
|
||||
- 前端不传 / 传空串 → 下游 `lead_agent._resolve_model_name("")` 命中 falsy 分支，返回 `app_config.models[0].name`（`config.yaml` 配置顺序里的第一项）
|
||||
- 前端传了一个不在 `config.yaml` 里的 model 名 → 同样回退到首项，并 `logger.warning("Model 'x' not found ... fallback to ...")`
|
||||
- 前端传了合法 model 名 → 直接使用
|
||||
|
||||
这是 `/api/ai-writing` 与圆桌三路由的统一行为，让本地 / 内网部署只需要改 `config.yaml`，不需要触前端常量或路由代码。详见 `deerflow/agents/lead_agent/agent.py:_resolve_model_name`。
|
||||
|
||||
### 11.3 新增席位
|
||||
|
||||
1. `.deer-flow/agents/roundtable-xxx/` 增加 `config.yaml` + `SOUL.md`
|
||||
2. 前端候选池 / 推荐逻辑纳入该 id
|
||||
3. Step 2 `agent_names` 传入即可 — **multi_agent 路由无需改**
|
||||
|
||||
### 11.7 内置 agent 部署持久化（必读，关系到内网部署能否启动）
|
||||
|
||||
#### 11.7.1 问题背景
|
||||
|
||||
圆桌功能涉及的 agent 都靠**磁盘文件**激活（`.deer-flow/agents/<id>/{config.yaml,SOUL.md}`），但仓库根 `.gitignore` 第 64 / 74 行有：
|
||||
|
||||
```
|
||||
offline-backend-20260512/backend/.deer-flow/*
|
||||
```
|
||||
|
||||
整个 `.deer-flow/` 被 git 排除。新机器 `git clone` 后 `.deer-flow/agents/` 不存在 → 圆桌相关 agent 缺失 → 进入 `/api/intent/init` 后 `_create_thread` 本身能成功，但下一步 `/api/intent/stream` 真正调用 LangGraph 时会因为 agent 解析失败抛 500（典型表现：前端 Step 1 init 一次成功，下一句话发出去就 500）。
|
||||
|
||||
#### 11.7.1.1 哪些 agent **必须**打包，哪些**不需要**
|
||||
|
||||
圆桌涉及的 agent 分**两类**，部署侧需求完全不同：
|
||||
|
||||
| Agent | 角色 | 是否必须打包发布 |
|
||||
|-------|------|------------------|
|
||||
| `roundtable-intent` | **功能型**：Step 1 任务理解，所有部署都用它 | ✅ **必须**（任何环境） |
|
||||
| `roundtable-recommender` | **功能型**：Step 1→2 之间从候选池里挑推荐，所有部署都用它 | ✅ **必须**（任何环境） |
|
||||
| `roundtable-intelligence` | 示例研讨席位（情报收集） | ⚠️ **互联网 demo 用**，内网不需要 |
|
||||
| `roundtable-environment` | 示例研讨席位（环境评估） | ⚠️ 同上 |
|
||||
| `roundtable-solution-design` | 示例研讨席位（方案设计） | ⚠️ 同上 |
|
||||
| `roundtable-risk-review` | 示例研讨席位（风险审查） | ⚠️ 同上 |
|
||||
| `roundtable-execution-plan` | 示例研讨席位（执行规划） | ⚠️ 同上 |
|
||||
| `roundtable-summary` | 示例研讨席位（总结陈述） | ⚠️ 同上 |
|
||||
| `roundtable-coordinator-*` | 协调智能体壳，每次会话动态新建 | ❌ **不打包**（运行时生成） |
|
||||
|
||||
**关键区分**：
|
||||
- `roundtable-intent` / `roundtable-recommender` 是**圆桌功能本身的一部分**——没有它们，整个 Step 1 + 推荐流程跑不起来，跟客户业务无关
|
||||
- 6 个 `roundtable-<领域>` 席位只是**互联网 demo 用的示例研讨者**，让访客打开页面就能看到完整三步流程。内网部署面对的是客户自己的业务场景，会把客户自有的领域 agent（行业专家、合规审查员、业务规则引擎……）注册成候选 agent；这时 6 个示例席位反而成噪声
|
||||
|
||||
**对应的部署组合**：
|
||||
|
||||
| 部署场景 | 打包内容 |
|
||||
|----------|----------|
|
||||
| **互联网 demo** | `roundtable-intent` + `roundtable-recommender` + **6 个示例席位** |
|
||||
| **内网客户部署** | `roundtable-intent` + `roundtable-recommender`（仅此 2 个，**不带** 6 个示例席位） |
|
||||
| **本地开发** | 全要（方便快速跑通） |
|
||||
|
||||
**内网部署的额外注意**（去掉 6 个示例席位时）：
|
||||
|
||||
1. **客户自有的候选 agent 必须先存在**：内网部署落地时，客户的业务 agent 应该已经注册进 `.deer-flow/agents/`（手工建目录或通过 `POST /api/agents` 创建）。否则候选池为空，推荐拿不到任何 picks。
|
||||
2. **前端 `FALLBACK_AGENT_IDS` 需要适配**：前端 `RecommendAgentsDialog.tsx` 里硬编码了 6 个示例席位 id 作为 fallback；若推荐失败回退路径会拿这 6 个去 `candidates` 里交集，内网部署该交集恒为空，**fallback 会失败**。建议要么：
|
||||
- **方案 1**（最稳）：内网客户的候选池足够丰富 + recommender SOUL 调好，让推荐成功率 ~100%，不依赖 fallback
|
||||
- **方案 2**：把 `FALLBACK_AGENT_IDS` 改成从后端 `/api/agents` 取前 6 个 `published=true` 的候选 agent（动态 fallback）。改动点见前端文档 §6.2 `RecommendAgentsDialog`
|
||||
3. **推荐 SOUL（`roundtable-recommender/SOUL.md`）通常无需改**：SOUL 本身没写死候选 id，只描述「从给的候选池里挑」；候选池由前端传入，模型读到客户自有 agent 后会照样工作。
|
||||
|
||||
下文给出三种修复方案，**推荐方案 A**（最简单，无需写代码）。
|
||||
|
||||
#### 11.7.2 方案 A：`.gitignore` 白名单（推荐）
|
||||
|
||||
让 git 只跟踪 **`roundtable-intent` + `roundtable-recommender` 两个功能型 agent** 的 `config.yaml` 与 `SOUL.md`，其它一律忽略。6 个示例席位**不进白名单**——互联网 demo 部署机如果需要它们，按 §11.7.2.A 在该分支单独追加白名单；内网部署机直接享受「干净的 `.deer-flow/`」。
|
||||
|
||||
**步骤 1：编辑仓库根 `.gitignore`**
|
||||
|
||||
在最后追加白名单段（位置很重要，**必须在 `offline-backend-20260512/backend/.deer-flow/*` 之后**，否则被前面的通配符吃掉）：
|
||||
|
||||
```gitignore
|
||||
# === 圆桌功能型 agent 跟随仓库发布(任何部署都需要) ===
|
||||
# 父目录先 unignore,git 才能往下递归
|
||||
!offline-backend-20260512/backend/.deer-flow/
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/
|
||||
# 仅放行 2 个功能型 agent;6 个示例席位由互联网分支自行放行
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-intent/
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-intent/config.yaml
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-intent/SOUL.md
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-recommender/
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-recommender/config.yaml
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-recommender/SOUL.md
|
||||
```
|
||||
|
||||
⚠️ **不要**直接写 `!offline-backend-20260512/backend/.deer-flow/agents/roundtable-intent/**`——`git` 不会进入还在 ignore 的父目录，必须逐层 un-ignore，再精确放行文件。
|
||||
|
||||
**步骤 2：强制 add 并提交**
|
||||
|
||||
```bash
|
||||
# 验证白名单生效
|
||||
git check-ignore -v offline-backend-20260512/backend/.deer-flow/agents/roundtable-intent/config.yaml
|
||||
# 期望输出无任何匹配,或最后一条匹配是上面的 ! 行
|
||||
|
||||
# 加入索引(只加 2 个功能型 agent)
|
||||
git add offline-backend-20260512/backend/.deer-flow/agents/roundtable-intent
|
||||
git add offline-backend-20260512/backend/.deer-flow/agents/roundtable-recommender
|
||||
|
||||
git status # 应只看到 2 × 2 = 4 个新文件,绝不出现 users/、threads/、data/、6 个示例席位
|
||||
|
||||
git commit -m "chore: 把圆桌功能型 agent(intent + recommender)纳入版本管理"
|
||||
```
|
||||
|
||||
**步骤 3：部署机验证**
|
||||
|
||||
```bash
|
||||
# clone 之后立刻
|
||||
ls offline-backend-20260512/backend/.deer-flow/agents/
|
||||
# 内网部署:应看到 roundtable-intent/ + roundtable-recommender/(+ 客户自有 agent)
|
||||
# 互联网 demo:还应看到 6 个 roundtable-<领域>/ 示例席位
|
||||
```
|
||||
|
||||
启动后端，前端打开圆桌规划页，Step 1 第一句话发出去能正常拿到 streaming 响应而不是 500，就说明 OK。
|
||||
|
||||
##### 11.7.2.A 互联网 demo 分支：追加 6 个示例席位
|
||||
|
||||
互联网 demo 维护一条独立分支（或独立 `.gitignore` 段，用 build flag 切），在白名单后追加：
|
||||
|
||||
```gitignore
|
||||
# === 仅互联网 demo 需要的 6 个示例研讨席位 ===
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-intelligence/
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-intelligence/config.yaml
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-intelligence/SOUL.md
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-environment/
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-environment/config.yaml
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-environment/SOUL.md
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-solution-design/
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-solution-design/config.yaml
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-solution-design/SOUL.md
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-risk-review/
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-risk-review/config.yaml
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-risk-review/SOUL.md
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-execution-plan/
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-execution-plan/config.yaml
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-execution-plan/SOUL.md
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-summary/
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-summary/config.yaml
|
||||
!offline-backend-20260512/backend/.deer-flow/agents/roundtable-summary/SOUL.md
|
||||
```
|
||||
|
||||
`git add` 对应 6 个目录、提交，互联网分支即拿到全部 8 个内置 agent。两条分支共享同一份 `roundtable-intent / roundtable-recommender`，SOUL 调整对两边都生效，避免双维护。
|
||||
|
||||
**优点**：
|
||||
|
||||
- 零代码改动；新机器 `git clone` 即可，部署文档不用单独说「记得拷一下 `.deer-flow/agents/`」
|
||||
- 修改 SOUL 直接走 git 走 review 流程
|
||||
- 多人协作时 SOUL 改动可见
|
||||
|
||||
**注意事项**：
|
||||
|
||||
- `git status` 检查时确保**只**有 16 个内置文件进了索引，**绝对不能**包括 `users/`、`threads/`、`data/*.db`、`roundtable-coordinator-*/` 这些运行时数据
|
||||
- `roundtable-coordinator-mp*/` 这类历史会话残留目录会被 ignore 规则自动忽略（白名单没放行它们），无需手动清理
|
||||
- 部署机如果之前手动建过 `.deer-flow/agents/roundtable-intent/`，`git pull` 会把仓库版本覆盖上去——这是期望行为
|
||||
|
||||
#### 11.7.3 方案 B：源码内置 + 启动时种子化
|
||||
|
||||
如果不想让 `.deer-flow/` 这种「运行时目录」出现在 git 里，可以把 SOUL/config 放进 `packages/harness/` 里作为只读资源，启动时检查 `.deer-flow/agents/<id>/` 不存在就从源拷过去。
|
||||
|
||||
**步骤大纲**：
|
||||
|
||||
1. 在 `packages/harness/deerflow/agents/builtin_personas/` 下建 8 个目录（`roundtable-intent/` 等），把 SOUL.md + config.yaml 搬过去
|
||||
2. 在 `app/gateway/app.py` 的 `lifespan` 启动阶段新增 `_seed_builtin_roundtable_agents()`：
|
||||
```python
|
||||
def _seed_builtin_roundtable_agents() -> None:
|
||||
from importlib.resources import files
|
||||
src_root = files("deerflow.agents.builtin_personas")
|
||||
dst_root = get_paths().agents_dir() # .deer-flow/agents/
|
||||
for agent_id in BUILTIN_ROUNDTABLE_AGENT_IDS: # 8 个常量
|
||||
dst = dst_root / agent_id
|
||||
if dst.exists():
|
||||
continue # 已有(可能是用户改过的),不覆盖
|
||||
dst.mkdir(parents=True)
|
||||
for fname in ("config.yaml", "SOUL.md"):
|
||||
(dst / fname).write_bytes((src_root / agent_id / fname).read_bytes())
|
||||
```
|
||||
3. 紧接着调一次 `_sync_legacy_agents(store)`，把这些刚落地的目录 upsert 进 `agents` 表
|
||||
4. 把 `BUILTIN_ROUNDTABLE_AGENT_IDS` 常量也导出给 `recommend.py` / `multi_agent.py` 共享
|
||||
|
||||
**优点**：
|
||||
|
||||
- `.deer-flow/` 仍然作为「运行时数据目录」语义干净
|
||||
- 运维可以手动改 `.deer-flow/agents/roundtable-intent/SOUL.md` 临时调试，重启不被覆盖（`if dst.exists(): continue`）
|
||||
- 升级时如果想强制刷新，加个 `--force-reseed-builtins` 启动参数即可
|
||||
|
||||
**缺点**：
|
||||
|
||||
- 多一段 bootstrap 代码 + 一份 `pyproject.toml` 的 `package-data` 声明（确保 SOUL.md 跟着 wheel 一起发布）
|
||||
- 「现场改 SOUL 不被覆盖」既是优点也是坑——A 改了 SOUL 但忘了同步源码，下次新机器部署又回到旧版本
|
||||
|
||||
#### 11.7.4 方案 C：纯运维流程（最弱，不推荐）
|
||||
|
||||
不动代码、不动 .gitignore，发布说明里写一行：
|
||||
|
||||
> 部署前请将 `<开发机>:offline-backend-20260512/backend/.deer-flow/agents/` 整个目录 `scp` 到部署机同位置。
|
||||
|
||||
只在「不允许改仓库结构」或「初期试跑」时用。长期维护几乎一定会有人忘记拷而部署失败。
|
||||
|
||||
#### 11.7.5 方案选择决策
|
||||
|
||||
| 场景 | 推荐方案 |
|
||||
|------|----------|
|
||||
| 单仓库多人协作、SOUL 经常调整 | **A**（.gitignore 白名单） |
|
||||
| SOUL 极少改，希望严格区分代码与运行时数据 | **B**（源码 + lifespan 种子化） |
|
||||
| 一次性 POC / 即将切换到 B | C |
|
||||
|
||||
无论选哪种，部署机第一次启动后都建议跑这条 smoke test 验证：
|
||||
|
||||
```bash
|
||||
curl -X POST http://127.0.0.1:8001/api/intent/init \
|
||||
-H "Authorization: Bearer <TOKEN>" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{}'
|
||||
# 期望: 200 + {"status":"success","agent_id":"roundtable-intent","thread_id":"..."}
|
||||
|
||||
curl -X POST http://127.0.0.1:8001/api/intent/stream \
|
||||
-H "Authorization: Bearer <TOKEN>" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"thread_id":"<上一步返回的>","message":"测试一下"}'
|
||||
# 期望: 200 + SSE 长连接,最后一帧 status 为 asking 或 clarification
|
||||
# 若 500 → 看后端日志,大概率是 SOUL.md 找不到或 LLM 外网不通(看上一条排查项)
|
||||
```
|
||||
|
||||
#### 11.7.6 推荐智能体（`roundtable-recommender`）与研讨席位的关系（注：完整定制流程见 §11.8）
|
||||
|
||||
推荐路由 `recommend.py` 用到的 `roundtable-recommender` 与「研讨席位」是**两件事**：
|
||||
|
||||
- **`roundtable-recommender`**：负责从候选池里挑 picks 的「推荐者」本身，是个 LLM agent，**功能型**，所有部署必须有
|
||||
- **研讨席位**（无论是 6 个示例还是客户自有 agent）：是「被挑选的候选」，前端 `filterRecommendCandidates` 过滤后送进 `/api/recommend/stream` 的 `candidates` 数组；recommender 在 SOUL 里看到候选池后才能输出 `[RECOMMEND_READY]` JSON
|
||||
|
||||
「推荐改成动态」改的是**从池子里挑哪几个**，不是「池子可以没有」。**池子的来源在两类部署里不同**：
|
||||
|
||||
| 部署 | 候选池来源 |
|
||||
|------|------------|
|
||||
| 互联网 demo | 仓库自带的 6 个 `roundtable-<领域>` 示例席位（+ 用户自建的） |
|
||||
| 内网客户 | 客户自有的业务 agent（通过 `POST /api/agents` 或 `.deer-flow/agents/<id>/` 注册）|
|
||||
|
||||
`roundtable-recommender/SOUL.md` 本身没写死任何候选 id（只描述「从给的候选池里挑」），所以内网部署即使候选池从「6 个示例」换成「客户自有 agent」，**recommender 的 SOUL 无需改动**，候选池由前端传入。
|
||||
|
||||
**前端 fallback 行为差异**：
|
||||
|
||||
互联网 demo 因为有这 6 个内置示例席位垫底，推荐失败时 `FALLBACK_AGENT_IDS ∩ candidates` 还能拿到回退选项；**内网部署该交集恒为空**，回退路径失效——所以内网部署应通过「候选池足够丰富 + recommender SOUL 调好」让推荐成功率接近 100%，或改造前端 `FALLBACK_AGENT_IDS` 为动态从 `/api/agents` 取前 N 个（见前端文档 §6.2）。
|
||||
|
||||
### 11.4 新增 Step 1 工具
|
||||
|
||||
若需新工具，须同步修改 `intent.py` 的 `excluded_tools` 黑名单（当前默认禁 15 个工具，仅 `ask_clarification` 实际可用）。
|
||||
@@ -682,6 +928,181 @@ grep "special-timing" .runtime/logs/*.log # payload_built / first_upstream_l
|
||||
|
||||
`_append_thread_message` 通过 `GET state → mutate → POST state` 实现，是为了与 LangGraph checkpoint 一致；如果将来 Gateway 提供 `POST /api/threads/{id}/messages/append` 这类原子接口，可换上，降低并发竞争（虽然圆桌当前不会并发广播同一 thread）。
|
||||
|
||||
### 11.8 添加 / 替换任务推荐智能体（`roundtable-recommender`）
|
||||
|
||||
推荐智能体 id 在后端是**硬编码**常量（`recommend.py:63` → `RECOMMENDER_AGENT_ID = "roundtable-recommender"`），路由不接收 `agent_id` 参数。因此「添加推荐智能体」**不是新增一个 id**，而是落地这个固定 id 对应的文件（首次部署）或**就地改 SOUL**（定制行为）。
|
||||
|
||||
#### 11.8.1 何时需要动它
|
||||
|
||||
| 场景 | 是否需要动 SOUL |
|
||||
|------|-----------------|
|
||||
| 全新部署，目录还不存在 | ✅ 必须先把目录搭起来（§11.8.2） |
|
||||
| 候选池从 6 个互联网示例换成客户自有 agent | ❌ **不用改**——SOUL 没写死候选 id，候选池由前端传入 |
|
||||
| 想改变推荐风格（更激进 / 更保守 / 偏好某领域） | ✅ 改 SOUL（§11.8.4） |
|
||||
| 想让模型偏好你新加的领域 agent | ⚠️ **优先**改新 agent 的 `description`（候选池 prompt 用的就是它），其次才改 recommender SOUL |
|
||||
| 想改输出 JSON 格式 | ❌ **不要**——后端正则 `_RECOMMEND_READY_PATTERN` 写死了 `[RECOMMEND_READY]` + ```json ``` 块；改 SOUL 输出会让后端解析失败走 fallback |
|
||||
|
||||
#### 11.8.2 标准目录结构
|
||||
|
||||
```
|
||||
.deer-flow/agents/roundtable-recommender/
|
||||
├── config.yaml # id / name / description(只是 DB 元数据,不进 prompt)
|
||||
└── SOUL.md # 行为契约,详见 11.8.4
|
||||
```
|
||||
|
||||
**`config.yaml` 模板**（**id 必须严格等于 `roundtable-recommender`**，否则 `recommend.py` 找不到）：
|
||||
|
||||
```yaml
|
||||
description: 智能体推荐专员,基于用户的任务目标与约束,从候选智能体池中挑选最相关的 2-6 个智能体并给出推荐理由,为多智能体圆桌研讨准备最终参会名单
|
||||
id: roundtable-recommender
|
||||
name: 智能体推荐
|
||||
```
|
||||
|
||||
字段说明：
|
||||
- `id`：**不可改**，与 `RECOMMENDER_AGENT_ID` 常量绑死
|
||||
- `name`：DB 显示名，候选池过滤时不参与（`filterRecommendCandidates` 按 id 排除）
|
||||
- `description`：DB 元数据，不进 prompt；改了不会影响推荐效果
|
||||
|
||||
**SOUL.md** 内容见 §11.8.4 模板。新增之后按 §11.7.2 把这两个文件加入 git 白名单 + commit 即可。
|
||||
|
||||
#### 11.8.3 后端给推荐智能体喂的 prompt 长什么样
|
||||
|
||||
`recommend.py:_build_prompt()` 把前端传的 intent + candidates 拼成下面这段，作为**唯一一条 user message** 投递：
|
||||
|
||||
```
|
||||
任务目标:对生产系统进行安全改造,满足等保 2.0 合规要求
|
||||
约束:预算 ≤ 500 万元; 工期 ≤ 6 个月; 必须满足等保 2.0
|
||||
关键假设:现有系统具备基础数字化能力; 允许预定窗口停机
|
||||
|
||||
候选智能体池:
|
||||
- roundtable-intelligence (情报收集): 检索同类历史案例、行业最佳实践与外部情报
|
||||
- roundtable-solution-design (方案设计): 产出主备方案与关键路径
|
||||
- my-cost-calc (成本测算): 基于预算和资源单价计算总成本
|
||||
- ...
|
||||
|
||||
请按 SOUL 中规定的格式输出推荐结果(自然语言思路 + [RECOMMEND_READY] + json 块)。
|
||||
```
|
||||
|
||||
**关键事实**：
|
||||
- **候选 agent 的 `name` 与 `description` 在 prompt 里就是它的「介绍」**——这是模型判断「这个 agent 适不适合本任务」的全部信息。客户自有 agent 想被推荐准确，`description` 必须写**任务导向**的能力描述，不要写 "由 XX 团队维护" 这种元信息
|
||||
- **候选池由前端过滤后传入**，后端不读 DB；前端 `filterRecommendCandidates` 已剔除 `roundtable-intent / roundtable-recommender / roundtable-coordinator-*`
|
||||
- SOUL 看不到「intent agent 上一轮说了什么 / 用户原始 message」，只看到结构化的 `objective / constraints / assumptions`——这是设计选择，让推荐稳定
|
||||
|
||||
#### 11.8.4 SOUL 设计要点（模板 + 注解）
|
||||
|
||||
SOUL **必须**满足三件事，其它都可定制：
|
||||
|
||||
1. **输出格式严格**：自然语言思路 → `[RECOMMEND_READY]` 单独成行 → ```json {"picks": [{"agent_id": "...", "reason": "..."}, ...]} ```
|
||||
2. **`agent_id` 严格来自候选池**：模型造词出来会被 `_validate_picks` 过滤掉
|
||||
3. **2 ≤ picks ≤ 6**：少于 2 → 整轮判 `asking` 走 fallback；多于 6 → 后端截断
|
||||
|
||||
下面是一份可直接用的最小 SOUL，重点行带注释（**真正落盘时去掉 `<!-- -->`**）：
|
||||
|
||||
```markdown
|
||||
# 智能体推荐专员
|
||||
|
||||
## 角色定位
|
||||
你是多智能体圆桌研讨的"智能体推荐专员"。任务理解专员已经把用户需求整理成
|
||||
「任务目标 + 约束 + 关键假设」交给你,你的工作是从一个**候选智能体池**里,
|
||||
挑出**最适合**参加这次圆桌研讨的 2-6 个智能体,并为每一位写一句推荐理由。
|
||||
|
||||
## 核心职责
|
||||
- 仔细阅读用户的任务目标与约束
|
||||
- 浏览候选池中每个智能体的 `name` 与 `description`
|
||||
- 选出与本次任务**最相关**的 2-6 个智能体(数量动态,不必凑齐 6 个)
|
||||
- 为每个推荐的智能体写一句**具体、可验证**的推荐理由
|
||||
- 不推荐重复职能 / 不推荐与任务明显无关的智能体(宁缺毋滥)
|
||||
|
||||
## 数量约束
|
||||
- **下限**:至少 2 个 / **上限**:最多 6 个
|
||||
- 候选池不足 2 个时,有几个推几个
|
||||
|
||||
## 输出协议(后端用正则识别,严格执行)
|
||||
1. 先用自然语言简短说明推荐思路(1-3 句话)
|
||||
2. 输出标记 `[RECOMMEND_READY]` 单独成行
|
||||
3. 紧接一个 ```json 代码块:
|
||||
|
||||
```json
|
||||
{
|
||||
"picks": [
|
||||
{"agent_id": "<候选池中的 id>", "reason": "<一句推荐理由>"},
|
||||
...
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
格式注意:
|
||||
- `[RECOMMEND_READY]` **单独成行**,前后无其他字符
|
||||
- `agent_id` **严格**来自候选池,不要造词
|
||||
- `reason` **具体**,不要"很合适"这种空话
|
||||
|
||||
## 边界
|
||||
- 不调用任何工具(已被后端 excluded_tools 屏蔽)
|
||||
- 不评价候选 agent 优劣,只判断"是否适合本次任务"
|
||||
- 不发起对话、不反问用户
|
||||
|
||||
## 示例
|
||||
<!-- 示例对模型的引导能力远超规则文字,
|
||||
建议示例的候选池里**包含一两个你部署里的客户自有 agent**,
|
||||
让模型知道这种"非 roundtable-* 前缀"的 id 也是合法的。 -->
|
||||
```
|
||||
|
||||
##### 定制方向
|
||||
|
||||
- **偏好新加的 agent**：在「示例」里把它列进候选池并出现在推荐结果中，模型会学到这种 id 也可推荐。比单纯在「核心职责」里加文字约束有效
|
||||
- **行业偏向**：在「角色定位」加一句「优先考虑能直接对接 <行业> 合规要求的智能体」
|
||||
- **激进 vs 保守**：调「数量约束」——例如「能挑出强相关的 3 个就不要凑 6 个」会让 picks 缩到 3-4 个
|
||||
- **不要做的事**：
|
||||
- ❌ 改 `[RECOMMEND_READY]` 为别的标记 → 解析失败
|
||||
- ❌ 把 JSON 结构改成 `{"recommendations": [...]}` 之类 → 解析失败
|
||||
- ❌ 让模型只输出 JSON 不带前面的自然语言 → 前端 `parseRecommendStreamContent` 把整段当 `rationale`，弹窗顶部为空白
|
||||
|
||||
#### 11.8.5 验证流程
|
||||
|
||||
部署完成后跑 smoke test 确认推荐路径通：
|
||||
|
||||
```bash
|
||||
# 1. 确认 agent 文件落地
|
||||
ls .deer-flow/agents/roundtable-recommender/
|
||||
# 期望: SOUL.md config.yaml
|
||||
|
||||
# 2. 确认 DB 已 upsert(任意 /api/agents 请求会触发 _sync_legacy_agents)
|
||||
curl -H "Authorization: Bearer <TOKEN>" http://127.0.0.1:8001/api/agents | \
|
||||
python -c "import sys,json; ids=[a['id'] for a in json.load(sys.stdin).get('agents',[])]; print('roundtable-recommender' in ids)"
|
||||
# 期望: True
|
||||
|
||||
# 3. 触发一次推荐(用最小 intent + 候选池)
|
||||
curl -X POST http://127.0.0.1:8001/api/recommend/stream \
|
||||
-H "Authorization: Bearer <TOKEN>" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"intent": {
|
||||
"objective": "测试推荐链路",
|
||||
"constraints": ["响应时间 < 30s"],
|
||||
"assumptions": []
|
||||
},
|
||||
"candidates": [
|
||||
{"agent_id": "agent-a", "name": "A", "description": "做 X"},
|
||||
{"agent_id": "agent-b", "name": "B", "description": "做 Y"},
|
||||
{"agent_id": "agent-c", "name": "C", "description": "做 Z"}
|
||||
]
|
||||
}'
|
||||
# 期望(SSE 流):最后一帧 data: {"status":"done","content":"...","picks":[...]}
|
||||
# 若 picks 是空 → SOUL 没产生合法 [RECOMMEND_READY] / agent_id 不在候选池
|
||||
# 若整轮 status=error → 看后端 _diagnose_exception 输出的 hint
|
||||
```
|
||||
|
||||
#### 11.8.6 故障排查清单
|
||||
|
||||
| 现象 | 排查方向 |
|
||||
|------|----------|
|
||||
| 推荐永远走 fallback（status=asking） | 后端日志 grep `recommend stream`，看 `last_ai_content` 是不是不含 `[RECOMMEND_READY]`——SOUL 没遵守协议 |
|
||||
| `picks` 数量被截断到 6 | 后端 `_MAX_PICKS=6` 故意限制，前端用户可再手加到 8 |
|
||||
| 模型推荐了候选池里没有的 id | `_validate_picks` 会丢掉，但若有效项不足 2 个会整轮走 fallback；改 SOUL 强调「严格来自候选池」 |
|
||||
| 推荐结果不偏向客户自有 agent | 先检查该 agent 的 `description` 是不是写得「任务导向」；再考虑在 SOUL 示例里加它 |
|
||||
| 推荐稳定性差（同 intent 重跑结果飘） | 推荐 model 用低 temperature（在 `roundtable-recommender/config.yaml` 加 `model: <某个低 temp 模型>` 或直接前端选 deterministic 模型） |
|
||||
| 前端弹窗顶部 rationale 区空白 | SOUL 让模型只输出 JSON 没有自然语言；恢复成「先思路 + 后 JSON」 |
|
||||
|
||||
---
|
||||
|
||||
## 12. 故障排查
|
||||
@@ -691,7 +1112,7 @@ grep "special-timing" .runtime/logs/*.log # payload_built / first_upstream_l
|
||||
| Step 1 一直有澄清、无法进入 Step 2 | 未产出 `[INTENT_READY]` 或终态被 `clarification` 覆盖 | 看 SOUL、最后一帧 `status`；确认 intent 先扫 READY（§4.3 顺序） |
|
||||
| 选项全是多选 | 旧前端默认 `allow_multiple !== false` | 确认 `allow_multiple` 字段与 `resolve_allow_multiple`（缺省 false） |
|
||||
| Step 2 init SSE `error` | 协调 agent 创建失败 / agent_orchestration 缺失 / `_validate_agent_id` 命中 | Network + 后端 `multi_agent` 日志 |
|
||||
| Step 2 init 完全卡住 ~40 秒 | `httpx` 走了 `HTTP_PROXY` | 确认 `trust_env=False` 仍在；grep `headers_in=` 看时长 |
|
||||
| Step 2 init 完全卡住（历史症状，ASGITransport 改造后已不应再出现） | 旧版 `httpx` 走 `HTTP_PROXY` 拦回环 → 40s 超时 | 自改 ASGITransport 起此现象物理上不可能复现；若仍卡，看后端日志栈、检查路由 handler 是否阻塞 |
|
||||
| leader 立即 `status: []` | 未调用 orchestration 技能 / SkillStopMiddleware 没拦到 / SOUL 没声明派活 | 换模型或加强 SOUL；检查 `skill_stop_names` 是否包含 `agent_orchestration` |
|
||||
| dispatch 失败但 leader 文本看着正常 | 模型把 `roundtable-x（中文）` 整段塞进 `agent_name` | `_strip_display_suffix` 会兜底；若仍报 400，强化 SOUL 的「严格英文 id」 |
|
||||
| 推荐 picks 为空 | 未输出 `[RECOMMEND_READY]` 或 picks 不在候选池 | 看 recommend 终态帧；检查 `candidate_ids` 集合 |
|
||||
@@ -708,7 +1129,7 @@ grep "dispatch failed" .runtime/logs/*.log
|
||||
grep "upstream-timing" .runtime/logs/*.log
|
||||
grep "leader-timing" .runtime/logs/*.log
|
||||
grep "special-timing" .runtime/logs/*.log
|
||||
grep "headers_in=" .runtime/logs/*.log # 走代理症状
|
||||
grep "headers_in=" .runtime/logs/*.log # 上游首字节延迟;ASGITransport 改造后通常 < 10ms
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
|
||||
- **整页只有一个文件**：`RoundtablePlanningPage.tsx`（≈ 3 621 行）。三步 UI 通过 `currentStep ∈ {1,2,3}` 切换，不使用 React Router 子路由。
|
||||
- **不使用 LangGraph SDK**：所有 API 都是自研的 `apiFetch` + `ReadableStream` SSE 解析（见 `api/intent.ts`、`api/recommend.ts`、`api/multi-agent.ts`）。
|
||||
- **唯一默认模型**：`DEFAULT_MODEL = "deepseek-chat"`（页面常量，写在 `RoundtablePlanningPage.tsx`）。`useModels()` 只用于 Persona 抽屉的下拉选项。
|
||||
- **不写死模型名**：与 `/page/canvas/ai-writing` 同样的策略 —— 全局选中模型由 `selectedModel` state 维护，首次 `useModels()` 完成后初始化为 `availableModels[0].name`，顶栏「模型」下拉可切换。所有 API 调用统一传 `model: selectedModel || undefined`；后端缺省由 `lead_agent._resolve_model_name()` 回退到 `config.yaml` 的 `models[0]`。**内网部署只需在 `config.yaml` 配自家模型即可，前后端均无需改动**。
|
||||
- **席位区间硬约束**：推荐弹窗要求 **2 ≤ 选中数 ≤ 8**（`MIN_SELECTED` / `MAX_SELECTED`）。
|
||||
- **总控编排循环上限**：`MAX_CYCLES = 8`，超出后强制停止并 toast。
|
||||
- **席位派活策略**：**顺序**（不是并行）。旧实现并行触发多路 SSE 会让浏览器卡顿，现已改为顺序。
|
||||
@@ -124,17 +124,17 @@ frontend-web/src/roundtable-planning/
|
||||
|
||||
[进入 Step 3]
|
||||
HighFidelityReport
|
||||
consensusText ← lastLeaderContent
|
||||
seatDeliveries ← step2RoundtableDialogues.filter(d => d.confidence === "子智能体交付")
|
||||
Object.entries(threadIds).filter(name !== coordinatorName).map → listSessionArtifacts(threadId)
|
||||
文本类文件 → ArtifactPreviewModal；其它 → window.open(downloadUrl)
|
||||
```
|
||||
consensusText ← lastLeaderContent
|
||||
seatDeliveries ← step2RoundtableDialogues.filter(d => d.confidence === "子智能体交付")
|
||||
Object.entries(threadIds).filter(name !== coordinatorName).map → listSessionArtifacts(threadId)
|
||||
文本类文件 → ArtifactPreviewModal；其它 → window.open(downloadUrl)
|
||||
```
|
||||
|
||||
---
|
||||
---
|
||||
|
||||
## 4. API 层
|
||||
## 4. API 层
|
||||
|
||||
### 4.1 `api/intent.ts` — Step 1
|
||||
### 4.1 `api/intent.ts` — Step 1
|
||||
|
||||
| 函数 | 说明 |
|
||||
|------|------|
|
||||
@@ -364,13 +364,22 @@ isOrchestrating = false
|
||||
- 抽屉控件：
|
||||
- **System Prompt**：仅前端记录（后端覆写未开放）
|
||||
- **Temp**：仅前端记录
|
||||
- **推理模型**：选项来自 `useModels()`，默认 `DEFAULT_MODEL`
|
||||
- **推理模型**：选项来自 `useModels()`；显示值优先级 `agentConfigs[seat]?.model > selectedModel`
|
||||
- 「参数覆盖并重启动算研讨」按钮 → `handleSaveAgentAndRecalculate`：
|
||||
- 把新的 `(seatId, model)` 写入 `agentConfigs`
|
||||
- 追加一条「⚡ [模型偏好已保存] ...」对话气泡
|
||||
- **不**立即重启编排；下一轮该席位被派活时 `runOrchestration` 内会读 `agentConfigs[meta.speakerId]?.model` 作为 special 调用的 `model` 参数
|
||||
- **不**立即重启编排；下一轮该席位被派活时 `runOrchestration` 内会读 `agentConfigs[meta.speakerId]?.model || selectedModel || undefined` 作为 special 调用的 `model` 参数
|
||||
|
||||
### 5.6 草稿持久化（`utils/drafts.ts`）
|
||||
### 5.6 全局模型选择器（右侧 sidebar 顶部）
|
||||
|
||||
- **位置**：右侧 sidebar `currentStep !== 3` 时显示的第一个面板 —— 在「当前意图摘要」**正上方**。Step 3 时整个 sidebar 切换成「最终共识结论 / 风险与预算摘要 / 导出与交付」，所以模型选择器仅在 Step 1 / Step 2 可见（此时也是唯一会发起新模型调用的阶段）
|
||||
- **state**：`const [selectedModel, setSelectedModel] = useState<string>("")`
|
||||
- **初始化**：`useEffect(() => ...)` 在 `availableModels` 首次返回后把 `selectedModel` 设为 `availableModels[0].name`；后端配置变化导致当前选中 model 不在列表里时也回退到首项
|
||||
- **传参规则**：所有 5 个 API 调用点（`initIntent` / `streamIntent` / `streamRecommend` / `initMultiAgent` / `streamMultiAgent` leader / `streamMultiAgent` special）都传 `selectedModel || undefined`；special 还会先看 `agentConfigs[seat]?.model` per-seat 覆盖
|
||||
- **禁用态**：`availableModels.length === 0` 或 `modelsLoading` → `disabled`，placeholder 显示「加载中…」或「未配置模型」
|
||||
- **可改换为 Radix Select**：当前用原生 `<select>` 与 Persona 抽屉保持一致；如需统一样式可改为 `@/components/ui/select`，行为不变
|
||||
|
||||
### 5.7 草稿持久化（`utils/drafts.ts`）
|
||||
|
||||
- Key：`roundtable-planning:drafts:v1`（`localStorage`）
|
||||
- 草稿快照含：`step1.{intentThreadId, intentReady, interactiveMessages, timelineEntries}`、`step2.{threadIds, coordinatorName, step2RoundtableDialogues, lastLeaderContent, hasConsensus, consensusPercentage, budgetLimit}`、`furthestStep`
|
||||
@@ -544,7 +553,6 @@ interface StreamMultiAgentResult {
|
||||
|
||||
| 常量 | 值 | 位置 |
|
||||
|------|----|------|
|
||||
| `DEFAULT_MODEL` | `"deepseek-chat"` | RoundtablePlanningPage |
|
||||
| `COMMANDER_SEAT_ID` | `1` | RoundtablePlanningPage |
|
||||
| `MAX_CYCLES` | `8` | RoundtablePlanningPage（`runOrchestration` 内） |
|
||||
| `MIN_SELECTED` / `MAX_SELECTED` | `2` / `8` | RecommendAgentsDialog |
|
||||
|
||||
File diff suppressed because it is too large.
Load diff
@@ -5,7 +5,7 @@ import { env } from "@/env";
|
||||
* 素材的 recUuid 直接拼接在其后即为完整原文链接。
|
||||
*/
|
||||
export const INTRANET_SOURCE_URL_BASE =
|
||||
"https://chlib.b.uat.4.cn/knowlibrary/#/knowledge/mid_detail?recUuid=";
|
||||
"https://chlib.b.uat.4.cn/knowlibrary/#/knowledge/mid-detail?recUuid=";
|
||||
|
||||
/** 由 recUuid 构造内网原文详情页地址；recUuid 为空时返回空串。 */
|
||||
export function buildIntranetSourceUrl(recUuid?: string | null): string {
|
||||
|
||||
@@ -26,7 +26,10 @@ export const DESENSITIZE_MAP: Record<string, string> = {
|
||||
模拟: "MN",
|
||||
推演: "TY",
|
||||
认知: "RZ",
|
||||
触及: "CJ"
|
||||
触及: "CJ",
|
||||
军: "J",
|
||||
美军: "MJ",
|
||||
台军: "TJ",
|
||||
};
|
||||
|
||||
/**
|
||||
|
||||
@@ -19,7 +19,7 @@ import { useArticleTypes } from '../../hooks/useArticleTypes';
|
||||
interface AIWritingFormProps {
|
||||
onSubmit: (req: AIWritingRequest) => void;
|
||||
disabled?: boolean;
|
||||
/** workspace 入口：隐藏检索关键词数量、严格模式、目标读者 */
|
||||
/** workspace 入口：隐藏严格模式、目标读者 */
|
||||
hideAdvancedFields?: boolean;
|
||||
}
|
||||
|
||||
@@ -33,7 +33,7 @@ const INPUT_CLASS =
|
||||
'placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 ' +
|
||||
'focus-visible:ring-ring disabled:opacity-50';
|
||||
|
||||
const DEFAULT_KEYWORD_COUNT = 6;
|
||||
const DEFAULT_KEYWORD_COUNT = 1;
|
||||
const DEFAULT_AUDIENCE = '普通读者';
|
||||
const MAX_INTENT_LENGTH = 500;
|
||||
|
||||
@@ -50,7 +50,6 @@ export function AIWritingForm({
|
||||
const [articleType, setArticleType] = useState('analysis');
|
||||
const [audience, setAudience] = useState('普通读者');
|
||||
const [wordCountInput, setWordCountInput] = useState('800');
|
||||
const [keywordCountInput, setKeywordCountInput] = useState('1');
|
||||
const [strictMode, setStrictMode] = useState(false);
|
||||
const [modelName, setModelName] = useState('');
|
||||
const [models, setModels] = useState<ModelOption[]>([]);
|
||||
@@ -110,23 +109,10 @@ export function AIWritingForm({
|
||||
}
|
||||
}
|
||||
|
||||
// 检索关键词数量限定 1~10，非法值回退默认 6
|
||||
function handleKeywordCountBlur() {
|
||||
const num = parseInt(keywordCountInput, 10);
|
||||
if (isNaN(num)) {
|
||||
setKeywordCountInput('1');
|
||||
} else {
|
||||
setKeywordCountInput(String(Math.max(1, Math.min(10, num))));
|
||||
}
|
||||
}
|
||||
|
||||
function handleSubmit(e: React.FormEvent) {
|
||||
e.preventDefault();
|
||||
if (!intent.trim()) return;
|
||||
const wordCount = Math.max(100, parseInt(wordCountInput, 10) || 800);
|
||||
const keywordCount = hideAdvancedFields
|
||||
? DEFAULT_KEYWORD_COUNT
|
||||
: Math.max(1, Math.min(10, parseInt(keywordCountInput, 10) || DEFAULT_KEYWORD_COUNT));
|
||||
onSubmit({
|
||||
userIntent: intent.trim(),
|
||||
articleType,
|
||||
@@ -134,7 +120,7 @@ export function AIWritingForm({
|
||||
? DEFAULT_AUDIENCE
|
||||
: audience.trim() || DEFAULT_AUDIENCE,
|
||||
wordCountTarget: wordCount,
|
||||
keywordCount,
|
||||
keywordCount: DEFAULT_KEYWORD_COUNT,
|
||||
writingMode: hideAdvancedFields ? 'loose' : strictMode ? 'strict' : 'loose',
|
||||
modelName: modelName || undefined,
|
||||
});
|
||||
@@ -235,25 +221,6 @@ export function AIWritingForm({
|
||||
|
||||
{!hideAdvancedFields && (
|
||||
<>
|
||||
<div className="space-y-2">
|
||||
<label className="text-sm font-semibold text-foreground">检索关键词数量（1~10）</label>
|
||||
<input
|
||||
type="number"
|
||||
min={1}
|
||||
max={10}
|
||||
step={1}
|
||||
className={INPUT_CLASS}
|
||||
placeholder="6"
|
||||
value={keywordCountInput}
|
||||
onChange={(e) => setKeywordCountInput(e.target.value)}
|
||||
onBlur={handleKeywordCountBlur}
|
||||
disabled={disabled}
|
||||
/>
|
||||
<p className="text-xs text-muted-foreground/80">
|
||||
素材收集专家用几个关键词检索，越多素材越全面但耗时更长。
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div className="flex items-start gap-2 rounded-xl border border-[#e8dedd] bg-[#f9f5f5] px-3 py-3">
|
||||
<input
|
||||
type="checkbox"
|
||||
|
||||
@@ -158,7 +158,7 @@ export interface AIWritingRequest {
|
||||
targetAudience: string;
|
||||
wordCountTarget: number;
|
||||
modelName?: string;
|
||||
/** 素材检索关键词数量（1~10，默认 6） */
|
||||
/** 素材检索关键词数量（1~10，默认 1） */
|
||||
keywordCount: number;
|
||||
/** 写作模式：strict=严格依据素材 / loose=可结合通用知识（默认 loose） */
|
||||
writingMode: 'strict' | 'loose';
|
||||
|
||||
@@ -21,9 +21,80 @@ export interface IntentInitResponse {
|
||||
thread_id: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Structured diagnostic payload surfaced by the backend whenever an intent
|
||||
* route raises (init) or yields a final `status: "error"` frame (stream).
|
||||
* Same shape across `init_intent` / `stream_intent`; renderer keys off `code`
|
||||
* for quick visual triage, but also shows `hint` + `trace_tail` as a panel
|
||||
* so deployment-time issues (config.yaml unreachable LLM, missing builtin
|
||||
* agent dirs, loopback going through proxy) are debuggable from the UI alone
|
||||
* without tail-ing backend logs.
|
||||
*/
|
||||
export interface IntentErrorDetail {
|
||||
/** Stable short category — see backend `_diagnose_exception`. */
|
||||
code: string;
|
||||
/** One-line human-readable description (already includes exception type). */
|
||||
message: string;
|
||||
exception_type: string;
|
||||
exception_repr: string;
|
||||
/** Root of the `__cause__` chain when distinct from the outer exception. */
|
||||
root_type?: string | null;
|
||||
root_repr?: string | null;
|
||||
/** Actionable hint in Chinese, keyed by `code`. May be null for unrecognized errors. */
|
||||
hint?: string | null;
|
||||
/** Last ~12 lines of the traceback for in-UI inspection. */
|
||||
trace_tail?: string[];
|
||||
/** Caller-supplied label (e.g. "intent_init"). */
|
||||
context?: string | null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Thrown by `initIntent` when the HTTP call fails. Carries the parsed
|
||||
* `IntentErrorDetail` (if the backend emitted one) so the page can render
|
||||
* a rich diagnostic panel instead of a one-line message.
|
||||
*/
|
||||
export class IntentInitError extends Error {
|
||||
/** HTTP status (typically 500 for diagnosed failures, 401/403 for auth). */
|
||||
readonly status: number;
|
||||
/** Structured detail when the backend emitted `_diagnose_exception` output. */
|
||||
readonly detail: IntentErrorDetail | null;
|
||||
/** Raw body text when JSON parse failed (kept for completeness). */
|
||||
readonly rawBody: string;
|
||||
|
||||
constructor(status: number, detail: IntentErrorDetail | null, rawBody: string) {
|
||||
super(detail?.message || `init intent failed (${status}): ${rawBody}`);
|
||||
this.name = "IntentInitError";
|
||||
this.status = status;
|
||||
this.detail = detail;
|
||||
this.rawBody = rawBody;
|
||||
}
|
||||
}
|
||||
|
||||
function parseIntentErrorDetail(value: unknown): IntentErrorDetail | null {
|
||||
if (!value || typeof value !== "object") return null;
|
||||
const obj = value as Record<string, unknown>;
|
||||
if (typeof obj.code !== "string" || typeof obj.message !== "string") return null;
|
||||
return {
|
||||
code: obj.code,
|
||||
message: obj.message,
|
||||
exception_type: typeof obj.exception_type === "string" ? obj.exception_type : "",
|
||||
exception_repr: typeof obj.exception_repr === "string" ? obj.exception_repr : "",
|
||||
root_type: typeof obj.root_type === "string" ? obj.root_type : null,
|
||||
root_repr: typeof obj.root_repr === "string" ? obj.root_repr : null,
|
||||
hint: typeof obj.hint === "string" ? obj.hint : null,
|
||||
trace_tail: Array.isArray(obj.trace_tail) ? obj.trace_tail.filter((l): l is string => typeof l === "string") : [],
|
||||
context: typeof obj.context === "string" ? obj.context : null,
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a fresh thread for an intent-clarification session.
|
||||
* The backend returns the built-in agent id so the frontend doesn't hardcode it.
|
||||
*
|
||||
* On failure throws `IntentInitError` whose `.detail` carries the backend's
|
||||
* `_diagnose_exception` payload — the page should surface `detail.hint` /
|
||||
* `detail.trace_tail` to help diagnose intranet deployment issues without
|
||||
* shell access to the server.
|
||||
*/
|
||||
export async function initIntent(model?: string): Promise<IntentInitResponse> {
|
||||
const res = await apiFetch(`${getBackendBaseURL()}/api/intent/init`, {
|
||||
@@ -32,8 +103,18 @@ export async function initIntent(model?: string): Promise<IntentInitResponse> {
|
||||
body: JSON.stringify({ model }),
|
||||
});
|
||||
if (!res.ok) {
|
||||
const text = await res.text().catch(() => "");
|
||||
throw new Error(`init intent failed (${res.status}): ${text}`);
|
||||
const raw = await res.text().catch(() => "");
|
||||
let detail: IntentErrorDetail | null = null;
|
||||
try {
|
||||
const parsed = JSON.parse(raw);
|
||||
// FastAPI HTTPException(detail=dict) → { "detail": {...} }
|
||||
if (parsed && typeof parsed === "object" && parsed !== null) {
|
||||
detail = parseIntentErrorDetail((parsed as { detail?: unknown }).detail) || parseIntentErrorDetail(parsed);
|
||||
}
|
||||
} catch {
|
||||
// body wasn't JSON — fall through with raw text only.
|
||||
}
|
||||
throw new IntentInitError(res.status, detail, raw);
|
||||
}
|
||||
return (await res.json()) as IntentInitResponse;
|
||||
}
|
||||
@@ -89,6 +170,12 @@ export interface StreamIntentResult {
|
||||
* cards + custom input instead of treating the turn as plain text only.
|
||||
*/
|
||||
clarification: ClarificationPayload | null;
|
||||
/**
|
||||
* Populated only when status === "error" and the backend emitted a
|
||||
* structured diagnostic (new in `_diagnose_exception`). UI uses this to show
|
||||
* the same rich panel as init failures.
|
||||
*/
|
||||
errorDetail: IntentErrorDetail | null;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -106,6 +193,7 @@ function isFinalIntentFrame(value: unknown): value is {
|
||||
options?: unknown[];
|
||||
allow_custom?: boolean;
|
||||
allow_multiple?: boolean;
|
||||
error_detail?: unknown;
|
||||
} {
|
||||
if (!value || typeof value !== "object") return false;
|
||||
if (!("status" in value) || !("content" in value)) return false;
|
||||
@@ -192,6 +280,7 @@ export async function streamIntent(req: StreamIntentRequest): Promise<StreamInte
|
||||
content: "",
|
||||
summary: null,
|
||||
clarification: null,
|
||||
errorDetail: null,
|
||||
};
|
||||
|
||||
while (true) {
|
||||
@@ -231,6 +320,9 @@ export async function streamIntent(req: StreamIntentRequest): Promise<StreamInte
|
||||
if (parsed.summary && typeof parsed.summary === "object") {
|
||||
result.summary = parsed.summary as IntentSummary;
|
||||
}
|
||||
if (parsed.status === "error") {
|
||||
result.errorDetail = parseIntentErrorDetail(parsed.error_detail);
|
||||
}
|
||||
if (parsed.status === "clarification") {
|
||||
const clarificationType =
|
||||
typeof parsed.clarification_type === "string" ? parsed.clarification_type : "";
|
||||
|
||||
@@ -26,7 +26,13 @@
|
||||
* 7) **Persona 抽屉**改的 model 不会立即重启编排，下一轮该席位被派活时由 `runOrchestration`
|
||||
* 读 `agentConfigs[meta.speakerId]?.model` 传入 special。prompt / temp 当前**仅前端记录**。
|
||||
*
|
||||
* 8) **常量**：`DEFAULT_MODEL`、`MAX_CYCLES=8`、`COMMANDER_SEAT_ID=1`、`INTENT_READY_RE`。
|
||||
* 8) **模型选择**：不再硬编码 "deepseek-chat"。全局选中 model 由 `selectedModel`
|
||||
* state 维护（首次 `useModels()` 完成后初始化为 `availableModels[0].name`），
|
||||
* 顶栏「模型」下拉可切换；Persona 抽屉的 per-seat 覆盖更高优先级。所有 API 调用
|
||||
* 传 `selectedModel || undefined`，后端缺省由 `lead_agent._resolve_model_name()`
|
||||
* 回退到 `config.yaml` 的 `models[0]`。内网部署只需配 `config.yaml` 即可。
|
||||
*
|
||||
* 9) **常量**：`MAX_CYCLES=8`、`COMMANDER_SEAT_ID=1`、`INTENT_READY_RE`。
|
||||
*
|
||||
* 调试开关（默认开启）：
|
||||
* window.__MULTI_AGENT_INIT_TIMING__ // /api/multi-agent/init 各阶段耗时
|
||||
@@ -51,7 +57,9 @@ import {
|
||||
} from "@/roundtable-planning/api/multi-agent";
|
||||
import {
|
||||
initIntent,
|
||||
IntentInitError,
|
||||
streamIntent,
|
||||
type IntentErrorDetail,
|
||||
type IntentStreamPhase,
|
||||
type IntentSummary,
|
||||
} from "@/roundtable-planning/api/intent";
|
||||
@@ -189,7 +197,13 @@ function getAvatar(type: string, size: string = "h-8 w-8") {
|
||||
}
|
||||
|
||||
// --- Multi-agent backend wiring ---
|
||||
const DEFAULT_MODEL = "deepseek-chat";
|
||||
//
|
||||
// 模型选择策略（与 /page/canvas/ai-writing 对齐,不再写死 "deepseek-chat"）:
|
||||
// - 全局选中模型由 selectedModel state 维护(首次 useModels 完成后初始化为 models[0].name)
|
||||
// - 所有 API 调用传 model 时统一用 selectedModel || undefined;后端缺省由
|
||||
// lead_agent._resolve_model_name() 回退到 config.yaml 的 models[0]
|
||||
// - Persona 抽屉的 per-seat 覆盖优先(agentConfigs[seat]?.model > selectedModel)
|
||||
// 内网部署只需在 config.yaml 配自家模型,前后端都不需要再硬编码具体模型名。
|
||||
|
||||
type RoleEntry = {
|
||||
id: number;
|
||||
@@ -373,16 +387,24 @@ export default function RoundtablePlanningPage() {
|
||||
// for each of them concurrently instead of only the most recently set one.
|
||||
const [activeSpeakerSet, setActiveSpeakerSet] = useState<Set<number>>(new Set());
|
||||
|
||||
// Custom presets for agent model, weight, temperature and prompt editors
|
||||
// Custom presets for agent model, weight, temperature and prompt editors.
|
||||
// model 字段留空,运行时由 runOrchestration 解析为
|
||||
// agentConfigs[seat]?.model || selectedModel || undefined
|
||||
// 即「席位覆盖优先,否则跟随全局选中模型,否则让后端回退到 config.yaml models[0]」。
|
||||
const [agentConfigs, setAgentConfigs] = useState<{ [key: number]: { model: string; weight: number; prompt: string; temp: number } }>({
|
||||
2: { model: DEFAULT_MODEL, weight: 90, temp: 0.2, prompt: "你负责解析核心任务、资源极限和用户目标偏好，监督全局研商收敛。" },
|
||||
3: { model: DEFAULT_MODEL, weight: 85, temp: 0.3, prompt: "你负责搜集电力、通信系统、历史极端部署条件情报，支持备灾架构体系。" },
|
||||
4: { model: DEFAULT_MODEL, weight: 88, temp: 0.1, prompt: "你评估服务器机房热载荷、算力并发承载极限，预报运行瓶颈与风险时钟。" },
|
||||
5: { model: DEFAULT_MODEL, weight: 92, temp: 0.4, prompt: "你负责双全栈主备建模设计，高内聚低耦合，规避不可预知停机崩溃。" },
|
||||
6: { model: DEFAULT_MODEL, weight: 95, temp: 0.1, prompt: "你作为安全主管，严厉把控预算开销与合规通过率防线，识别计划漏洞。" },
|
||||
7: { model: DEFAULT_MODEL, weight: 80, temp: 0.4, prompt: "你负责对72小时里程碑执行路径规划、重排和资源调配演练序列。" },
|
||||
2: { model: "", weight: 90, temp: 0.2, prompt: "你负责解析核心任务、资源极限和用户目标偏好，监督全局研商收敛。" },
|
||||
3: { model: "", weight: 85, temp: 0.3, prompt: "你负责搜集电力、通信系统、历史极端部署条件情报，支持备灾架构体系。" },
|
||||
4: { model: "", weight: 88, temp: 0.1, prompt: "你评估服务器机房热载荷、算力并发承载极限，预报运行瓶颈与风险时钟。" },
|
||||
5: { model: "", weight: 92, temp: 0.4, prompt: "你负责双全栈主备建模设计，高内聚低耦合，规避不可预知停机崩溃。" },
|
||||
6: { model: "", weight: 95, temp: 0.1, prompt: "你作为安全主管，严厉把控预算开销与合规通过率防线，识别计划漏洞。" },
|
||||
7: { model: "", weight: 80, temp: 0.4, prompt: "你负责对72小时里程碑执行路径规划、重排和资源调配演练序列。" },
|
||||
});
|
||||
|
||||
// 全局选中模型(对应顶栏「模型」下拉)。
|
||||
// 首次 useModels 加载完成后由下面的 useEffect 初始化为 availableModels[0].name,
|
||||
// 用户可以通过下拉框切换;Persona 抽屉的 per-seat 覆盖更高优先级。
|
||||
const [selectedModel, setSelectedModel] = useState<string>("");
|
||||
|
||||
// Message lists state representation to mimic image items & enable actual conversations
|
||||
const [interactiveMessages, setInteractiveMessages] = useState([
|
||||
{
|
||||
@@ -484,6 +506,8 @@ export default function RoundtablePlanningPage() {
|
||||
const [intentThreadId, setIntentThreadId] = useState<string | null>(null);
|
||||
const [intentReady, setIntentReady] = useState<IntentSummary | null>(null);
|
||||
const [intentInitError, setIntentInitError] = useState<string | null>(null);
|
||||
// 后端 _diagnose_exception 输出的结构化诊断,有就额外渲染 hint + trace_tail 面板。
|
||||
const [intentInitErrorDetail, setIntentInitErrorDetail] = useState<IntentErrorDetail | null>(null);
|
||||
const [isIntentSending, setIsIntentSending] = useState<boolean>(false);
|
||||
const [pendingIntentClarificationMsgId, setPendingIntentClarificationMsgId] = useState<number | null>(null);
|
||||
const [intentClarificationSelections, setIntentClarificationSelections] = useState<
|
||||
@@ -561,6 +585,17 @@ export default function RoundtablePlanningPage() {
|
||||
}
|
||||
}, []);
|
||||
|
||||
// 首次 /api/models 返回后,把 selectedModel 初始化为列表第一个 —— 与
|
||||
// AIWritingForm 的行为对齐。若 selectedModel 已经被用户在下拉框里选过,不再覆盖。
|
||||
// 若当前选中的 model 已不在 availableModels 里(后端配置变了),也回退到首项。
|
||||
useEffect(() => {
|
||||
if (availableModels.length === 0) return;
|
||||
const stillExists = availableModels.some((m) => m.name === selectedModel);
|
||||
if (!selectedModel || !stillExists) {
|
||||
setSelectedModel(availableModels[0].name);
|
||||
}
|
||||
}, [availableModels, selectedModel]);
|
||||
|
||||
// Toast auto-dismiss logic
|
||||
useEffect(() => {
|
||||
if (showToast) {
|
||||
@@ -837,7 +872,7 @@ export default function RoundtablePlanningPage() {
|
||||
dAgentThreadId: ids,
|
||||
agentName: coord,
|
||||
newMessage: nextLeaderTask,
|
||||
model: DEFAULT_MODEL,
|
||||
model: selectedModel || undefined,
|
||||
signal: leaderAborter.signal,
|
||||
onTextDelta: (text) => appendToDialogue(leaderBubbleId, text),
|
||||
onPhaseChange: (phase, toolName) => {
|
||||
@@ -918,7 +953,8 @@ export default function RoundtablePlanningPage() {
|
||||
dAgentThreadId: ids,
|
||||
agentName: subName,
|
||||
newMessage: task,
|
||||
model: perSeatModel || DEFAULT_MODEL,
|
||||
// 优先级: 席位 Persona 覆盖 → 全局选中模型 → 让后端回退到 config.yaml models[0]
|
||||
model: perSeatModel || selectedModel || undefined,
|
||||
signal: subAborter.signal,
|
||||
onTextDelta: (text) => appendToDialogue(subBubbleId, text),
|
||||
onPhaseChange: (phase, toolName) => {
|
||||
@@ -1026,7 +1062,7 @@ export default function RoundtablePlanningPage() {
|
||||
const initRes = await initMultiAgent({
|
||||
agentNames: roundtableAgentIds,
|
||||
mainAgentName: coord,
|
||||
model: DEFAULT_MODEL,
|
||||
model: selectedModel || undefined,
|
||||
// As each sub-agent's thread comes online, flip every role that
|
||||
// shares the agentId to "在线". Some seats reuse the same agent
|
||||
// (e.g. seat 8 reuses roundtable-summary) so we match on agentId
|
||||
@@ -1148,7 +1184,9 @@ export default function RoundtablePlanningPage() {
|
||||
const role = roles.find(r => r.id === id);
|
||||
const roleName = role?.name || "专家智能体";
|
||||
const cfg = agentConfigs[id];
|
||||
const targetModel = cfg?.model || DEFAULT_MODEL;
|
||||
// Persona 抽屉里的「保存」反馈文字: 优先显示用户在抽屉里选的 model,
|
||||
// 没选时退回全局 selectedModel,最后才显示「默认」二字。
|
||||
const targetModel = cfg?.model || selectedModel || "默认模型";
|
||||
|
||||
const avatarColor =
|
||||
id === 2 ? "blue"
|
||||
@@ -1191,6 +1229,7 @@ export default function RoundtablePlanningPage() {
|
||||
const myGen = ++step1InitGenRef.current;
|
||||
setIntentReady(null);
|
||||
setIntentInitError(null);
|
||||
setIntentInitErrorDetail(null);
|
||||
setIntentThreadId(null);
|
||||
setPendingIntentClarificationMsgId(null);
|
||||
setIntentClarificationSelections(new Map());
|
||||
@@ -1206,7 +1245,9 @@ export default function RoundtablePlanningPage() {
|
||||
]);
|
||||
(async () => {
|
||||
try {
|
||||
const res = await initIntent(DEFAULT_MODEL);
|
||||
// initIntent 当前不在 thread 上落盘 model,只为占位与兼容;空时由后端
|
||||
// 走 lead_agent._resolve_model_name 回退到 config.yaml models[0]
|
||||
const res = await initIntent(selectedModel || undefined);
|
||||
if (step1InitGenRef.current !== myGen) return;
|
||||
setIntentThreadId(res.thread_id);
|
||||
setTimelineEntries([
|
||||
@@ -1220,7 +1261,14 @@ export default function RoundtablePlanningPage() {
|
||||
} catch (err) {
|
||||
if (step1InitGenRef.current !== myGen) return;
|
||||
console.error("init intent failed:", err);
|
||||
setIntentInitError((err as Error).message);
|
||||
if (err instanceof IntentInitError) {
|
||||
// 优先使用后端的可读 message;若 detail 在,渲染诊断面板。
|
||||
setIntentInitError(err.detail?.message || err.message);
|
||||
setIntentInitErrorDetail(err.detail);
|
||||
} else {
|
||||
setIntentInitError((err as Error).message);
|
||||
setIntentInitErrorDetail(null);
|
||||
}
|
||||
}
|
||||
})();
|
||||
}, []);
|
||||
@@ -1384,6 +1432,7 @@ export default function RoundtablePlanningPage() {
|
||||
setIntentThreadId(draft.step1.intentThreadId);
|
||||
setIntentReady(draft.step1.intentReady);
|
||||
setIntentInitError(null);
|
||||
setIntentInitErrorDetail(null);
|
||||
setInteractiveMessages(draft.step1.interactiveMessages as typeof interactiveMessages);
|
||||
setTimelineEntries(draft.step1.timelineEntries as typeof timelineEntries);
|
||||
step1InitRef.current = true;
|
||||
@@ -1540,7 +1589,7 @@ export default function RoundtablePlanningPage() {
|
||||
const res = await streamIntent({
|
||||
threadId: intentThreadId,
|
||||
message: trimmed,
|
||||
model: DEFAULT_MODEL,
|
||||
model: selectedModel || undefined,
|
||||
signal: aborter.signal,
|
||||
onTextDelta: (delta) => {
|
||||
setInteractiveMessages(prev =>
|
||||
@@ -1593,6 +1642,15 @@ export default function RoundtablePlanningPage() {
|
||||
return next;
|
||||
});
|
||||
} else if (res.status === "error") {
|
||||
// 同时把诊断信息写到顶部面板:toast 一闪而过,面板能稳定展示 hint + trace_tail
|
||||
// 方便用户截图发给后端排查。
|
||||
if (res.errorDetail) {
|
||||
setIntentInitError(res.errorDetail.message || res.content);
|
||||
setIntentInitErrorDetail(res.errorDetail);
|
||||
} else {
|
||||
setIntentInitError(res.content);
|
||||
setIntentInitErrorDetail(null);
|
||||
}
|
||||
triggerToast(`❌ 智能体调用失败: ${res.content}`);
|
||||
}
|
||||
} catch (err) {
|
||||
@@ -1791,7 +1849,7 @@ export default function RoundtablePlanningPage() {
|
||||
<RecommendAgentsDialog
|
||||
open={isRecommendDialogOpen}
|
||||
intent={intentReady}
|
||||
model={DEFAULT_MODEL}
|
||||
model={selectedModel || undefined}
|
||||
onCancel={() => setIsRecommendDialogOpen(false)}
|
||||
onConfirm={handleConfirmAgents}
|
||||
/>
|
||||
@@ -2441,9 +2499,40 @@ export default function RoundtablePlanningPage() {
|
||||
</button>
|
||||
</div>
|
||||
{intentInitError && (
|
||||
<p className="mt-2 text-[11px] text-red-500 font-medium">
|
||||
智能体初始化失败: {intentInitError}
|
||||
</p>
|
||||
<div className="mt-2 rounded-lg border border-red-200 bg-red-50/70 p-3 text-[11px] leading-relaxed">
|
||||
<div className="flex items-center gap-2 mb-1.5">
|
||||
<span className="font-bold text-red-700">智能体初始化失败</span>
|
||||
{intentInitErrorDetail?.code && (
|
||||
<span className="px-1.5 py-0.5 bg-red-100 text-red-700 rounded font-mono text-[10px]">
|
||||
{intentInitErrorDetail.code}
|
||||
</span>
|
||||
)}
|
||||
{intentInitErrorDetail?.exception_type && (
|
||||
<span className="text-[10px] text-red-600 font-mono">
|
||||
{intentInitErrorDetail.exception_type}
|
||||
{intentInitErrorDetail.root_type && intentInitErrorDetail.root_type !== intentInitErrorDetail.exception_type
|
||||
? ` → ${intentInitErrorDetail.root_type}`
|
||||
: ""}
|
||||
</span>
|
||||
)}
|
||||
</div>
|
||||
<p className="text-red-700 font-medium break-all">{intentInitError}</p>
|
||||
{intentInitErrorDetail?.hint && (
|
||||
<p className="mt-1.5 text-red-800 bg-amber-50 border-l-2 border-amber-400 px-2 py-1 rounded-sm">
|
||||
<span className="font-bold">💡 建议:</span> {intentInitErrorDetail.hint}
|
||||
</p>
|
||||
)}
|
||||
{intentInitErrorDetail?.trace_tail && intentInitErrorDetail.trace_tail.length > 0 && (
|
||||
<details className="mt-1.5">
|
||||
<summary className="cursor-pointer text-red-600 hover:text-red-800 select-none text-[10px] font-bold">
|
||||
展开 traceback 末段(共 {intentInitErrorDetail.trace_tail.length} 行)
|
||||
</summary>
|
||||
<pre className="mt-1 max-h-48 overflow-auto bg-slate-900 text-slate-100 text-[10px] leading-snug p-2 rounded font-mono whitespace-pre">
|
||||
{intentInitErrorDetail.trace_tail.join("\n")}
|
||||
</pre>
|
||||
</details>
|
||||
)}
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
)}
|
||||
@@ -3091,7 +3180,8 @@ export default function RoundtablePlanningPage() {
|
||||
<div className="space-y-1">
|
||||
<label className="text-[9px] font-black text-slate-500 uppercase tracking-wider block">推理本源模型</label>
|
||||
<select
|
||||
value={agentConfigs[selectedAgentId]?.model || DEFAULT_MODEL}
|
||||
// 抽屉里显示的「当前模型」:Persona 覆盖优先,否则跟随全局 selectedModel
|
||||
value={agentConfigs[selectedAgentId]?.model || selectedModel || ""}
|
||||
onChange={(e) => {
|
||||
const val = e.target.value;
|
||||
setAgentConfigs(prev => ({
|
||||
@@ -3106,7 +3196,7 @@ export default function RoundtablePlanningPage() {
|
||||
disabled={modelsLoading}
|
||||
>
|
||||
{availableModels.length === 0 && (
|
||||
<option value={DEFAULT_MODEL}>{DEFAULT_MODEL}</option>
|
||||
<option value="">{modelsLoading ? "加载中…" : "未配置模型"}</option>
|
||||
)}
|
||||
{availableModels.map((m) => (
|
||||
<option key={m.name} value={m.name}>
|
||||
@@ -3580,6 +3670,44 @@ export default function RoundtablePlanningPage() {
|
||||
</>
|
||||
) : (
|
||||
<>
|
||||
{/* Panel 0: 推理模型选择器
|
||||
─────────────────────────────────────────────────────
|
||||
全局选中模型(selectedModel)影响 Step 1 / 推荐 / Step 2 init /
|
||||
总控 leader / 子席位 special 所有 API 调用。Persona 抽屉里
|
||||
per-seat 覆盖优先级更高。
|
||||
选项来自 /api/models(由 config.yaml 配置),内网部署只需配自家模型。 */}
|
||||
<div className="bg-white border border-slate-200/50 rounded-2xl p-4 shadow-[0_2px_8px_rgba(0,0,0,0.01)]">
|
||||
<div className="flex items-center gap-2 border-b border-slate-100 pb-2.5 mb-2.5">
|
||||
<Cpu className="w-4 h-4 text-primary" strokeWidth={2.5} />
|
||||
<h2 className="text-xs font-bold text-slate-900 uppercase tracking-widest">推理模型</h2>
|
||||
</div>
|
||||
<select
|
||||
id="global-model-select"
|
||||
value={selectedModel}
|
||||
onChange={(e) => setSelectedModel(e.target.value)}
|
||||
disabled={modelsLoading || availableModels.length === 0}
|
||||
title={
|
||||
modelsLoading
|
||||
? "正在加载模型列表…"
|
||||
: availableModels.length === 0
|
||||
? "未在 config.yaml 中配置任何模型"
|
||||
: "切换全局推理模型;不影响 Persona 抽屉里已设置的 per-seat 覆盖"
|
||||
}
|
||||
className="w-full bg-slate-50/50 border border-slate-100 rounded-xl px-3 py-2 text-xs font-bold text-slate-700 cursor-pointer focus:outline-none focus:border-primary focus:ring-1 focus:ring-[var(--brand-200)]/50 disabled:opacity-50 disabled:cursor-not-allowed dark:bg-secondary dark:text-foreground dark:border-border"
|
||||
>
|
||||
{availableModels.length === 0 && (
|
||||
<option value="">{modelsLoading ? "加载中…" : "未配置模型"}</option>
|
||||
)}
|
||||
{availableModels.map((m) => (
|
||||
<option key={m.name} value={m.name}>
|
||||
{m.display_name && m.display_name !== m.name
|
||||
? `${m.display_name} (${m.name})`
|
||||
: m.name}
|
||||
</option>
|
||||
))}
|
||||
</select>
|
||||
</div>
|
||||
|
||||
{/* Panel 1: 当前意图摘要 */}
|
||||
<div className="bg-white border border-slate-200/50 rounded-2xl p-4.5 shadow-[0_2px_8px_rgba(0,0,0,0.01)]">
|
||||
<div className="flex items-center gap-2 border-b border-slate-100 pb-2.5 mb-2.5">
|
||||
|
||||
Reference in new issue
Block a user