跳转至

API 路线图（规划）

规划说明

本页为 规划中内容，用于对齐后续设计与阶段目标，不代表当前版本已实现。

规划中的接口（MVP 扩展：会话/消息管理 + 人工接管）

1) 会话/消息管理（Agent API / FastAPI）

GET /sessions（增强：分页与筛选）

新增查询参数（拟）

  • limit：默认 50
  • offset：默认 0
  • status：可选，AI_ACTIVE / HUMAN_ACTIVE
  • updated_after / updated_before：可选，ISO 时间

排序约定（拟）

  • 按 updated_at 倒序返回

GET /sessions/{session_id}/messages（增强：分页与筛选）

新增查询参数（拟）

  • limit：默认 50
  • offset：默认 0
  • role：可选，user / assistant / agent / system
  • created_after / created_before：可选，ISO 时间

GET /sessions/{session_id}/export（新增，拟）

用途（拟）：导出会话与消息，供运营与回放

响应结构（拟）：session + messages 的 JSON 组合（字段与当前模型保持一致）

2) 人工接管/释放（Agent API + demo-backend + demo-frontend）

POST /sessions/{session_id}/takeover（新增，拟）

请求体（拟）

{
  "agent_id": "agent-identifier",
  "note": "可选备注"
}

行为约定（拟）

  • Session.status 更新为 HUMAN_ACTIVE
  • 写入 system 消息（内容形如“xxx 接管”）

POST /sessions/{session_id}/release（新增，拟）

请求体（拟）

{
  "agent_id": "agent-identifier",
  "note": "可选备注"
}

行为约定（拟）

  • Session.status 更新为 AI_ACTIVE
  • 写入 system 消息（内容形如“xxx 释放”）

POST /sessions/{session_id}/agent-message（新增，拟）

请求体（拟）

{
  "content": "人工回复内容",
  "agent_id": "agent-identifier"
}

行为约定（拟）

  • 写入 role=agent 的消息
  • 通过统一输出通道实时回传前端

3) 事件回传（SSE / WebSocket，拟）

事件类型（拟）

  • type=event 或 type=system（用于前端提示状态变更）

典型事件（拟）

  • 接管/释放时的系统提示
  • 人工消息写入后的回传

4) demo-backend（Socket.IO 代理事件，规划）

  • agent_takeover：前端发起接管
  • agent_release：前端发起释放
  • agent_message：前端发起人工消息

转发约定（拟）

  • demo-backend 将事件转换为对应的 Agent API 调用并透传结果

规划中的接口（来自设计草案）

以下接口当前未实现，仅用于后续设计对齐。

1) Agent Console / Admin Console

  • 统一通过 Agent API 调用能力
  • 包含坐席接管、审计、模型热切换等能力入口

2) API Gateway（可选）

  • 统一入口层，提供认证、限流、熔断、审计
  • 可能采用 JWT/OAuth2 等鉴权机制

3) WebSocket Broker

  • 负责大规模长连接管理与消息路由
  • 支持多实例广播与订阅

4) 事件中枢（Kafka/Pulsar）

  • 会话事件流（user.message、agent.takeover 等）
  • 便于回放与多下游消费

5) Plugin Registry / Serverless Endpoint

  • 插件注册、热部署与能力扩展
  • 服务端点注册到意图路由或工具系统

6) NLU Service

  • 意图识别、实体抽取、情感分类
  • 与事件中枢和 Agent API 交互