Skip to content

HTTP API

PRX 网关暴露 RESTful HTTP API,用于管理 Agent 会话、发送消息和查询系统状态。

基础 URL

默认情况下,API 可在 http://127.0.0.1:3120/api/v1 访问。

端点

会话

方法路径描述
POST/sessions创建新的 Agent 会话
GET/sessions列出活跃会话
GET/sessions/:id获取会话详情
DELETE/sessions/:id终止会话

消息

方法路径描述
POST/sessions/:id/messages向 Agent 发送消息
GET/sessions/:id/messages获取消息历史

系统

方法路径描述
GET/health健康检查
GET/info系统信息
GET/metricsPrometheus 指标

认证

API 请求需要 Bearer Token:

bash
curl -H "Authorization: Bearer <token>" http://localhost:3120/api/v1/sessions

相关页面

Released under the Apache-2.0 License.