Azure LLM 网关代理
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/azure-gateway-cli。
技能介绍
问题背景
在 Skill 平台里把 Azure 配成 llm-provider 时,平台会按自己的规则拼请求 URL:在已有 baseUrl 上再追加路径段。而 Azure OpenAI 的 REST 约定往往把 api-version 写在基础地址或查询参数里。两边格式一对接,就容易出现 路径被错误拼接、api-version 失效或请求落到错误资源上——本地 Agent 或网关能连上,但一调用就 404/格式错误。
工作原理与关键步骤
azure-gateway-cli 是在本机跑的一层 轻量 Node.js 反向代理:对外暴露一个固定本地端口(默认 18790),对内把 Skill 平台发出的请求 重写/转发 成 Azure 能识别的 URL 与头信息。配置上需要在 ~/.skill-platform/skill-platform.json 里把 Provider 指到该代理,并显式设置 authHeader: false,因为 Azure 用 api-key 头而不是 Bearer Token。
典型流程:启动代理并写入 AZURE__ENDPOINT、AZURE__DEPLOYMENT、AZURE__API_VERSION 等环境变量 → 在 Skill 平台侧改 Provider 的 baseUrl 指向 http://127.0.0.1:18790(或你绑定的地址)→ 用健康检查确认通路 → 再跑对话或子 Agent 任务。需要长期驻留时,可按仓库模板挂 systemd 服务。
边界与注意点
- 代理只解决 URL/鉴权头与平台默认行为的不匹配,不替代你在 Azure Portal 里配置 endpoint、deployment 与密钥。
- 401 多为 Key 错误或过期;404 多为 hostname 与 deployment 名与门户不一致。
- Azure 内容策略较严,部分在其它 provider 上能过的 prompt 可能被拦截,需在业务侧做降级或改写。
- 技能分类为 MD+EXEC:说明在 Markdown 里,实际起代理要具备本地执行命令的能力;代理在单机上运行,不解决多设备配置同步。
使用场景
- 已在 Skill 平台添加 Azure Provider,但对话一调用就出现 404 或 URL 拼接错误
- 需要把自动化子 Agent 的流量统一走本机代理,以便消耗 Azure 部署额度而非其它模型
- 要在 Linux 服务器上用 systemd 常驻代理,供同一台机上的 Agent 连接 Azure
- 从其它 OpenAI 兼容网关迁到 Azure,却不想改 Agent 侧除 baseUrl 以外的调用习惯
适合人员
- 在 Cursor/Codex 等 Agent 里接 Skill 平台、且企业模型固定在 Azure 上的后端工程师
- 负责把团队 LLM 网关从公有兼容 API 迁到 Azure OpenAI 的平台运维
- 编写定时子 Agent 流水线、希望任务流量固定走 Azure deployment 的自动化作者
- 在本地调试 Skill Provider 配置、需要快速区分 URL 问题与 Key/部署名问题的集成开发者