墨台 MUOTAI

Appearance

快速开始 ​

运行前置条件 ​

墨台后端采用 Spring Boot 与 Spring Cloud 微服务架构。最小可用环境至少需要：

组件作用
MySQL业务数据、Agent 配置、会话和日志持久化
Redis缓存、分布式状态和可选的 Agent 消息队列
Nacos服务注册、配置中心以及 MCP 服务发现
muotai-gateway对外暴露统一 HTTP 入口
muotai-aiAI Agent、RAG、Skill、MCP、渠道和日志能力

数据库脚本位于后端仓库的 db/ 目录。首次部署时，应先执行基础 schema，再执行与 AI、文件系统、日志和生态模块对应的增量脚本。

启动顺序 ​

  1. 启动 MySQL、Redis 和 Nacos。
  2. 导入数据库脚本，确认 Nacos 中的数据库、对象存储和模型配置已经存在。
  3. 启动认证、UPMS、网关等基础服务。
  4. 启动 muotai-ai，观察 Agent、MCP 服务和数据源初始化日志。
  5. 启动前端，通过网关访问 AI 工作台。

开发环境可参考后端仓库的 docker-compose-dev.yml，生产环境可参考 docker-compose-prod.yml。这两个编排文件中的端口和镜像声明是环境约定，仍需和 muotai-ai-biz/src/main/resources/application.yml 及镜像 Dockerfile 对齐。

第一次对话 ​

  1. 创建或选择一个已发布的 Agent。
  2. 创建会话，浏览器通过 /v1/chatbot/... 建立 SSE 连接。
  3. 发送用户消息。接口先将消息写入 Agent 消息队列，再由会话专属执行器处理。
  4. 从 SSE 读取节点进度、工具结果和最终回答；如果客户端断线，可以重新连接同一个 session 继续读取待发送事件。

验证清单 ​

  • 网关能够访问 muotai-ai 的健康检查端点。
  • Agent 列表可以正常分页和读取发布状态。
  • 至少有一个启用的 LLM 模型。
  • Agent 的工具、知识库和 Skill 关联关系可读取。
  • SSE 连接建立后能收到心跳和完成事件。
  • agent.session.persistence.enabled=true 时，运行目录具备持久化挂载点。