操作场景
企业同时使用多个 Agent 平台，各平台独立部署、各自暴露 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. 单击目标实例 ID/名称进入实例详情页，进入目标网关实例。
3. 在左侧导航栏选择 Agent 管理；
4. 在 Agent API 页签，单击新建。
步骤2：配置基本信息
在弹出的创建弹窗中，配置以下信息：
参数 | 是否必填 | 说明 | 示例 |
API 名称 | 是 | Agent API 的唯一标识，支持英文、数字、下划线、短横线，长度1-64字符 | agent-backend-api |
请求协议 | 是 | 自定义（区别于模型 API 的 OpenAI 兼容协议） Dify A2A | 自定义 |
后端 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 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 |
高级配置（可选）
可根据实际需求勾选开启/关闭 Strip Path。
开启： 网关向后端转发时剥离请求路径中用于路由匹配的前缀，仅将剩余路径传递给后端服务，适用于后端接口不包含该前缀的场景。
关闭： 网关保留用户请求的完整原始路径原样透传给后端服务，适用于后端接口本身已包含该前缀的场景。
步骤3：配置路由后端
在第二步中，配置路由的后端服务，从"服务管理>服务"列表中选择后端服务。
步骤4：完成创建
单击 完成创建，路由规则创建成功。
编辑和删除路由
编辑路由
1. 在 Agent API 详情页 > 路由列表 Tab，选择需要编辑的路由；
2. 单击右侧路由详情区域的编辑路由按钮；
3. 修改路由配置(两步向导，与创建流程相同)；
4. 单击确定保存修改。
删除路由
1. 在 Agent API 详情页 > 路由列表 Tab，选择需要删除的路由；
2. 单击右侧路由详情区域的更多操作 > 删除；
3. 在确认对话框中单击确定。
注意：
删除路由后，该路由的所有请求将无法路由，请谨慎操作。
查看路由详情
在 Agent API 详情页 > 路由列表 Tab，左侧路由列表选择路由后，右侧会展示路由详情。
