b450b512a2
- 添加 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>
56 lines
2.4 KiB
Markdown
56 lines
2.4 KiB
Markdown
<!-- mipuyun-api-doc: 11_proxy-conventions -->
|
||
# 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**<br>**shopping/baggage**<br>**shopping/seat** | 采用多线程并发模式，线程a采用myproxy-us,线程b采用myproxy-uk, 同时向航司发起业务请求。 |
|
||
| myproxy-us\|myproxy-eu + myproxy-uk\|myproxy-uk | **shopping/select**<br>**shopping/baggage**<br>**shopping/seat** | 采用多线程并发模式，线程a采用myproxy-us\|myproxy-eu,线程b采用myproxy-uk\|myproxy-uk, 同时向航司发起业务请求。 |
|
||
|
||
---
|
||
|
||
## 3. 异常处理
|
||
|
||
### 如果将符号用在了不支持的场景怎么办？
|
||
|
||
系统会最大限度接受异常的代理串输入，但会选择最保守的执行方式，我们会采集最小的代理信息进行执行。
|
||
|
||
**示例**：
|
||
- 并发场景(select/baggage/seat)收到逗号：`myproxy-us,myproxy-uk`
|
||
- 那么执行层会变成：`myproxy-us`
|