管理上下文
管理 Prompt
Prompt 自定义功能位于当前 master。它修改一个 Scope 内的操作提示词,不能改变输出结构、工具可用性或权限。
采集的用户 Prompt 属于 Source 证据,是另一条工作流。
profile.generate 用于自定义自动或手动 flush 时的画像生成指令。自定义内容只影响后续处理窗口;
画像的证据边界、人物归属、敏感属性禁止推断和输出契约仍由服务端固定。
编辑与验证
- 通过
GET /v1/scopes/{scope_id}/prompts/{prompt_key}读取当前配置、内置指令及操作状态。 未启用的操作仍可读取配置,但保存配置不会启用该操作。由外部组件管理的 Prompt 可能没有可用内置指令。 - 按 Prompt 内容契约设置 Custom 指令和完整 JSON 输入/输出示例;生成的示例应在保存前检查。
- 通过 Artifact API 创建或条件替换 Prompt。保存成功产生不可变 Revision;遇到版本冲突时重新读取后再协调修改。
- 再次运行目标操作并检查输出。保存 Prompt 不会重新处理历史 Sources 或重跑先前操作。
保存 Auto 模式可使用当前部署的内置指令。恢复历史内容时创建新的 Revision,保留中间历史; 恢复 Auto 模式会使用当前内置指令。Dashboard 不提供 Prompt 编辑页面。
在 enforced 模式下,创建、替换、切换 Auto 和恢复都需要当前 scope.admin 权限。
Scope 角色被撤销后,拥有 Prompt Artifact 也不能继续修改它。
要在另一个 Scope 中复用指令,请使用已注册的 prompt_key 创建或替换目标 Scope 的 Prompt。
通用 Artifact 发布接口会拒绝 Prompt,返回 422 / artifact_publication_unsupported,目标 Scope 保持不变。
应用可通过 GET /v1/scopes/{scope_id}/prompts/{prompt_key} 读取生效配置,再使用带条件写入的
Artifact API保存版本。支持的 key、请求结构和示例生成见 HTTP API。

