init: mipu-open 对外开放项目统一管理仓库
- 添加 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>
This commit is contained in:
55
docs/11_proxy-conventions.md
Normal file
55
docs/11_proxy-conventions.md
Normal file
@@ -0,0 +1,55 @@
|
||||
<!-- 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`
|
||||
Reference in New Issue
Block a user