关键词

智能对话系统Agent平台上下文服务知识库工具集成

使用说明

项目简介

AgentX平台是一个基于大模型+MCP（Model Context Protocol）架构构建的智能对话系统平台。它旨在简化Agent的创建和管理流程，让用户可以通过自然语言和简单的配置，快速搭建属于自己的智能助手。AgentX平台的核心理念是“没有复杂的流程节点，没有复杂的拖拉拽”，用户只需关注添加工具和服务，即可打造功能强大的Agent。

主要功能点

  • 资源管理 (Resources): AgentX平台通过知识库功能，实现了对外部知识资源的托管和管理，支持文档管理、向量存储和RAG检索增强，为Agent提供丰富的数据访问能力。
  • 工具注册与执行 (Tools): 平台支持工具的添加和管理，虽然文档中没有明确展示工具注册和执行的MCP接口，但提及“对接 MCP Server 完成工具的调用”，表明平台具备工具集成和调用的能力，符合MCP服务器对工具管理的要求。
  • Prompt模板 (Prompts): AgentX平台通过系统提示词和欢迎消息等配置，以及Agent的版本管理功能，间接支持Prompt模板的定义和定制，允许用户根据需求调整Agent的交互模式。
  • 会话管理: 提供流式对话、会话管理和上下文管理功能，确保对话的连贯性和信息的有效利用。
  • 多模型服务商接入: 支持多模型服务商的接入和配置管理，方便用户灵活选择和使用不同的LLM模型。
  • 用户系统与市场功能: 包含用户认证、计费系统、市场功能（插件市场、工具市场、知识库市场）等，为平台的可持续运营和生态建设提供支持。
  • API与集成: 提供对外API和SDK，方便与其他系统集成，扩展平台的功能和应用场景.

安装步骤

  1. 前置条件: 确保已安装 JDK 17+、Maven 3.6+、Docker & Docker Compose、PostgreSQL 14+ (可选，可以使用Docker启动)。
  2. 克隆仓库: 'git clone https://github.com/lucky-aeon/AgentX.git'
  3. 进入项目目录: 'cd AgentX'
  4. 构建项目: 'mvn clean install'
  5. 配置数据库: 配置 PostgreSQL 数据库连接，可以在 'src/main/resources/application.yml' 文件中修改数据库连接信息。或者使用 Docker 启动 PostgreSQL。
  6. 使用 Docker 启动 (可选): 如果选择 Docker 启动 PostgreSQL 或整个应用，请参考仓库中的 Docker Compose 配置进行启动。
  7. 运行后端服务: 运行 'org.xhy.AgentXApplication' 启动 Spring Boot 后端服务。

服务器配置

AgentX平台作为MCP服务器，主要通过HTTP API提供服务。MCP客户端需要配置以下信息以连接到AgentX服务器：

{
  "serverName": "AgentX MCP Server",
  "command": "curl",
  "args": [
    "-X", "POST",
    "-H", "Content-Type: application/json",
    "-d", "@request.json",  // MCP 客户端发送请求的文件，需要客户端自身处理
    "http://localhost:8080/agent/session/chat" // AgentX平台提供的对话API端点，根据实际部署地址修改
  ],
  "description": "AgentX 智能对话系统平台 MCP 服务器接口",
  "transport": "HTTP-JSON" //  AgentX平台使用 HTTP-JSON 作为传输协议
}

参数注释:

  • 'serverName': MCP 服务器的名称，可以自定义。
  • 'command': 用于与 MCP 服务器通信的命令，这里使用 'curl' 作为示例，表示通过 HTTP 请求进行通信。
  • 'args': 命令参数列表，用于配置 'curl' 命令的具体行为：
    • '"-X", "POST"': 指定 HTTP 请求方法为 POST，MCP客户端通常通过 POST 请求发送指令。
    • '"-H", "Content-Type: application/json"': 设置请求头，表明发送 JSON 格式的数据。
    • '"-d", "@request.json"': 表示请求数据从 'request.json' 文件读取，'request.json' 应由 MCP 客户端根据 MCP 协议规范生成，包含符合 MCP 格式的请求内容。
    • '"http://localhost:8080/agent/session/chat"': AgentX平台提供的对话 API 端点 URL，请根据实际 AgentX 服务部署的地址和端口进行修改。MCP客户端将向此端点发送符合 MCP 协议的请求。
  • 'description': 对该服务器配置的描述信息，方便用户理解其用途。
  • 'transport': 声明 MCP 服务器使用的传输协议，AgentX 平台基于 HTTP 和 JSON 进行数据交换。

基本使用方法

  1. 启动 AgentX 后端服务。
  2. 配置 MCP 客户端: 在 MCP 客户端中，根据上述 “服务器配置” 示例，配置连接到 AgentX 平台的必要信息。
  3. MCP 客户端发送请求: MCP 客户端根据 MCP 协议规范，构造 JSON-RPC 请求，请求内容包括资源操作、工具调用或 Prompt 获取等指令，并将请求数据通过 HTTP POST 请求发送到 AgentX 服务器的指定 API 端点（例如 '/agent/session/chat'）。
  4. AgentX 服务器处理请求: AgentX 服务器接收到 MCP 请求后，根据请求内容执行相应的操作，例如访问知识库资源、调用注册的工具、渲染 Prompt 模板等。
  5. AgentX 服务器返回响应: AgentX 服务器将处理结果封装成 JSON-RPC 响应，并通过 HTTP 响应返回给 MCP 客户端。
  6. MCP 客户端接收和处理响应: MCP 客户端接收到 JSON-RPC 响应后，根据响应内容进行后续处理，例如将对话内容展示给用户，或根据工具调用结果进行下一步操作。

注意: AgentX 平台主要通过 Spring Boot 的 RESTful API 提供服务，虽然文档提及 MCP，但没有明确展示 JSON-RPC over Stdio, SSE, WebSocket 等 MCP 标准传输协议的具体实现。配置中使用 'curl' 和 HTTP API 端点进行通信，表明 AgentX 平台可能以 HTTP-JSON 的方式实现了部分 MCP 服务器的功能，用户需要根据实际情况和平台提供的 API 文档进行集成和使用。

信息

分类

AI与计算

访问项目