
第一步SQLBot 安装与部署在部署之前请务必备份现有数据。如果你之前运行过 SQLBot 且未配置SERVER_IMAGE_HOST或者配置错误需要先停止服务并删除旧容器否则可能导致图片无法显示。1. 环境准备你需要准备一台安装了 Docker 和 Docker Compose 的服务器并确保服务器防火墙开放了8000和8001端口。2. 两种部署方式你可以选择使用docker run命令一键运行或者使用docker-compose进行管理。请务必注意下方代码中的SERVER_IMAGE_HOST参数需要替换为你服务器的实际 IP 地址。方式 ADocker Run (命令行)dockerrun-d--namesqlbot--restartunless-stopped\-p8000:8000-p8001:8001\-eSERVER_IMAGE_HOSThttp://你的服务器IP:8001/images/\-vdata/sqlbot/excel:/opt/sqlbot/data/excel\-vdata/sqlbot/file:/opt/sqlbot/data/file\-vdata/sqlbot/images:/opt/sqlbot/images\-vdata/sqlbot/logs:/opt/sqlbot/logs\-vdata/postgresql:/var/lib/postgresql/data\--privilegedtrue dataease/sqlbot方式 BDocker Compose (推荐)创建docker-compose.yml文件内容如下version:3services:sqlbot:image:dataease/sqlbot:v1.1.0container_name:sqlbotrestart:alwaysports:-8000:8000-8001:8001environment:POSTGRES_SERVER:localhostPOSTGRES_PORT:5432POSTGRES_DB:sqlbotPOSTGRES_USER:rootPOSTGRES_PASSWORD:Password123pgPROJECT_NAME:SQLBotDEFAULT_PWD:SQLBot123456SERVER_IMAGE_HOST:http://你的服务器IP:8001/images/# 关键配置SECRET_KEY:y5txe1mRmS_JpOrUzFzHEu-kIQn3lf7ll0AOv9DQh0sBACKEND_CORS_ORIGINS:http://localhost,http://localhost:5173LOG_LEVEL:INFOvolumes:-data/sqlbot/excel:/opt/sqlbot/data/excel-data/sqlbot/file:/opt/sqlbot/data/file-data/sqlbot/images:/opt/sqlbot/images-data/sqlbot/logs:/opt/sqlbot/logs-data/postgresql:/var/lib/postgresql/datanetworks:sqlbot-network:3. 访问与初始化部署成功后通过浏览器访问http://你的服务器IP:8000/默认账号admin默认密码SQLBot123456登录后请第一时间配置 AI 模型如 OpenAI 或其他兼容接口和你的数据源。️ 第二步MCP 工具接口说明SQLBot 提供了 MCP (Model Context Protocol) 接口主要包含两个核心工具用于外部系统调用。工具名称用途说明关键参数mcp_start初始化对话获取身份凭证username,passwordmcp_question提交自然语言问题token,chat_id,question对接逻辑建议首次调用mcp_start获取access_token和chat_id。将这两个值缓存起来。后续所有提问都复用这两个值保持chat_id一致才能维持上下文记忆。返回结果通常包含 SQL 语句、Markdown 表格以及图表图片链接。 第三步与 MaxKB4J 集成指南如果你使用 MaxKB4J 进行应用编排可以按照以下步骤将 SQLBot 集成进去实现对话式数据分析。1. 使用模板创建工作流智能体在应用的模板中心创建或进入一个SQLBot AI 智能体的应用。在开始节点中定义输入变量 username必填 、password必填对应SQLBot 登录的用户和密码。2. 修改工具里mcp配置信息创建SQLBot AI 智能体模板应用时会自动创建一个sqlbot_mcp工具点击编辑修改ip和端口信息3. 开始对话