跳转到主要内容
POST
确保知识存在

限制说明

使用说明

  • 幂等:若(scope, scope_id)已有知识则直接返回,否则创建一份空知识。
  • account 范围忽略 scope_id;只要该知识中没有 DUTY.md(包括被删除后),就会写入一份默认 DUTY.md。返回的 file_count/version 是写入前读取的,可能尚未包含该文件。
  • account 范围需要账户 Owner 或管理员;team 范围需要是该团队成员——Owner 和管理员也不例外。
  • 每次调用都会记录到账户审计日志。

授权

app_key
string
query
必填

在 Flashduty 控制台 我的 → APP Key 中创建的 APP Key。可通过 query 参数 app_key 或请求头 Fd-App-Key 传入。实际可访问范围是该 APP Key 的权限范围与创建者当前角色权限的交集,请妥善保管。

请求体

application/json

要确保存在知识的范围。

scope
enum<string>
必填

要确保存在的知识范围。

  • account:账户知识。scope_id 会被替换为调用者的账户 ID;仅账户 Owner 和管理员可调用,即使知识已存在也一样。若该知识中没有 DUTY.md,会写入一份默认 DUTY.md。
  • team:scope_id 指定团队的知识。必须传 scope_id,且调用者须是该团队成员。
可用选项:
account,
team
scope_id
integer<int64>

团队 ID。team 范围必填(非 0),否则返回 InvalidParameter;account 范围忽略。

响应

成功

所有 Flashduty 公开 API 共用的标准响应结构。成功时 data 为接口专属载荷且不含 error;失败时 error 存在而 data 缺失。request_id 始终存在,并会同步写入 Flashcat-Request-Id 响应头。

request_id
string
必填

本次请求的唯一 ID,与 Flashcat-Request-Id 响应头一致。反馈问题时请携带该 ID。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

响应结构中的错误 payload,仅在非 2xx 响应时出现。

data
object

知识——一棵带版本号的文件树,AI SRE 会话启动时会注入到每个沙箱中。每个(账户, scope, scope_id)仅有一份知识。