关键词

AI代理组合式AI工具服务器Rust框架多代理通信

Distri AI Agent框架使用说明

项目简介

Distri 是一个使用 Rust 编写的框架，用于构建和组合 AI 代理。它旨在帮助开发者创建、发布和组合代理能力，并遵循 MCP (Multi-Agent Communication Protocol) 标准。Distri 提供了一种模块化和标准化的方式来构建 AI 应用的后端服务，使其能够与支持 MCP 协议的 LLM 客户端进行交互。

主要功能点

  • 模块化代理设计: 允许将代理构建为独立的模块，易于混合和匹配，实现功能复用和扩展。
  • MCP 协议支持: 采用 MCP 协议作为代理间通信的标准，确保不同代理和服务之间的互操作性。
  • 高性能 Rust 实现: 使用 Rust 语言开发，保证了框架的可靠性和运行速度。
  • 工具发布与共享: 支持将代理发布为 MCP 兼容的工具，促进 AI 能力的生态共享和重用。
  • 简易集成: 提供简单的 API 接口，方便开发者添加新的代理能力和功能。
  • AI 网关集成: 能够连接到 Langdb AI Gateway，从而访问超过250种不同的 LLM 模型。
  • MCP 代理: 提供便捷的代理功能，可以运行 stdio 命令并将其作为 MCP 工具暴露。

安装步骤

1. 使用 Cargo 安装 (推荐 Rust 环境)

确保你的系统已安装 Rust 和 Cargo。然后，运行以下命令安装 Distri：

cargo install --git https://github.com/distrihub/distri distri --locked

2. 使用 Docker 安装 (无需 Rust 环境)

如果你的系统已安装 Docker，可以直接使用 Docker 镜像运行 Distri：

docker run -it distrihub/distri

服务器配置

Distri 本身作为一个框架，可以构建多种 MCP 服务器，例如 'twitter-mcp' 和 'code-mcp'。同时，仓库也提供 'proxy' 用于聚合多个 MCP 服务器。以下以 'twitter-mcp' 为例，说明 MCP 客户端如何配置连接到 Distri 构建的 MCP 服务器。

假设你已经安装了 'twitter-mcp' 服务器（例如通过 Cargo 安装 'twitter-mcp' crate），你需要配置一个 MCP 客户端来连接它。MCP 客户端通常需要以下配置信息来启动和连接服务器：

{
  "serverName": "twitterServer",
  "command": "./twitter-mcp",
  "args": [],
  "description": "连接到 Twitter MCP 服务器",
  "notes": "command 指定 twitter-mcp 服务器的可执行文件路径，args 为启动参数，这里为空"
}

配置说明:

  • 'serverName': 服务器名称，客户端用于标识和管理不同的 MCP 服务器连接 (例如: "twitterServer")。
  • 'command': MCP 服务器的启动命令。对于 'twitter-mcp'，如果已安装并位于系统 PATH 中，则可以直接使用 '"twitter-mcp"'。如果不在 PATH 中，则需要指定可执行文件的完整路径，例如 '"./twitter-mcp"'。
  • 'args': 启动服务器所需的命令行参数，以字符串数组形式提供。对于简单的 'twitter-mcp' 服务器，通常不需要额外的参数，因此配置为空数组 '[]'。
  • 'description': 对该服务器连接的简要描述，方便用户理解其用途 (例如: "连接到 Twitter MCP 服务器")。
  • 'notes': 配置的备注信息，用于提供更详细的解释或注意事项 (例如: "command 指定 ...")。

注意: 实际的 MCP 客户端配置可能需要根据具体的客户端软件进行调整。以上 JSON 配置仅为示例，展示了连接基于 Distri 构建的 'twitter-mcp' 服务器所需的基本信息。你需要将 'command' 替换为 'twitter-mcp' 服务器可执行文件的实际路径，并根据需要调整 'args' 参数。

基本使用方法

  1. 运行 Agent 或 Proxy:

    • 使用 'distri run -c config.yaml <agent_name>' 运行配置文件中定义的 Agent。
    • 使用 'distri proxy -c proxy.yaml' 运行 MCP 代理服务器。

  2. 列出 Agents 和 Tools:

    • 使用 'distri list -c config.yaml' 列出可用的 Agents。
    • 使用 'distri list-tools -c config.yaml' 列出可用的 Tools。

  3. 与 Agent 交互 (Chat 模式):

    • 运行 Agent 进入 Chat 模式后，在命令行中输入文本与 Agent 进行对话。

更详细的使用方法和示例，请参考项目仓库的 README.md 文件以及后续提供的文档。由于 Distri 仍处于早期开发阶段，文档和示例可能会不断更新完善。

信息

分类

AI与计算

访问项目