使用说明

项目简介

Agents-EXE 是一个用于定义和执行 LLM 代理的工具。它允许用户创建具有模型、系统提示、命令行工具和辅助代理的智能体。除了作为独立的命令行工具使用外,Agents-EXE 还提供了一个实验性的 MCP 服务器模式,可以将定义的代理作为工具暴露给支持 MCP 协议的 LLM 客户端,例如 Claude-desktop。

主要功能点

  • LLM 代理构建: 支持用户定义和配置 LLM 代理,包括指定使用的语言模型、系统提示,以及集成的工具和辅助代理。
  • 命令行工具集成: 允许代理通过执行命令行工具扩展功能,实现与外部环境的交互,例如文件读写、网络探测等。
  • 辅助代理机制: 支持创建辅助代理,将复杂任务分解,并委托给更专业的子代理处理。
  • 实验性MCP服务器: 提供 MCP 服务器功能,将配置好的代理以工具的形式暴露给支持 MCP 协议的客户端,实现与 LLM 应用的标准化集成。

安装步骤

  1. 克隆仓库: 在终端中执行命令 'git clone https://github.com/lucasdicioccio/agents-exe' 克隆代码仓库到本地。
  2. 进入目录: 执行 'cd agents-exe' 进入仓库目录。
  3. 构建项目: 使用 'cabal run -- agents-exe --help' 命令进行构建。这会使用 Haskell 构建工具 'cabal' 编译项目并显示帮助信息,同时也验证了安装的正确性。

服务器配置

要将 Agents-EXE 作为 MCP 服务器与 MCP 客户端连接,您需要在客户端配置服务器连接信息。以下是一个 JSON 格式的配置示例,您需要将其填入 MCP 客户端的服务器配置中。

{
  "serverName": "agents-exe-server",
  "command": "agents-exe",
  "args": ["mcp-server"]
}

配置参数说明:

  • 'serverName': 服务器名称,可以自定义,例如 "agents-exe-server"。
  • 'command': 启动 MCP 服务器的命令,这里是 'agents-exe',即项目构建生成的可执行文件。
  • 'args': 传递给启动命令的参数,'["mcp-server"]' 指定 Agents-EXE 以 MCP 服务器模式运行。

基本使用方法

  1. 初始化配置: 运行 'agents-exe init' 命令,根据引导创建 'agent.json' 配置文件和工具目录,定义您的 LLM 代理。
  2. 启动 MCP 服务器: 在终端中执行 'agents-exe mcp-server' 命令启动 MCP 服务器。
  3. 配置 MCP 客户端: 在您的 MCP 客户端(如 Claude-desktop)中,根据上述 “服务器配置” 部分的信息,配置连接到 Agents-EXE MCP 服务器。
  4. 使用 LLM 客户端: 现在您可以使用 MCP 客户端与 Agents-EXE 服务器进行交互,利用配置在 Agents-EXE 中的代理工具。

信息

分类

AI与计算