内容摘录
<p align="center">
<img src="./docs/static/img/logo.png" alt="Solace Agent Mesh Logo" width="100"/>
</p>
<h2 align="center">
Solace Agent Mesh
</h2>
<h3 align="center">Open-source framework for building event driven multi-agent AI systems</h3>
<h5 align="center">Star ⭐️ this repo to stay updated as we ship new features and improvements.</h5>
<p align="center">
<a href="https://github.com/SolaceLabs/solace-agent-mesh/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/SolaceLabs/solace-agent-mesh" alt="License">
</a>
<a href="https://pypi.org/project/solace-agent-mesh">
<img src="https://img.shields.io/pypi/v/solace-agent-mesh.svg" alt="PyPI - Version">
</a>
<a href="https://pypi.org/project/solace-agent-mesh">
<img src="https://img.shields.io/pypi/pyversions/solace-agent-mesh.svg" alt="PyPI - Python Version">
</a>
<a href="https://pypi.org/project/solace-agent-mesh">
<img alt="PyPI - Downloads" src="https://img.shields.io/pypi/dm/solace-agent-mesh?color=00C895">
</a>
</p>
<p align="center">
<a href="#-key-features">Key Features</a> •
<a href="#-quick-start-5-minutes">Quickstart</a> •
<a href="#️-next-steps">Next Steps</a>
</p>
---
**Solace Agent Mesh** is a framework that supports building AI applications where multiple specialized AI agents work together to solve complex problems. It uses the event messaging of Solace Platform for true scalability and reliability.
With Solace Agent Mesh (SAM), you can create teams of AI agents, each having distinct skills and access to specific tools. For example, you could have a Database Agent that can make SQL queries to fetch data or a MultiModal Agent that can help create images, audio files and reports.
The framework handles the communication between agents automatically, so you can focus on building great AI experiences.
SAM creates a standardized communication layer where AI agents can:
Delegate tasks to peer agents
Share data and artifacts
Connect with diverse user interfaces and external systems
Execute multi-step workflows with minimal coupling
SAM is built on top of the Solace AI Connector (SAC) which allows Solace Platform Event Brokers to connect to AI models and services and Google's Agent Development Kit (ADK) for AI logic and tool integrations.
<p align="center">
<img src="docs/static/img/Solace_AI_Framework_With_Broker.png" width="640" alt="SAM Architecture Diagram" />
</p>
The result? A fully asynchronous, event-driven and decoupled AI agent architecture ready for production deployment. It is robust, reliable and easy to maintain.
---
🔑 Key Features
**Multi-Agent Event-Driven Architecture** – Agents communicate via the Solace Event Mesh for true scalability
**Agent Orchestration** – Complex tasks are automatically broken down and delegated by the Orchestrator agent
**Flexible Interfaces** – Integrate with REST API, web UI, Slack, or build your own integration
**Extensible** – Add your own agents, gateways, or services with minimal code
**Agent-to-Agent Communication** – Agents can discover and delegate tasks to each other seamlessly using the Agent2Agent (A2A) Protocol
**Dynamic Embeds** – Embed dynamic content like real-time data, calculations and file contents in responses
📚 **Want to know more?** Check out the full Solace Agent Mesh documentation.
---
🚀 Quick Start (5 minutes)
Set up Solace Agent Mesh in just a few steps.
⚙️ System Requirements
To run Solace Agent Mesh locally, you'll need:
**Python 3.10.16+**
**pip** (comes with Python)
**OS**: MacOS, Linux, or Windows (with WSL)
**LLM API key** (any major provider or custom endpoint)
🎸 Vibe Coding
To quickly setup and customize your Agent Mesh, check out the Vibe Coding Quickstart Guide. This guide walks you through the essential steps to get Solace Agent Mesh up and running with minimal effort.
💻 Setup Steps
Create a directory for a new project
Create and activate a Python virtual environment
Install Solace Agent Mesh (SAM)
Check if you have a version of SAM already installed.
If you have an earlier version, uninstall it and **start from scratch**:
Note: Optionally, you can try to upgrade versions but this action is not officially supported at this time. (pip3 install --upgrade solace-agent-mesh)
If no previous version exists, install the latest version with:
Initialize the new project via a GUI tool
Note: This initialization UI runs on port 5002
Run the project
Verify SAM is running
Open the Web UI at http://localhost:8000 for the chat interface and ask a question
🔧 Customize SAM
New agents can be added via a GUI interface
Existing plugins can be installed
---
🏗️ Architecture Overview
Solace Agent Mesh provides a "Universal A2A Agent Host," a flexible and configurable runtime environment built by integrating Google's Agent Development Kit (ADK) with the Solace AI Connector (SAC) framework.
The system allows you to:
Host AI agents developed with Google ADK within the SAC framework
Define agent capabilities (LLM model, instructions, tools) primarily through SAC YAML configuration
Use Solace Platform as the transport for standard Agent-to-Agent (A2A) protocol communication
Enable dynamic discovery of peer agents running within the same ecosystem
Allow agents to delegate tasks to discovered peers via the A2A protocol over Solace
Manage file artifacts using built-in tools with automatic metadata injection
Perform data analysis using built-in SQL, JQ, and visualization tools
Use dynamic embeds for context-dependent information resolution
Key Components
**SAC** handles broker connections, configuration loading, and component lifecycle
**ADK** provides the agent runtime, LLM interaction, tool execution, and state management
**A2A Protocol** enables communication between clients and agents, and between peer agents
**Dynamic Embeds** allow placeholders in responses that are resolved with context-dependent information
**File Management** provides built-in tools for artifact creation, listing, loading, and metadata handling
---
➡️ N…