Agent/gateway/docs/guides/internal-agent.md

内部 Agent 集成指南

文档维护规范

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

---

概述

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

---

特点

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

---

集成步骤

1. 导入模块

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

2. 使用核心功能

查询对话列表：

manager = ConversationManager()
conversations = manager.list_conversations()

获取消息历史：

messages = manager.get_messages(conversation_id)

发送消息：

manager.send_message(conversation_id, text="Hello!")

---

相关文档

• 需求规划：内部 Agent 接入需求
• 架构设计：Core 层架构
• 核心模块文档：各模块详细文档