Azure 网关代理
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/azure-gateway-cli-free。
技能介绍
背景:两套 URL 规则为什么对不上
Skill 平台在转发请求时,会按自己的规则在 baseUrl 后面追加路径。Azure OpenAI 的 REST 规范里,api-version 常常已经写在资源根地址里(查询参数或固定片段)。平台继续拼路径时,很容易把 Azure 期望的 endpoint 结构弄坏,表现为连接成功却 404 Resource not found,或者请求压根没落到正确的 deployment 上。
这不是单纯「换一行配置」能修的:问题出在 Agent 侧 Provider 的 URL 组装方式 与 Azure 网关格式不兼容,需要在中间加一层本地代理做协议与路径适配。
这个技能在做什么
Azure Proxy 提供的是一个 disclosed、可本地运行的轻量 Node.js 代理,把 Skill 平台侧的请求转成 Azure 能接受的形态再转发。核心能力包括:
- Provider 对接:在
$HOME/.skill-platform/skill-platform.json里把上游指到本地代理,并设置authHeader: false(Azure 走api-key头,不是 Bearer)。 - 参数与输出说明:覆盖端口绑定、deployment 名称、
api-version等环境变量,以及健康检查与排错表(404 主机名/deployment 不匹配、401 Key 失效、内容安全过滤误拦等)。 - 可选 Subagent 路由:把自动化子任务走 Azure 配额,减轻主会话对大模型的依赖。
- 常驻部署:提供 systemd 模板,把代理当本机服务跑在默认端口(如
18790)。
适用边界
- 需要有效的 Azure OpenAI 资源与 API Key,无 Key 或断网无法工作。
- 代理 本地运行,不解决多设备配置同步;每台跑 Agent 的机器各自维护代理与 JSON。
- Azure 内容策略 可能比 OpenAI 官方更严,在别的 llm-provider 能过的 prompt 可能被拦截。
- 资料中的能力偏 配置、排错与路由,不替你做复杂业务决策;遇到 deployment 名与门户不一致等问题仍需你对照 Azure Portal 核对。
使用场景
- 已在 Skill 平台配置 Azure Provider,但 Agent 调用总报 404,需要本地代理修正 URL 拼接
- 希望子 Agent 的批处理任务统一走 Azure deployment,避免主会话占用其它 LLM 配额
- 在 Linux 工作站上长期跑 Cursor/Code 类 Agent,需要把 Azure 代理注册为 systemd 服务
- 从 OpenAI 兼容端点迁到 Azure 后,需把鉴权从 Bearer 改为 api-key 并完成 Provider 对接
适合人员
- 日常用 Cursor/Code 接公司 Azure OpenAI 资源、却被平台 URL 拼接搞崩调用的后端工程师
- 要为团队 Subagent 流水线指定 Azure 节点、并写清环境变量与排错表的平台维护者
- 在自管 Linux 机上跑 Agent、需要本机常驻代理与健康检查的实践者
- 从公有 OpenAI 切到 Azure 门户 deployment,正在核对 endpoint 与 deployment 名称的集成开发者