使用说明

项目简介

Solace Agent Mesh (SAM) 是一个开源框架，旨在简化事件驱动的多智能体AI系统的构建过程。无论您是构建 AI 助手原型还是部署生产级解决方案，SAM 都提供了必要的基础设施，以连接 AI 智能体到真实世界的数据源和系统，并通过 REST API、Web UI 和 Slack 等多种灵活的接口公开其功能。SAM 支持从本地开发到分布式企业级部署的扩展，并内置编排能力，使任务能够自动分解并在智能体之间委派。

主要功能点

模块化事件驱动架构：所有组件通过中心事件网格进行事件通信，实现松耦合和高可扩展性。
可组合智能体：组合专门的 AI 智能体以解决复杂的多步骤工作流程。
灵活的接口：通过 REST API、Web UI 或 Slack 集成与 SAM 进行交互。
内置编排：内置的编排器自动分解任务并在智能体之间委派。
插件可扩展：通过插件扩展，可以轻松添加自定义的智能体、网关或服务。
生产就绪：基于 Solace 的企业级事件 Broker，保证可靠性和性能。
内置服务：内置文件存储、内存和嵌入服务，并支持扩展。

安装步骤

系统要求:
- Python 3.10.16+
- pip (随 Python 安装)
- 操作系统: MacOS, Linux, 或 Windows (通过 WSL)
- LLM API 密钥 (任何主流提供商或自定义端点)

安装 Solace Agent Mesh: 打开终端并执行以下命令：

# (可选) 创建并激活 Python 虚拟环境
python3 -m venv venv
source venv/bin/activate

# 安装 Solace Agent Mesh
pip install solace-agent-mesh

# 初始化新项目
mkdir my-agent-mesh && cd my-agent-mesh
solace-agent-mesh init        # 按照交互式初始化步骤操作

# 构建并运行项目
solace-agent-mesh run -b      # 快捷命令，等同于 build + run

访问 Web UI 和 REST API:

Web UI: 运行后，打开浏览器访问 http://localhost:5001 以使用聊天界面。

REST API: 可以使用 curl 等工具直接调用 REST API，示例如下：

curl --location 'http://127.0.0.1:5050/api/v1/request' \
  --form 'prompt="What is the capital of France?"' \
  --form 'stream="false"'

服务器配置

要将 Solace Agent Mesh 配置为 MCP 服务器供 MCP 客户端使用，您需要在 MCP 客户端配置中指定 Solace Agent Mesh 服务器的启动命令和参数。以下是一个 JSON 格式的配置示例，您可以将其添加到您的 MCP 客户端配置中：

{
  "serverName": "SolaceAgentMesh",
  "command": "solace-agent-mesh",
  "args": ["run", "-b"],
  "description": "启动 Solace Agent Mesh 服务器。请确保您的环境中已安装并配置了 Solace Agent Mesh。",
  //  无需额外的服务器参数。
  //  MCP 客户端将通过默认配置的协议（例如 JSON-RPC over REST 或 WebSockets，具体取决于 MCP 客户端和 Solace Agent Mesh 的实现细节）与服务器通信。
}

基本使用方法

启动 Solace Agent Mesh 服务器后，您可以通过以下方式与其进行交互：
- Web UI: 通过 Web 浏览器访问 http://localhost:5001 使用图形用户界面进行交互。
- REST API: 使用 HTTP 客户端（如 curl, Postman 等）向 http://127.0.0.1:5050/api/v1/request 发送符合 REST API 规范的请求。
- MCP 客户端: 配置 MCP 客户端连接到 Solace Agent Mesh 服务器。MCP 客户端将根据 MCP 协议规范与服务器进行通信，以实现资源访问、工具调用和 Prompt 模板渲染等功能。具体的 MCP 客户端配置和交互方式，请参考 MCP 客户端的文档和 Solace Agent Mesh 提供的 MCP 集成教程。

关键词

使用说明

信息