- 添加 mipu-api 作为 git submodule (Claude Code Skill) - 迁移 API 文档源文件到 docs/ 目录统一维护 - 添加 Gitea Actions 工作流:tag推送自动打包docs并发布Release - Skill 运行时自动从 mipu-open Release 下载最新文档 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2.4 KiB
2.4 KiB
Proxy约定说明
用户可在luban系统(my.mipuyun.com)管理我们提供的高质量住宅代理。
为了更有效的使用代理,对于Proxy字段的发送提供以下约定
1. 指定代理地区/国家
在proxy名后拼接 -国家码(地区码),myproxy是代理命名,举例如下:
| 地区(国家) | 码 | Proxy命名举例 |
|---|---|---|
| 美国 | us | myproxy-us |
| 法国 | fr | myproxy-fr |
| 英国 | uk | myproxy-uk |
| 欧洲 | eu | myproxy-eu |
2. 利用多个代理提升agent质量
为提升agent对接的质量,支持在proxy字段输入多个代理,并提供串行和并发来满足各种场景
拼接符号介绍
| 符号 | 说明 |
|---|---|
| 竖线 | | 多个代理随机选择 |
| 逗号 , | 多个代理串行选择,希望提升成功率,但可以接受响应速度略慢的场景 |
| 加号 + | 多个代理并发执行,应用于有较高成功率&较低响应速度的场景 |
代理使用示例
| 代理举例 | 适合场景 | 效果 |
|---|---|---|
| myproxy-us | 所有场景 | 指定US地区进行agent执行 |
| myproxy-us|myproxy-uk | 所有场景 | 从US, UK两个地区随机选择一个进行agent执行 |
| myproxy-us|myproxy-uk,myproxy-us|myproxy-eu | shopping/search | 仅对shpping/search生效,可接受较大的响应时长等待,第一轮采用myproxy-us|myproxy-uk进行对接。如果成功,立即返回结束业务。如果失败,采用myproxy-us|myproxy-eu启动第二轮对接。 |
| myproxy-us + myproxy-uk | shopping/select shopping/baggage shopping/seat |
采用多线程并发模式,线程a采用myproxy-us,线程b采用myproxy-uk, 同时向航司发起业务请求。 |
| myproxy-us|myproxy-eu + myproxy-uk|myproxy-uk | shopping/select shopping/baggage shopping/seat |
采用多线程并发模式,线程a采用myproxy-us|myproxy-eu,线程b采用myproxy-uk|myproxy-uk, 同时向航司发起业务请求。 |
3. 异常处理
如果将符号用在了不支持的场景怎么办?
系统会最大限度接受异常的代理串输入,但会选择最保守的执行方式,我们会采集最小的代理信息进行执行。
示例:
- 并发场景(select/baggage/seat)收到逗号:
myproxy-us,myproxy-uk - 那么执行层会变成:
myproxy-us