Conversations API

HTTP API： 对话管理

文档维护规范

先改文档，再动代码 - 新功能或重大修改需先完成文档更新、并完成审阅后，再进行代码实现
文档分层，链接代码 - 关键实现需标注代码文件路径；格式：module/file.py:function_name
简洁快照，日志分离 - 只记录已确认的 API 设计

概述

对话管理 API 供外部 Agent 调用，用于：

查询对话列表
获取消息历史
发送消息

实现位置： gateway/api/conversations_api.py

基础路径： /api/conversations

API 端点

列出对话

端点： GET /api/conversations

用途： 列出所有对话

说明： 具体请求/响应格式待设计

获取消息历史

端点： GET /api/conversations/{conversation_id}/messages

用途： 获取对话的消息历史

说明： 具体请求/响应格式待设计

发送消息

端点： POST /api/conversations/{conversation_id}/messages

用途： 向对话发送消息

说明： 具体请求/响应格式待设计

相关文档

Conversations 核心模块：核心实现
需求规划：对话管理需求
架构设计：API 层在整体架构中的位置