Gateway 主路由。
端点列表
发现 / 健康
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /healthz | 健康检查（无需认证） |
| GET | /.well-known/agent.json | A2A Agent Card（无需认证） |
Session 生命周期
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/sessions | 创建 Session（支持 v0.2 userData / promptMode） |
| GET | /v1/sessions/:id | 查询 Session 概况 |
| GET | /v1/sessions/:id/status | 完整状态：pendingTools / pendingApprovals / queues |
| DELETE | /v1/sessions/:id | 删除 Session |
Prompt / Stream
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/sessions/:id/prompt | 发送 prompt（异步 202） |
| GET | /v1/sessions/:id/events | SSE 事件流 |
HITL
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/sessions/:id/approve | 审批通过 |
| POST | /v1/sessions/:id/reject | 审批拒绝 |
| POST | /v1/sessions/:id/respond | 回答 Agent 提问 |
A2A 协议
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/a2a/tasks/send | JSON-RPC 同步 |
| POST | /v1/a2a/tasks/sendSubscribe | JSON-RPC SSE 流式 |
| POST | /v1/a2a/tasks/sendWithWebhook | JSON-RPC webhook 异步 |
| GET | /v1/a2a/tasks/:task_id | (12M v0.4.1) 兜底查询 task 状态（ETS 10min 缓存） |
控制面（v0.2 — Guardrails 第 18 章）
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /v1/sessions/:id/switch_model | (RFC C8) 切换 LLM |
| POST | /v1/sessions/:id/attach_tool | (RFC C9) 运行时挂工具 |
| DELETE | /v1/sessions/:id/tools/:name | (RFC C9) 运行时卸工具 |
| POST | /v1/sessions/:id/steer | 中段注入 |
| POST | /v1/sessions/:id/abort | (RFC B6) 安全中止 |
信息查询
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /v1/sessions/:id/stats | 用量统计 |
| GET | /v1/sessions/:id/messages | 对话历史 |
| POST | /v1/sessions/:id/tools | 注册回调工具 |
Summary
Functions
Callback implementation for Plug.call/2.
Callback implementation for Plug.init/1.