关键词

Agent平台LLM应用工具集成自然语言交互工作流自动化

Simplaix 使用说明

项目简介

Simplaix 旨在通过将软件功能集成到智能 Agent 中，革新人机交互方式。它允许用户通过自然语言与软件进行对话，将复杂的操作委托给 Agent 完成，从而专注于决策而非繁琐的软件操作。Simplaix 平台基于 Model Context Protocol (MCP) 构建，能够管理资源、注册和执行工具，并支持 Prompt 模板，为 LLM 应用提供可扩展的上下文服务框架。

主要功能点

  • Agent 驱动设计：将软件功能嵌入到智能 Agent 中，Agent 可以理解自然语言指令，自动化工作流程，并提供可操作的见解。
  • 自然语言交互：通过对话式交互，用户可以使用自然语言与软件通信，降低学习成本。
  • 工具集成：平台支持集成各种工具，例如 Gmail、Jira 和本地文档操作，扩展 LLM 的能力。
  • 资源管理：通过文档 (Documents) 功能，平台可以管理和存储用户创建的内容资源。
  • 本地 MCP 服务器支持：集成了基于 Python 的本地 MCP 服务器，用于扩展平台的功能，例如 Gmail 和 Jira 工具的集成。

安装步骤

  1. 安装 Vercel CLI (如果尚未安装):

    npm i -g vercel

  2. 链接本地实例与 Vercel 和 GitHub 账户:

    vercel link

    这将创建 '.vercel' 目录。

  3. 下载环境变量:

    vercel env pull

    或者，您也可以手动创建 '.env.local' 文件，并参考 '.env.example' 文件配置所需的环境变量。 请勿提交 '.env.local' 文件以避免泄露敏感信息。

  4. 安装依赖并启动开发服务器:

    pnpm install
pnpm dev

    应用应该会在 http://localhost:3000 上运行。

服务器配置

Simplaix 平台默认配置了本地 MCP 服务器，用于提供扩展功能。MCP 客户端（Simplaix 前端）需要配置 MCP 服务器的启动命令及其参数才能建立连接。 以下是 Simplaix 平台中配置的本地 MCP 服务器的配置信息，这些配置已预置在 Simplaix 平台中，您无需手动配置，此处仅为展示配置信息:

{
  "email": {
    "command": "uv",
    "args": [
      "--directory",
      "toolbox/tools/local/email/email-server",
      "run",
      "main.py"
    ],
    "clientTools": [
      "gmail_login",
      "search_messages",
      "send_message",
      "reply_message"
    ],
    "serverTools": [
      "gmail_login",
      "search_messages",
      "send_message",
      "reply_message"
    ]
  },
  "jira": {
    "command": "uv",
    "args": [
      "--directory",
      "toolbox/tools/local/jira/jira-server",
      "run",
      "main.py"
    ],
    "clientTools": [
      "create_jira_issues",
      "save_jira_issues"
    ],
    "serverTools": [
      "create_jira_issues",
      "save_jira_issues"
    ]
  }
}

配置参数说明:

  • server name: MCP 服务器的名称，例如 "email", "jira"。
  • command: 启动 MCP 服务器的命令。 在 Simplaix 中，本地 Python MCP 服务器使用 'uv' 命令启动，这是一个 Python 包安装和运行器。
  • args: 启动命令的参数列表。
    • '--directory': 指定 MCP 服务器代码所在的目录。
    • 'run main.py': 运行 Python MCP 服务器的主程序 'main.py'。
  • clientTools: 客户端工具列表，这些工具的 UI 组件将在 Simplaix 前端展示。
  • serverTools: 服务端工具列表，这些工具主要在后端执行，不一定有直接的 UI 组件。

注意: Simplaix 的 MCP 服务器配置是预先定义好的，用户通常无需修改这些配置即可使用平台提供的功能。如果您需要扩展或自定义工具，可能需要参考仓库中的代码结构和 MCP 协议规范进行开发。

基本使用方法

  1. 启动 Simplaix 应用后，访问 http://localhost:3000。

  2. 注册或登录账户。

  3. 在聊天界面，您可以像与普通聊天机器人一样进行对话。

  4. Simplaix 平台支持多种工具，例如：

    • 创建和更新文档 (Documents)：您可以使用自然语言指令创建文本、代码、表格或图像文档，并进行编辑和更新。
    • Gmail 集成：通过集成的 Gmail 工具，您可以搜索邮件、登录 Gmail 账户 (需要配置 Gmail API 密钥) 和发送邮件等 (部分邮件功能可能需要配置和启动独立的 Python MCP 服务器)。
    • Jira 集成：通过 Jira 工具，可以创建 Jira 任务 (需要配置 Jira API 密钥和启动独立的 Python MCP 服务器)。
    • 获取天气信息：可以使用 'getWeather' 工具查询指定经纬度的天气信息。

  5. 通过自然语言指令，Agent 可以调用集成的工具来完成用户的请求，例如 "创建一个关于 Next.js 的文档", "搜索关于 Simplaix 项目的邮件", "在 Jira 上创建一个 Bug 任务" 等。

请参考仓库中的代码和示例，深入了解 Simplaix 平台的各项功能和使用方法。

信息

分类

AI与计算

访问项目