跳转到主要内容
POST
配置标注回复

授权

Authorization
string
header
必填

每个请求都通过 API Key 认证:Authorization: Bearer {API_KEY}。应用接口使用应用 API Key,知识库接口使用知识库 API Key(快速开始)。

API Key 应保存在服务端,切勿嵌入客户端代码。缺失或无效的 Key 会返回 HTTP 401unauthorized)。

路径参数

action
enum<string>
必填

启用还是禁用标注回复。

可用选项:
enable,
disable

请求体

application/json

配置标注回复设置的请求体。

embedding_provider_name
string
必填

嵌入模型供应商(例如 openai)。可用供应商从 获取可用模型 获取。

embedding_model_name
string
必填

用于将标注向量化以进行匹配的嵌入模型(例如 text-embedding-3-small)。

score_threshold
number<float>
必填

标注被视为匹配的最低相似度分数。值越高,要求匹配越精确。

响应

200 - application/json

标注回复设置任务已启动。

job_id
string<uuid>

异步任务 ID。配合 查询标注回复配置任务状态 使用以跟踪进度。

job_status
string

当前任务状态,仅为 waiting(排队中)或 processing(处理中);completederror 仅由 查询标注回复配置任务状态 返回。