一、操作场景
·多源 Agent 统一接入：将不同平台的 Agent 服务（Coze / Dify / 自建 Runtime / MCP Server）通过路由规则分发至对应后端，业务系统只需对接网关一个入口。
·协议无关透明代理：不依赖任何特定厂商协议，后端只要是 HTTP/S 服务即可接入，无需适配 SDK 或改造现有 Agent。
·统一治理与可观测：所有 Agent 请求经过网关统一鉴权、限流、审计，调用链路全量可追踪。
二、前置条件
·已创建 AI 网关实例。
·已创建后端服务(在服务管理 > 服务中配置)。
五、步骤1：进入 Agent API 列表页
1. 登录微服务平台控制台 ，在左侧导航栏选择 AI 网关进入实例列表。
2. 单击目标实例 ID/名称进入实例详情页，进入目标网关实例。
3. 在左侧导航栏选择 Agent 管理；
4. 在 Agent API 页签，单击新建。
六、步骤2：配置基本信息
在弹出的创建弹窗中，配置以下信息：
| 参数 | 是否必填 | 说明 | 示例 |
| API 名称 | 是 | Agent API 的唯一标识，支持英文、数字、下划线、短横线，长度1-64字符 | agent-backend-api |
| 请求协议 | 是 | 自定义（区别于模型 API 的 OpenAI 兼容协议）DifyA2A | 自定义 |
| 后端 Agent 服务 | 如请求协议选择 Dify 或 A2A 则必填 | 下拉选择对应类型的 Agent 服务，支持跳转新建 | – |
| Base Path | 是 | API 的路径前缀，所有路由路径都会以此为前缀。假设配置 Base Path 为/agent，创建路由路径为/api/users，客户端访问地址：https：//{网关域名}/agent/api/users | /agent |
| 描述 | 否 | 自定义相关描述信息 | xx 功能 |
七、步骤3：完成创建
确认配置无误后，单击确定完成 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 通过路由规则将请求分发到不同的后端服务。一个 Agent API 可以创建多条路由规则。
十四、步骤1：进入路由列表
1. 在 Agent API 详情页，选择路由列表 Tab；
2. 单击新建。
十五、步骤2：配置基本信息
基本信息
| 字段 | 是否必填 | 说明 | 示例 |
| 路由名称 | 否 | 路由的名称，支持中文、英文、数字、.、-、_ | 用户服务路由 |
| 请求协议 | 是 | 选择支持的协议，默认"HTTP&HTTPS" | HTTP&HTTPS |
匹配规则
注意：说明：
注意：请求方法、请求路径、Host 需至少配置一种，Header 可选。详细介绍见 路由匹配说明
| 字段 | 是否必填 | 说明 | 示例 |
| 请求方法 | 至少配置一种 | 支持的 HTTP 方法，可多选 | GET、POST |
| 请求路径 | | 路径匹配规则，支持精确匹配、前缀匹配、正则匹配 | 前缀匹配：/api/users |
| Host | | 主机名匹配，支持大小写敏感配置，可添加多个 | api.example.com |
| Header | 否 | 请求头匹配，键支持数字、字母、_、-，可添加多个 | X-Service： user-service |
高级配置（可选）
可根据实际需求勾选开启/关闭 Strip Path。
·开启： 网关向后端转发时剥离请求路径中用于路由匹配的前缀，仅将剩余路径传递给后端服务，适用于后端接口不包含该前缀的场景。
·关闭： 网关保留用户请求的完整原始路径原样透传给后端服务，适用于后端接口本身已包含该前缀的场景。
十六、步骤3：配置路由后端
在第二步中，配置路由的后端服务，从"服务管理>服务"列表中选择后端服务。
十七、步骤4：完成创建
单击 完成创建，路由规则创建成功。
十九、编辑路由
1. 在 Agent API 详情页 > 路由列表 Tab，选择需要编辑的路由；
2. 单击右侧路由详情区域的编辑路由按钮；
3. 修改路由配置(两步向导，与创建流程相同)；
4. 单击确定保存修改。
20、删除路由
1. 在 Agent API 详情页 > 路由列表 Tab，选择需要删除的路由；
2. 单击右侧路由详情区域的更多操作 > 删除；
3. 在确认对话框中单击确定。
注意：删除路由后，该路由的所有请求将无法路由，请谨慎操作。
21、查看路由详情
在 Agent API 详情页 > 路由列表 Tab，左侧路由列表选择路由后，右侧会展示路由详情。