我的威尼斯

要解决的接口调用问题

Agent 集成 Venice API 的 /example 端点时，常遇到三类问题：一是必填参数 field_a 漏填或取值超范围，直接触发 400 错误；二是限流场景下没有正确的退避策略，反复请求导致 429 持续失败；三是对响应结构和错误原因的对应关系不清晰，排查问题耗时。

技能的核心工作逻辑

该技能将 Agent 与 /example 端点的操作直接映射，核心能力包括三部分：

• 明确必填参数 field_a 的定义、有效取值范围与默认值，避免无效请求；
• 列出可选参数 field_b 的用途，让 Agent 能按需调整请求行为；
• 对错误响应做了结构化映射：遇到 400 时引导 Agent 按 schema 校验输入，遇到 429 时采用带抖动的指数退避策略。

适用边界与注意点

该技能仅覆盖 Venice API 的 /example 端点，不涉及其他接口；field_a 的取值必须严格符合文档要求，超范围会导致不可恢复的 400 错误；限流退避策略需遵循 Venice 的全局速率限制，不能自行缩短重试间隔。