跳转到正文
使用指南

路由与积分

了解供应商尝试过程、控制单次路由调用,并查看实际用量。

供应商如何选择

people_search 等工具会先找出能接受当前输入、且服务端可用的供应商,再按配置顺序和适用的个人偏好调用。这不代表每次都会选择最便宜或最快的供应商。

开启后续尝试时,遇到错误或没有匹配结果,路由可以继续尝试其他供应商。多数能力在一家返回结果后结束;合并人物账号等能力则可能汇总多家的结果。

控制单次路由调用

选项作用
max_credits设置一次路由调用的积分上限。如果某次尝试的报价会使累计用量超出上限,就跳过它。
vendor限定使用某个供应商或接口 ID。
waterfall: false尝试第一家供应商后就结束,即使没有结果或发生错误,也不继续尝试。

你可以在调用设置中保存供应商偏好和各项能力的积分上限。这些路由控制适用于能力工具;直接使用 call_tool 不会应用这些设置。单次调用上限也不等于整段对话中多次调用的总预算。

什么情况会计费

调用前查看当前目录endpoint 详情。各接口的价格和计费规则不同,请求更多条结果也可能影响报价。

  • 成功的尝试按该接口适用的价格计费。
  • 如果接口规则包含空结果计费,没有匹配结果也可能扣积分;per_callper_result 都属于这种情况。
  • 供应商出错时,该次尝试不扣积分;同一路由调用中的其他尝试可能已经产生费用。

查看结果与用量

路由结果包含 outcome、统一格式的 output_dinq 信息。_dinq.tried 列出各次供应商尝试及积分,_dinq.credits 是这次调用报告的总积分。返回的 plan 表示候选顺序,不代表每一家都成功返回了结果。

调用记录中查看已记录的供应商尝试,在概览中查看余额。一次路由任务可能对应多条调用记录。

达到单次调用上限

budget_exceeded 表示接口因本次调用的 max_credits 上限被跳过,不代表账户余额不足。跳过的接口未调用、未收费;如果已尝试部分接口,搜索结果可能不完整。检查已尝试与跳过数量,先征求同意再提高上限,或选择成本更低的接口;不要原样重复请求。

用量统计

用量统计支持查看近 7、30、90 天的数据,按能力、供应商汇总,展开供应商可查看具体接口。每条接口尝试记录算一次调用,包含失败;一次任务可能调用多次。记录积分不等同于已对账的支付流水,可能与最终扣款不同,统计最多延迟 30 秒更新。调用记录保留最近的逐次调用明细。