目录:白名单 · 对话路由 · 重试 · 脱敏 · 流水线摘要 · 矩阵 · 七步 · 可引用 · 问答
本文为 AutoGen 写可照抄顺序:与 CrewAI 网关篇、Semantic Kernel 篇 不同,核心是代理图与函数注册。重试与 Schema 见 重试篇;别名见 LiteLLM 篇;观测见 可观测矩阵。购买、定价 公开免登录。
痛点:吊销面碎、路由糊、无分桶并发拖尾延迟。
最小权限白名单
Dashboard 签发网关令牌最小作用域,文件六百权限不入库。tools/allowlist.json 登记路由名、动词与 JSON Schema(草案七或二零统一即可)。register_function 薄封装先校验;网关镜像校验防绕过。写路径单独路由与保留期。
对话路由
GroupChat 或 selector 为各 Assistant 绑 route_key,网关按对话拆配额;检索与补全分桶免抢 TPM。工具 HTTP 带 X-Conversation-Id、X-Correlation-Id。AutoGen 重轮次与发言人;人机回路单独键与更低并发。
重试模板
幂等读路二至三次指数退避加抖动;写路默认一次或幂等键去重。限流五类错优先 retry_after_ms。错误码映射短提示,勿塞堆栈。细节同 重试篇。
日志脱敏
日志与 Webhook 固定:时间、路由、状态、关联、阶段、短提示;截断提示与供应原文,子错留安全子集。回调用最小权限令牌加队列防风暴。原文审计另库评审。
流水线摘要示例
检查失败时写短摘要供用户代理下一轮读取:
echo "## 网关工具失败摘要" >> "$GITHUB_STEP_SUMMARY"
echo "- 路由: search_repo" >> "$GITHUB_STEP_SUMMARY"
echo "- 状态: 五二九" >> "$GITHUB_STEP_SUMMARY"
echo "- 关联: ${CORR_ID}" >> "$GITHUB_STEP_SUMMARY"无托管则写 Markdown 由脚本挂载代理输入。
| 层 | 负责 | 失败先看 |
|---|---|---|
| OpenClaw | 令牌校验、工具白名单、并发预算与熔断计数 | 四零一、四二九、网关追踪标识 |
| AutoGen | 代理图、发言人策略、函数注册与轮次上限 | 单轮超时、最大轮次、选路人僵死 |
| 观测与流水线 | 脱敏信封、作业摘要、租户键对齐财务切片 | 回调队列、截断策略、密钥轮换 |
上表用于排障分责:网关先看鉴权与配额,客户端先看轮次与超时,流水线先看回调是否拥塞。并发预算建议从每进程四到八在飞工具起调,观察百分九十五延迟后再升档。
落地七步(可复现)
- 固定 Python 与 venv,根目录与缓存落持久盘。
- OpenClaw 与上游只绑回环,外网不放行工具上游。
- 清单加 Schema,启动拒未登记工具。
base_url指网关,api_key用网关令牌。- 按
route_key配在飞上限、每分钟请求、冷却,错率半开。 - 失败回调写脱敏信封,租户键对齐跨度。
- 双代理探针后通宵泡租用节点。
可引用信息
- 令牌分桶短生存期,吊销粒度到路由键。
- 回调带配置版本钉发布。
- 预算与机时账单同租户键切片。
常见问题
要 LiteLLM 吗?不必;别名与预算在网关集中即可。
与 Crew 差异?Crew 重任务链;AutoGen 重多代理图与轮次。
摘要含原文?默认不含;合规另库。🚀