Agent Skills
返回列表
Azure 网关代理

Azure 网关代理

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 名称的集成开发者