项目简介

'agent-swarm-kit' 是一个用于构建多智能体AI系统的 TypeScript 库。它通过提供会话管理、工具注册、Prompt 模板渲染等功能，帮助开发者快速搭建基于 Model Context Protocol (MCP) 的应用后端，为 LLM 客户端提供上下文信息和功能。

主要功能点

• 资源 (Resources) 管理: 通过 'addAgent', 'addSwarm' 等 API 托管和管理智能体和 Swarm，支持运行时动态加载和依赖注入。
• 工具 (Tools) 注册与执行: 允许注册自定义工具（'addTool' API），并通过 JSON-RPC 协议供 LLM 客户端调用，实现外部功能扩展。
• Prompt 模板 (Prompts) 定义: 支持为每个 Agent 定义 Prompt 模板，实现可定制的 LLM 交互模式。
• 客户端会话编排: 自动管理客户端会话（'session' API），处理消息历史、智能体导航和资源释放，支持 WebSocket 等多种传输协议。
• Model Context Protocol Ready: 可以无缝连接到多个远程 MCP 服务器，方便集成各种语言编写的外部工具。
• Redis 存储集成: 支持将状态管理、RAG 数据和聊天记录持久化到 Redis，提供可靠、可扩展的存储方案。

安装步骤

npm install agent-swarm-kit

服务器配置

Agent Swarm Kit 本身是一个库，开发者需要基于它构建 MCP 服务器应用。以下是一个简单的服务器配置示例，展示如何启动一个基于 WebSocket 的 MCP 服务器，并集成 'agent-swarm-kit' 库 (配置信息为JSON格式):

{
  "server name": "agent-swarm-kit-server",
  "command": "node",
  "args": ["path/to/your/server.js"],
  "description": "启动 Agent Swarm Kit MCP 服务器",
  "notes": "请确保已安装 Node.js 和 agent-swarm-kit 库，并根据实际情况修改 server.js 路径。"
}

参数注释:

• 'server name': 服务器的名称，可以自定义。
• 'command': 启动服务器的命令，这里使用 'node' 运行 JavaScript 文件。
• 'args': 启动命令的参数，指向包含服务器代码的 JavaScript 文件路径。用户需要将 'path/to/your/server.js' 替换为实际的服务器启动脚本路径。
• 'description': 服务器配置的简要描述。
• 'notes': 使用配置的注意事项。

基本使用方法

1. 安装库: 在你的项目中安装 'agent-swarm-kit' 库 ('npm install agent-swarm-kit')。
2. 定义 Swarm 和 Agent: 使用 'addSwarm', 'addAgent', 'addTool', 'addCompletion' 等 API 定义你的智能体系统。参考仓库 'README.md' 和示例代码。
3. 创建 Session: 使用 'session(clientId, swarmName)' API 创建客户端会话。
4. 连接客户端: 使用 'session' 返回的 'connect' 函数，通过 WebSocket 或其他支持的协议连接客户端。
5. 发送消息: 客户端通过 WebSocket 发送消息，服务器端使用 'complete' 函数处理消息并返回响应。
6. 运行服务器: 启动你的 Node.js 服务器应用。
7. 客户端连接: MCP 客户端根据生成的服务器配置信息连接到服务器。