技能介绍

解决的问题

在海外运营平台的发货管理链路中，查询托管信息是业务推进的常见环节，但该需求往往嵌套在更复杂的多接口流程里。如果直接编写完整脚本或集成多个步骤的代码，容易出现参数传递混乱、接口地址被误改、登录态处理不统一等问题，导致调试成本增加。这个技能是最小颗粒度的接口实现，只专注于查询托管信息的单一动作，为上层Agent或业务编排逻辑提供可复用的原子能力，让多步骤业务流程的拆分和调整更灵活。

核心能力与执行逻辑

固定正式环境调用地址：技能将正式环境地址写在 frontmatter 的 base_url 中，执行时不接受用户输入覆盖，避免开发、测试、生产环境地址混用的问题。
规范参数传递结构：所有工具参数统一封装在嵌套的 params 对象中，不同类型参数存放位置清晰：Path 参数放 params.path，Query 参数放 params.query，JSON Body 放 params.body，额外 Header 放 params.headers。登录态处理也有明确规则，通过 params.accessToken 生成 Authorization: Bearer 请求头，若传入值已包含 Bearer 则不重复拼接。
接口能力聚焦：仅支持 GET /shipping-auto-delivery 接口的 auto_delivery 动作，用于查询托管信息，返回结构为 AutoDeliveryVO。执行时严格按照接口定义选择 HTTP 方法和路径，URL 中的变量从 params.path 替换。
结果与错误处理：返回结果以接口响应为事实来源，不补造库存、价格等额外信息；若接口返回认证、权限、参数或业务错误，会将原始错误码和信息透传给上层 Agent，便于后续流程定位问题。

适用边界与注意事项

单一动作局限性：技能仅实现查询托管信息的单一接口动作，不包含完整的业务链路编排。若用户需求涉及多个接口步骤，需由上层 Agent 将本技能与其他原子技能组合，按聚合技能或计划文档的约定完成流程编排。
环境与权限约束：调用必须使用 frontmatter 中的正式环境地址，且需满足当前登录态、租户和用户权限要求；若需要处理测试环境或其他租户场景，需由上层流程提供对应环境的配置或权限凭证。
参数格式要求：调用时最外层仅允许使用 params 对象，禁止使用 params.xxx 这类点号作为顶层 key，避免参数解析失败。