Solace Agent Mesh

用于构建事件驱动型多智能体AI系统的开源框架

请为本仓库标星⭐️，以便在我们发布新功能和改进时及时获取更新。

主要特性 • 快速入门 • 下一步 • 文档

---

Solace Agent Mesh 是一个支持构建AI应用的框架，允许多个专业化的AI智能体协同工作以解决复杂问题。它利用 Solace Platform 的事件消息传递机制，实现真正的可扩展性和可靠性。

借助 Solace Agent Mesh (SAM)，您可以创建由具备不同技能和工具访问权限的AI智能体组成的团队。例如，您可以拥有一个能够执行SQL查询以获取数据的数据库智能体，或者一个可以帮助生成图像、音频文件和报告的多模态智能体。

该框架会自动处理智能体之间的通信，使您能够专注于构建出色的AI体验。

SAM 创建了一个标准化的通信层，AI智能体可以在其中：

• 将任务委派给其他智能体
• 共享数据和成果
• 连接多样化的用户界面和外部系统
• 执行低耦合的多步骤工作流

SAM 构建在 Solace AI Connector (SAC) 之上，该连接器允许 Solace Platform 事件代理与AI模型和服务相连；同时结合了Google的AI开发套件（ADK），用于实现AI逻辑和工具集成。

其结果是一个完全异步、事件驱动且解耦的AI智能体架构，已准备好投入生产部署。它具有强大的鲁棒性、可靠性和易于维护的特点。

---

🔑 主要特性

• 多智能体事件驱动架构 – 智能体通过Solace Event Mesh进行通信，实现真正的可扩展性
• 智能体编排 – 复杂任务由编排器智能体自动分解并委派
• 灵活接口 – 可集成REST API、Web UI、Slack，或自行构建集成
• 可扩展 – 仅需少量代码即可添加自定义智能体、网关或服务
• 智能体间通信 – 智能体可通过Agent2Agent (A2A) 协议无缝发现彼此并相互委派任务
• 动态嵌入 – 在响应中嵌入实时数据、计算结果和文件内容等动态内容

📚 想了解更多？ 请查看完整的 Solace Agent Mesh 文档。

---

🚀 快速入门（5分钟）

只需几个步骤即可设置Solace Agent Mesh。

⚙️ 系统要求

要在本地运行Solace Agent Mesh，您需要：

• Python 3.10.16 – 3.13.x
• pip（随Python自带）
• 操作系统：MacOS、Linux或Windows（配备WSL）
• LLM API密钥（任何主流提供商或自定义端点）

🎸 Vibe Coding

要快速设置和定制您的Agent Mesh，请参阅Vibe Coding快速入门指南。本指南将引导您完成必要的步骤，以最少的努力启动并运行Solace Agent Mesh。

💻 设置步骤

1. 创建新项目目录

mkdir my-sam && cd my-sam

2. 创建并激活Python虚拟环境

python3 -m venv .venv && source .venv/bin/activate

3. 安装Solace Agent Mesh (SAM)

检查是否已安装SAM的某个版本。

sam -v

如果已安装旧版本，请将其卸载并从头开始：

pip3 uninstall solace-agent-mesh

注意：您也可以尝试升级版本，但目前此操作尚未得到官方支持。（pip3 install --upgrade solace-agent-mesh）

如果没有先前版本，则安装最新版本：

pip3 install solace-agent-mesh

4. 通过GUI工具初始化新项目

sam init --gui

注意：此初始化界面运行在端口5002上

5. 运行项目

sam run

6. 验证SAM是否正在运行

打开Web界面 http://localhost:8000，进入聊天界面并提出一个问题

🔧 自定义SAM

可通过GUI界面添加新智能体

sam add agent --gui

可安装现有插件

sam plugin add <your-component-name> --plugin <plugin-name>

---

🏗️ 架构概览

Solace Agent Mesh 提供了一个“通用 A2A 代理主机”，这是一个灵活且可配置的运行时环境，通过将 Google 的代理开发工具包 (ADK) 与 Solace AI 连接器 (SAC) 框架集成构建而成。

该系统允许您：

• 在 SAC 框架中托管使用 Google ADK 开发的 AI 代理
• 主要通过 SAC YAML 配置定义代理的能力（LLM 模型、指令、工具）
• 使用 Solace 平台作为标准代理间 (A2A) 协议通信的传输层
• 实现对同一生态系统中运行的对等代理的动态发现
• 允许代理通过 Solace 上的 A2A 协议将任务委派给已发现的对等代理
• 使用内置工具管理文件工件，并自动注入元数据
• 利用内置的 SQL、JQ 和可视化工具进行数据分析
• 使用动态嵌入来解析依赖于上下文的信息

关键组件

• SAC 负责代理连接、配置加载和组件生命周期管理
• ADK 提供代理运行时、LLM 交互、工具执行和状态管理功能
• A2A 协议 实现客户端与代理之间以及对等代理之间的通信
• 动态嵌入 允许在响应中使用占位符，这些占位符会根据上下文信息被解析
• 文件管理 提供用于创建、列出、加载工件以及处理元数据的内置工具

---

➡️ 下一步

想进一步了解吗？以下是一些动手教程，可以帮助您快速入门：

🔧 集成	⏱️ 预计时间	📘 教程
🌤️ 天气代理 学习如何构建一个能够使 Solace Agent Mesh 访问实时天气信息的代理。	~15 分钟	天气代理插件
🗃️ SQL 数据库集成 启用 Solace Agent Mesh 使用示例咖啡公司数据库回答公司特定问题。	~10–15 分钟	SQL 数据库教程
🧠 MCP 集成 将模型上下文协议 (MCP) 服务器集成到 Solace Agent Mesh 中。	~10–15 分钟	MCP 集成教程
💬 Slack 集成 直接从 Slack 与 Solace Agent Mesh 对话。	~20–30 分钟	Slack 集成教程
👔 Microsoft Teams 集成（企业版） 通过 Azure AD 身份验证将 Solace Agent Mesh Enterprise 连接到 Microsoft Teams。	~30–40 分钟	Teams 集成教程

---

👥 贡献者

Solace Agent Mesh 是在我们卓越社区的帮助下构建的。感谢每一位为改进该项目贡献想法、代码和时间的人！

在此查看完整的贡献者列表：GitHub 贡献者 💚

希望参与贡献吗？ 请查看 CONTRIBUTING.md，开始行动并了解如何提供帮助！

---

📄 许可证

本项目采用 Apache 2.0 许可证 许可。完整许可文本请参见 LICENSE 文件。

---

🧪 运行测试

本项目使用 pytest 进行测试。您可以使用 hatch 或直接使用 pytest 来运行测试。

使用 Hatch

推荐通过 hatch 环境运行测试，这样可以确保所有依赖项得到正确管理。

# 运行所有测试
hatch test

# 带标签运行测试
hatch test -m "<tag>"

使用 Pytest 直接运行

如果您更倾向于直接使用 pytest，则必须先安装项目及其测试依赖项。

# 以可编辑模式安装项目，并包含 'test' 附加组件
pip install -e .[test]

# 运行所有测试
pytest

---

Solace Agent Mesh 快速上手指南

Solace Agent Mesh (SAM) 是一个开源框架，用于构建基于事件驱动的多智能体 AI 系统。它利用 Solace 平台的事件消息机制实现高可扩展性和可靠性，支持多个具备不同技能的 AI 智能体协同工作。

环境准备

在本地运行 Solace Agent Mesh 前，请确保满足以下系统要求：

• Python 版本: 3.10.16 – 3.13.x
• 包管理工具: pip (通常随 Python 安装)
• 操作系统: MacOS, Linux, 或 Windows (Windows 用户建议使用 WSL)
• LLM API Key: 需要准备任意主流大模型提供商的 API Key 或自定义端点

提示：国内开发者若遇到 PyPI 下载缓慢问题，可在安装命令中指定国内镜像源（如清华源）： pip3 install solace-agent-mesh -i https://pypi.tuna.tsinghua.edu.cn/simple

安装步骤

按照以下步骤在 5 分钟内完成环境搭建：

1. 创建项目目录

mkdir my-sam && cd my-sam

2. 创建并激活 Python 虚拟环境

python3 -m venv .venv && source .venv/bin/activate

(Windows PowerShell 用户请使用 .venv\Scripts\Activate.ps1)

3. 安装 Solace Agent Mesh

首先检查是否已安装旧版本：

sam -v

如果存在旧版本，请先卸载以确保环境纯净：

pip3 uninstall solace-agent-mesh

安装最新版本：

pip3 install solace-agent-mesh

(如需使用国内加速，请参照环境准备中的提示添加 -i 参数)

4. 初始化项目

通过图形化界面工具初始化新项目（界面将运行在端口 5002）：

sam init --gui

按照界面指引完成配置（包括填入 LLM API Key 等）。

基本使用

启动服务

在项目目录下运行以下命令启动 Agent Mesh：

sam run

验证运行状态

启动成功后，打开浏览器访问 Web UI 聊天界面： http://localhost:8000

在对话框中输入问题，即可体验多智能体协同处理任务的能力。

扩展功能（可选）

• 添加新智能体：

  sam add agent --gui
  

• 安装现有插件：

  sam plugin add <your-component-name> --plugin <plugin-name>
  

现在您已经成功运行了第一个 Solace Agent Mesh 应用，可以开始探索更复杂的智能体编排与集成教程了。