Prompt、知识与探针

本页路径均相对 /openapi/v1/workspaces/{workspaceId}/management/；鉴权、预检和操作状态见调用约定。

Prompt 配置

方法与路径	用途
GET prompt-scenes/	列出可配置场景及模板字段
GET prompt-llms/	列出当前客户可绑定的推理模型
GET prompts/{scene}/effective/?language=...	读取实际生效文本、模型、来源、工作区覆盖和 revision
POST prompts/preview/	预检设置或重置
PUT prompts/{scene}/{language}/	设置指定语言的工作区覆盖
DELETE prompts/{scene}/	重置整个场景的工作区覆盖

设置时向 preview/ 提交 action: "set"、scene、language、当前 revision 和 changes；再以相同 changes、planToken 及 Idempotency-Key 调用 PUT。重置时以 action: "reset" 预检，然后调用 DELETE。llmId 用于绑定模型，clearLlmBinding 用于解绑；均省略时保留原绑定。工作区文本为空时会回退到全局或内置文本，推理模型独立回退。以 effective/ 的 textSource 和 llmSource 判断实际生效来源。

知识对象

集合路径	可用操作	说明
corpora/	列表、详情、预检、创建、修改、删除	管理语料、启用状态、适用场景及模型范围
sops/	列表、详情、预检、创建、修改、删除	管理 SOP 内容、推荐和启用状态
standard-answers/	列表、详情、预检、修改、删除	管理已有标准回答；创建仍使用现有问答流程

这些集合的详情使用 {id}/，预检使用 POST {集合}/preview/。创建调用 POST {集合}/，修改调用 PATCH {集合}/{id}/，删除调用 DELETE {集合}/{id}/；标准回答没有创建接口。预检请求使用 action、targetId、revision、changes，提交时传相同 changes 和 planToken，请求头带 Idempotency-Key。列表支持 offset、limit 分页并返回 count。

POST sops/{id}/reembed/ 可幂等触发 SOP 重新向量化，需 Idempotency-Key，返回 operationId。现有 SOP 向量任务没有持久化的成功证据，任务完成时操作状态仍可能为 unknown；应通过实际召回验收。

实际问法验收

方法与路径	用途
POST probes/cut/	查看分词和资源命中，可与预期比较
POST probes/question/	以指定工作区成员的数据权限运行实际问法

问法探针要求 memberUid，响应包含解析、所选模型 UID、卡片数量和配置修订值，不返回原始数据行。探针及关联、SQL 试查、采样均受限执行；超时或证据不足时可能返回 unknown，应调整输入或检查真实业务结果后再判断是否生效。