使用说明

项目简介

Gaia-X 是一个面向企业场景设计的新一代AI应用平台,其核心创新在于对 Model Context Protocol (MCP) 协议的支持。它旨在解决现有AI产品在企业应用中面临的管理、安全和协作痛点,构建安全、可扩展的企业级AI服务框架。Gaia-X平台通过集成MCP协议,实现了对 资源 (Resources)工具 (Tools)Prompt 模板 (Prompts) 的标准化管理和调用,为构建复杂的LLM应用提供了坚实的基础。

主要功能点

  • MCP协议支持: 企业级MCP协议的实现,支持集成各种社区MCP服务器。
  • 企业管理: 提供完整的用户、权限、计费系统和LLM API托管能力,方便企业统一管理和使用AI资源。
  • 多Agent智能协同: 支持基于任务编排或RAG的智能协作,无需手动选择Agent或工作流即可完成复杂任务。
  • 自然语言RPA: 通过大型模型驱动RPA自动化,降低自然语言RPA的开发门槛。
  • 安全可控: 通过人工确认机制和动态渲染技术,降低敏感操作的风险。
  • 无限画布: 每个Agent对话过程都是独立的画布,支持SVG、HTML、Mermaid、Echarts、PlantUML等多种Artifacts动态渲染。
  • 智能计算机操作: 集成Claude Sonnet 3.5+、Zhipu CogAgent、ByteDance UI-TARS、OpenAI computer-use等模型,Agent可以自主执行计算机操作。

安装步骤

Gaia-X 项目由客户端 (Client) 和管理后台 (Admin Backend) 组成。根据 README.md 描述,MCP Server 运行在独立的沙箱环境中,并由客户端管理执行。具体的完整安装步骤需要参考 Gaia-X 项目的完整文档中心 Documentation Center,以下是基于仓库信息推断的简化步骤:

  1. 安装客户端 (Gaia-X Client):

    • 客户端基于 Electron + React 开发,可能需要安装 Node.js 和 npm 环境。
    • 从 GitHub 仓库 https://github.com/YFGaia/gaia-x 获取客户端代码。
    • 根据项目文档指引,进行客户端的构建和安装。
  2. 部署管理后台 (Admin Backend):

    • 管理后台基于 golang + Gin 开发,可能需要 Go 环境。
    • 从 GitHub 仓库 https://github.com/YFGaia/gaia-x 获取管理后台代码 (apps/admin 目录)。
    • 根据项目文档指引,进行管理后台的编译和部署,可能需要配置数据库和相关依赖。
  3. 配置 MCP Server 运行时环境 (mcp-runtime):

    • 项目提供了 mcp-runtime 子项目,用于在客户端运行 MCP Server。
    • 根据项目文档,下载或构建适用于 MacOS 和 Windows 的嵌入式 MCP 运行时环境。

服务器配置 (MCP Server)

MCP 服务器在 Gaia-X 平台中作为独立的组件运行,由客户端进行管理和调用。MCP 客户端(Gaia-X Client)需要配置 MCP 服务器的启动信息,以便建立连接和调用工具。

以下是一个示例的 MCP 服务器配置信息 (JSON 格式),你需要根据实际的 MCP Server 实现和 'mcp-runtime' 的具体使用方式进行调整。

{
  "serverName": "embedded-mcp-server",
  "command": "/path/to/mcp-runtime",
  "args": [
    "--server-type", "stdio",
    "--port", "8080"
  ],
  "description": "嵌入式 MCP 服务器,通过 Stdio 协议通信",
  "notes": {
    "command": "MCP 服务器的启动命令,这里假设 mcp-runtime 是可执行文件路径",
    "args": "启动参数,例如指定服务器类型为 stdio,以及监听端口 (如果适用)",
    "server-type": "指定 MCP 服务器的传输协议,例如 stdio, websocket, sse 等 (根据 mcp-runtime 支持的协议)",
    "port": "如果服务器使用网络协议 (如 websocket),指定监听端口"
  }
}

请注意: 上述配置信息仅为示例,实际配置需要参考 'mcp-runtime' 的文档和 Gaia-X 项目的详细指南。你需要根据你使用的 MCP Server 实现,以及希望使用的传输协议和参数进行调整。

基本使用方法

  1. 启动 Gaia-X 客户端和管理后台: 按照安装步骤启动客户端和管理后台服务。
  2. 登录管理后台: 使用管理员账号登录 Gaia-X 管理后台,进行用户管理、模型管理、工具管理等配置。
  3. 配置 MCP Server: 在 Gaia-X 客户端的管理界面中,配置 MCP Server 的连接信息,例如启动命令、参数等。
  4. 在客户端进行对话: 打开 Gaia-X 客户端的 Chatbot 界面,与 Agent 进行对话。
  5. Agent 调用 MCP 工具: 当 Agent 在对话中需要调用外部功能时,Gaia-X 客户端会根据 MCP 协议与配置的 MCP Server 进行通信,执行相应的工具。
  6. 查看和管理资源、Prompt 模板: 通过 Gaia-X 客户端的界面,可以查看和管理 MCP Server 托管的资源和 Prompt 模板。

请务必参考 Gaia-X 项目的官方文档和示例,以获得更详细和准确的使用指导。

信息

分类

AI与计算