外部 Agent 集成指南

文档维护规范

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

概述

本指南介绍如何集成外部 Agent（运行在不同机器或使用其他 Agent 框架）。

特点

运行在不同机器
或使用其他 Agent 框架
通过 HTTP API 接入
使用 Client SDK 简化调用

集成步骤

1. 安装 SDK

pip install gateway-client

2. 创建客户端

from gateway.client.python import GatewayClient

client = GatewayClient("http://gateway-host:8000")

3. 使用核心功能

查询对话列表：

conversations = client.list_conversations()

获取消息历史：

messages = client.get_messages(conversation_id)

发送消息：

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

相关文档

需求规划：外部 Agent 接入需求
架构设计：API 层架构
API 文档：HTTP API 参考
Python SDK 文档：SDK 详细文档