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

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

前置配置

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

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

写入或更新任务详情

PUT /api/task-deeplink-details/b5-1/{id}
Content-Type: application/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。

成功响应示例：

{
  "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 字段区分）。

用户跳转

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

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

可选参数：

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

示例：

/#/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 时归入该任务的无类型分区（与历史链接的行为一致）。

4.4 KiB Raw Permalink Blame History Unescape Escape

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

前置配置

写入或更新任务详情

用户跳转

4.4 KiB

Raw Permalink Blame History