SuperAPI AI 工具集

flexport-performance-tuning

智能体与模型

查看项目

更新于 10-15 23:26

技能介绍

用途:在保持正确性、账户边界与供应商稳定性的前提下,调优 Flexport 集成的延迟与吞吐。适用于读取缓慢、积压增长或 MCP 相关场景。

主要能力与步骤:先选定单一瓶颈,明确操作、接口面、数据窗口与业务目标,并用共享缓存把令牌获取排除在请求并发之外;使用原生分页,REST 按文档跟随响应链接,MCP browse_shipments 在 has_next_page 为 true 时推进 end_cursor,first 保持在 1–100;控制展开,货运发票索引调用按建议避免展开,仅对需要的记录取详情;谨慎提升,只对只读工作提高一个页大小或工作线程上限,测量延迟、错误与积压影响,出现供应商或正确性退化即停止;保护写操作,预订与贸易记录写入按业务键串行化,不纳入批量读取调优;最后对账,在同一有界窗口比较计数与终止游标/链接,记录所选控制项与回滚方案。

认证:REST 使用缓存的 OAuth 2.0 客户端凭据 Bearer 令牌,audience 为 https://api.flexport.com,或显式接受的宽泛 API key;每个工作负载使用独立凭据,绝不记录凭据或令牌。MCP 使用到 https://mcp.flexport.com/mcp 的已认证连接,并受各工具文档化账户权限约束。

工具纪律:用 Read 与 Grep 做发现与取证;仅在批准的产物、代码、配置、测试或回执上使用 Write 或 Edit,不做未批准的 Flexport 侧变更。

输出:范围明确的决策或实现产物、脱敏的操作与验证回执、失败/回滚/后续责任记录。回执示例字段包括 surface、operation、decision、outcome、evidence(release_sha、provider_reference 脱敏)、rollback_owner,不得放入凭据或供应商负载。

错误处理:结果计数不一致则拒绝调优并检查游标/链接处理;延迟改善但错误上升则回滚并发并重新评估瓶颈;索引展开主导负载则移除并单独取详情;写操作进入批量池则安全排空、对账并恢复按键串行化。

限制:资料未提供具体性能数值、收费、平台支持范围与完整代码示例,需以实际测量与官方文档为准。