# Conversations API

**HTTP API：** 对话管理

## 文档维护规范

0. **先改文档，再动代码** - 新功能或重大修改需先完成文档更新、并完成审阅后，再进行代码实现
1. **文档分层，链接代码** - 关键实现需标注代码文件路径；格式：`module/file.py:function_name`
2. **简洁快照，日志分离** - 只记录已确认的 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 核心模块](../core/conversations.md)：核心实现
- [需求规划](../requirements.md)：对话管理需求
- [架构设计](../architecture.md)：API 层在整体架构中的位置
