操作场景
企业同时使用多个 Agent 平台（如 Coze、Dify、自建 Agent Runtime），各平台独立部署、各自暴露 HTTP 接口，业务侧需分别对接不同地址与鉴权方式，管理成本高且无法统一审计。通过 AI 网关 Agent API，您可以将所有 Agent 服务统一收口至单一入口，实现：
多源 Agent 统一接入：将不同平台的 Agent 服务（Coze / Dify / 自建 Runtime / MCP Server）通过路由规则分发至对应后端，业务系统只需对接网关一个入口。
协议无关透明代理：不依赖任何特定厂商协议，后端只要是 HTTP/S 服务即可接入，无需适配 SDK 或改造现有 Agent。
统一治理与可观测：所有 Agent 请求经过网关统一鉴权、限流、审计，调用链路全量可追踪。
前置条件
已创建 AI 网关实例
已创建后端服务(在 服务管理 > 服务 中配置)
操作步骤
创建 Agent API
步骤1：进入 Agent API 列表页
1. 登录 AI 网关控制台；
2. 在左侧导航栏选择 Agent 管理；
3. 单击 新建。
步骤2：配置基本信息
在弹出的创建弹窗中，配置以下信息：
参数 | 是否必填 | 说明 | 示例 |
API 名称 | 是 | Agent API 的唯一标识，支持英文、数字、下划线、短横线，长度1-64字符 | agent-backend-api |
协议 | 是 | 固定为"自定义"(区别于模型 API 的 OpenAI 兼容协议) | 自定义 |
Base Path | 是 | API 的路径前缀，所有路由路径都会以此为前缀 | /agent |
Base Path 说明：
假设配置 Base Path 为
/agent，创建路由路径为/api/users，客户端访问地址：https：//{网关域名}/agent/api/users步骤3：完成创建
确认配置无误后，单击 确定 完成 Agent API 创建。创建成功后，会自动跳转到 Agent API 详情页。
管理 Agent API
查看 Agent API 列表
在 Agent 管理 > Agent API 列表页，可查看所有已创建的 Agent API：
查看 Agent API 详情
单击 API 名称进入详情页，查看 API 的基本信息。
编辑 Agent API
1. 在 Agent API 列表页，单击操作列的 编辑；
2. 修改 API 基本信息(注意：API 名称创建后不可修改)；
3. 单击 确定 保存修改。
删除 Agent API
1. 在 Agent API 列表页，单击操作列的 删除；
2. 在弹出的确认对话框中，单击 确定。
注意：
删除 Agent API 后，该 API 下的所有请求将无法路由，请谨慎操作。
创建路由规则
Agent API 通过路由规则将请求分发到不同的后端服务。一个 Agent API 可以创建多条路由规则。
步骤1：进入路由列表
1. 在 Agent API 详情页，选择 路由列表 Tab；
2. 单击 创建路由。
步骤2：配置基本信息
基本信息
字段 | 是否必填 | 说明 | 示例 |
路由名称 | 否 | 路由的名称，支持中文、英文、数字、 .、-、_ | 用户服务路由 |
请求协议 | 是 | 选择支持的协议，默认"HTTP&HTTPS" | HTTP&HTTPS |
匹配规则
字段 | 是否必填 | 说明 | 示例 |
请求方法 | 否 | 支持的 HTTP 方法，可多选 | GET、POST |
请求路径 | 否 | 路径匹配规则，支持精确匹配、前缀匹配、正则匹配 | 前缀匹配： /api/users |
Host | 否 | 主机名匹配，支持大小写敏感配置，可添加多个 | api.example.com |
Header | 否 | 请求头匹配，键支持数字、字母、 _、-，可添加多个 | X-Service： user-service |
步骤3：配置路由后端
在第二步中，配置路由的后端服务，从"服务管理>服务"列表中选择后端服务。
步骤4：完成创建
单击 完成创建，路由规则创建成功。
编辑和删除路由
编辑路由
1. 在 Agent API 详情页 > 路由列表 Tab，选择需要编辑的路由；
2. 单击右侧路由详情区域的 编辑路由 按钮；
3. 修改路由配置(两步向导，与创建流程相同)；
4. 单击 确定 保存修改；
5. 修改后的路由需要重新发布才会生效。
删除路由
1. 在 Agent API 详情页 > 路由列表 Tab，选择需要删除的路由；
2. 单击右侧路由详情区域的 更多操作 > 删除；
3. 在确认对话框中单击 确定。
注意：
删除路由后，该路由的所有请求将无法路由，请谨慎操作。
查看路由详情
在 Agent API 详情页 > 路由列表 Tab，左侧路由列表选择路由后，右侧会展示路由详情。
