Solace Agent Mesh

用于构建事件驱动型多智能体 AI 系统的开源框架。 如果喜欢这个项目，请给本项目点个 ⭐️ Star，以便及时获取最新功能和改进。

关键特性 • 快速开始 • 后续步骤 • 文档

---

Solace Agent Mesh (SAM) 是一个支持构建 AI 应用程序的框架，通过多个专业化的 AI 智能体协作来解决复杂问题。它利用 Solace Platform 的事件消息传递功能，实现了真正的可扩展性和可靠性。

借助 Solace Agent Mesh (SAM)，你可以创建 AI 智能体团队，每个智能体都拥有独特的技能并能够访问特定的工具。例如，你可以拥有一个能够执行 SQL 查询以获取数据的“数据库智能体”，或者一个能够协助创建图像、音频文件和报告的“多模态智能体”。

该框架会自动处理智能体之间的通信，让你能够专注于打造出色的 AI 体验。

SAM 创建了一个标准化的通信层，使 AI 智能体能够：

• 将任务委派给对等智能体
• 共享数据和工件
• 连接各种用户界面和外部系统
• 以最小的耦合度执行多步工作流

SAM 构建于 Solace AI Connector (SAC) 之上，允许 Solace Platform Event Brokers 连接到 AI 模型和服务，并利用 Google 的 Agent Development Kit (ADK) 来处理 AI 逻辑和工具集成。

最终的结果是：一个完全异步、事件驱动且解耦的 AI 智能体架构，随时可用于生产环境部署。它稳健、可靠且易于维护。

---

🔑 关键特性

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

📚 想了解更多？ 请查看完整的 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 Key (任何主流提供商或自定义端点)

🎸 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

注意：此初始化 UI 运行在 5002 端口。

5. 运行项目

sam run

6. 验证 SAM 是否正在运行

打开 Web UI http://localhost:8000 进入聊天界面并提问。

🔧 自定义 SAM

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

sam add agent --gui

可以安装现有的插件

sam add plugin --gui