使用指南
路由与积分
了解供应商尝试过程、控制单次路由调用,并查看实际用量。
供应商如何选择
people_search 等工具会先找出能接受当前输入、且服务端可用的供应商,再按配置顺序和适用的个人偏好调用。这不代表每次都会选择最便宜或最快的供应商。
开启后续尝试时,遇到错误或没有匹配结果,路由可以继续尝试其他供应商。多数能力在一家返回结果后结束;合并人物账号等能力则可能汇总多家的结果。
控制单次路由调用
| 选项 | 作用 |
|---|---|
max_credits | 设置一次路由调用的积分上限。如果某次尝试的报价会使累计用量超出上限,就跳过它。 |
vendor | 限定使用某个供应商或接口 ID。 |
waterfall: false | 尝试第一家供应商后就结束,即使没有结果或发生错误,也不继续尝试。 |
你可以在调用设置中保存供应商偏好和各项能力的积分上限。这些路由控制适用于能力工具;直接使用 call_tool 不会应用这些设置。单次调用上限也不等于整段对话中多次调用的总预算。
什么情况会计费
调用前查看当前目录或 endpoint 详情。各接口的价格和计费规则不同,请求更多条结果也可能影响报价。
- 成功的尝试按该接口适用的价格计费。
- 如果接口规则包含空结果计费,没有匹配结果也可能扣积分;
per_call和per_result都属于这种情况。 - 供应商出错时,该次尝试不扣积分;同一路由调用中的其他尝试可能已经产生费用。
查看结果与用量
路由结果包含 outcome、统一格式的 output 和 _dinq 信息。_dinq.tried 列出各次供应商尝试及积分,_dinq.credits 是这次调用报告的总积分。返回的 plan 表示候选顺序,不代表每一家都成功返回了结果。
在调用记录中查看已记录的供应商尝试,在概览中查看余额。一次路由任务可能对应多条调用记录。
达到单次调用上限
budget_exceeded 表示接口因本次调用的 max_credits 上限被跳过,不代表账户余额不足。跳过的接口未调用、未收费;如果已尝试部分接口,搜索结果可能不完整。检查已尝试与跳过数量,先征求同意再提高上限,或选择成本更低的接口;不要原样重复请求。
用量统计
用量统计支持查看近 7、30、90 天的数据,按能力、供应商汇总,展开供应商可查看具体接口。每条接口尝试记录算一次调用,包含失败;一次任务可能调用多次。记录积分不等同于已对账的支付流水,可能与最终扣款不同,统计最多延迟 30 秒更新。调用记录保留最近的逐次调用明细。