管理上下文

管理 Prompt

Prompt 自定义功能位于当前 master。它修改一个 Scope 内的操作提示词,不能改变输出结构、工具可用性或权限。 采集的用户 Prompt 属于 Source 证据,是另一条工作流。

profile.generate 用于自定义自动或手动 flush 时的画像生成指令。自定义内容只影响后续处理窗口; 画像的证据边界、人物归属、敏感属性禁止推断和输出契约仍由服务端固定。

编辑与验证

  1. 通过 GET /v1/scopes/{scope_id}/prompts/{prompt_key} 读取当前配置、内置指令及操作状态。 未启用的操作仍可读取配置,但保存配置不会启用该操作。由外部组件管理的 Prompt 可能没有可用内置指令。
  2. 按 Prompt 内容契约设置 Custom 指令和完整 JSON 输入/输出示例;生成的示例应在保存前检查。
  3. 通过 Artifact API 创建或条件替换 Prompt。保存成功产生不可变 Revision;遇到版本冲突时重新读取后再协调修改。
  4. 再次运行目标操作并检查输出。保存 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

On this page