# b5-1 任务分析深链接接入

`goPath=b5-1` 是「任务分析」单智能体问答入口。接入方先把任务详情写入 DeerFlow，再让用户登录并跳转；页面不会再调用接入方的任务详情接口。

## 前置配置

在「业务链条管理」页面新增的 **任务分析**（业务码 `b5-1`）行中选择要使用的默认单智能体。深链接也可以用 `?agentId=` 直接指定本次问答使用的智能体（优先于配置行）；两者都没有时，深链接不会进入问答页。

服务端无需为接入配置任何密钥。

## 写入或更新任务详情

```http
PUT /api/task-deeplink-details/b5-1/{id}
Content-Type: application/json
```

该接口为**开放写入**：不需要登录态，也不需要任何鉴权头，接入方服务端直接调用即可。写入者仅作审计记录。

```json
{
  "taskName": "重点活动舆情研判",
  "taskContent": "围绕活动期间的舆情风险、重点对象和处置建议开展分析。",
  "overview": "活动前后七天的综合研判任务",
  "type": "yuqing",
  "extra": {
    "sourceSystem": "B5",
    "priority": "high",
    "regionCodes": ["110000", "120000"],
    "customField": {
      "owner": "张三"
    }
  }
}
```

- `id` 与深链接中的 `taskId` 必须完全一致；存储键为 `(type, id, 业务类型)`，此处路径 `type` 固定为 `b5-1`。
- `taskName`、`taskContent` 必填；`overview`、`type`、`extra` 可选。
- `type` 是业务类型（≤64 字符），与深链接 `?type=` 对应：**同一个 id 可以存多个不同类型的详情快照**，各自独立版本号；不传 `type` 时写入无类型分区（与深链不传 `?type=` 的读取口径一致）。
- `extra` 必须是 JSON 对象，最大 64 KiB；用于接入方的扩展字段。
- 这是幂等接口，接入方不需要预先查询「是否已存」。每次直接 `PUT` 完整快照即可：
  - 首次写入：创建记录；
  - 任务名称、详情、简介或 `extra` 有任一变化：整体更新并递增 `version`；
  - 内容完全相同：只按主键读取并返回现有记录，不更新数据库、不递增 `version` 或 `updatedAt`。

成功响应示例：

```json
{
  "data": {
    "type": "b5-1",
    "id": "task-20261020-001",
    "taskType": "yuqing",
    "taskName": "重点活动舆情研判",
    "taskContent": "围绕活动期间的舆情风险、重点对象和处置建议开展分析。",
    "overview": "活动前后七天的综合研判任务",
    "extra": {
      "sourceSystem": "B5",
      "priority": "high"
    },
    "version": 1,
    "updatedAt": "2026-10-20T10:00:00+08:00"
  },
  "created": true,
  "changed": true
}
```

`created` 表示本次是否首次创建；`changed` 表示本次是否实际写入。对同样内容的重试，响应为 `created: false`、`changed: false`。响应中的 `taskType` 回显写入时的业务类型（注意与固定为 `"b5-1"` 的 `type` 字段区分）。

## 用户跳转

写入成功后，引导用户访问登录页（认证参数按既有接入方式附带）：

```text
/#/login?taskId=task-20261020-001&goPath=b5-1
```

可选参数：

| 参数 | 说明 |
| --- | --- |
| `agentId` | 直接指定本次问答使用的智能体 id，优先于「业务链条管理」b5-1 行的配置。 |
| `type` | 业务类型（≤64 字符，超长截断）。**详情快照与聊天记录都按 `(taskId, type)` 独立分区**：同一任务传入不同 `type` 时读取各自的详情、维护各自的对话历史，互不可见。 |
| `theme` | 页面主题色。**不传时默认深蓝色**；传入则按传入值解析明暗（`dark`/`dark-blue`/`深色`/`深蓝` → 深色，其余如 `lightblue` → 浅色）。主题只在任务分析页面与本次深链会话内生效，不影响用户在系统其它页面的外观偏好。 |

示例：

```text
/#/login?taskId=task-20261020-001&goPath=b5-1&agentId=analyst-01&type=yuqing
```

登录后前端按 `(taskId, type)` 读取本系统详情接口（对应 `GET /api/task-deeplink-details/b5-1/{id}?type=…`，需登录态），将任务名称和任务详情展示在左上角，标题固定为「任务分析」；`taskName`、`taskContent`、`overview` 与完整 `extra` 会作为每轮问答的隐藏任务上下文提供给智能体。聊天记录同样按 `(taskId, type)` 独立保存，不会混入其它任务深链、其它类型或通用聊天；未传 `type` 时归入该任务的无类型分区（与历史链接的行为一致）。