什么是 Agent API

Agent API 是 Agent 服务下的路由，用于代理 Agent 应用服务，支持 HTTP 与 WebSocket 两种请求协议，复用网关统一的消费者认证、授权、插件与观测能力。

能力一览

请求协议选择

说明：WebSocket 等长连接会长时间占用网关连接数，长连接比例高的业务建议选择更高的实例规格，详见规格说明。

匹配优先级规则

多个 API 同时满足请求时按 优先级 生效，数字越小优先级越高。优先级相同时按以下默认规则匹配：

1. 匹配方式优先级：精确匹配 > 前缀匹配 > 正则匹配；
2. 路径段数匹配多的优先级高，例如 /a/b 优先级大于 /a；
3. Header 匹配数量多的优先级高，Header 优先级大于 Query；
4. Query 匹配数量多的优先级高。

前提条件

• 已创建 Agent 服务，详见Agent 服务概述。
• 已在后端管理中添加好 Agent 后端。

使用流程

1. 创建 Agent API：选择请求协议、配置路由与后端
2. 发布与管理 Agent API：发布 API 使其对外提供服务
3. 通过Agent API 监控观察调用情况

相关文档

• 创建 Agent API
• 发布与管理 Agent API
• Agent API 监控
• API 概述：三类 API 的能力对比。