Skip to main content
POST
记录一次路由纠正
记录一次路由纠正——即开发者对已解析的模式表示不认同,并提供了他们期望的模式的一次对话轮次。Theo 会为每个调用方保留最近 30 天的纠正记录,并按 expected_mode 对其进行聚类;一旦某个聚类超过阈值,playground 就会显示一条“我发现了一个规律”的提示,开发者可以据此让 Theo 建议一条规则,该规则由该聚类推导而来。 纠正记录的作用域为个人或团队级别(与调用方当前激活的组织上下文一致),因此个人的纠正记录不会触发团队级别的建议提示条。

身份验证

需要携带具备 billing API 密钥作用域的 Bearer 令牌。该接口是幂等的:相同的 Idempotency-Key 请求头会重放相同的响应。

请求体

string
必填
产生了非预期模式的提示词。长度为 1–4096 个字符。会在服务层做供应商名称脱敏处理。
string
必填
开发者期望的 Theo 模式(例如 "think"、"image"、"insurance_quote")。
string
可选参数,指该纠正所关联对话轮次的消息 id。长度不超过 128 个字符。

请求示例

curl

响应

当 pattern_suggestion_available 为 true 时,可调用 POST /api/v1/routing-preferences/suggest-rule,并传入匹配的 expected_mode,即可获得一条由该聚类推导出的确定性正则表达式。

错误

  • 400 routing_correction_invalid —— 通用的请求结构校验失败。
  • 400 routing_correction_vendor_name —— 提示词中提及了上游供应商名称(如 Claude、OpenAI 等)。
  • 400 routing_correction_invalid_mode —— expected_mode 不是已知的 Theo 模式。