# 内部 Agent 集成指南

## 文档维护规范

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

---

## 概述

本指南介绍如何集成内部 Agent（和 Gateway 运行在同一台机器，使用我们的 Agent 框架）。

---

## 特点

- 和 Gateway 运行在同一台机器
- 使用我们的 Agent 框架
- 直接调用 Core 层的 Python 接口
- 无需 HTTP 通信

---

## 集成步骤

### 1. 导入模块

```python
from gateway.core.lifecycle import TraceManager
from gateway.core.conversations import ConversationManager
from gateway.core.routing import Router
```

### 2. 使用核心功能

**查询对话列表：**
```python
manager = ConversationManager()
conversations = manager.list_conversations()
```

**获取消息历史：**
```python
messages = manager.get_messages(conversation_id)
```

**发送消息：**
```python
manager.send_message(conversation_id, text="Hello!")
```

---

## 相关文档

- [需求规划](../requirements.md)：内部 Agent 接入需求
- [架构设计](../architecture.md)：Core 层架构
- [核心模块文档](../core/)：各模块详细文档
