AI 助手 ~~v4.1
我们从 V4.1 开始正式引入 AI 助手功能，旨在帮助用户更加高效、智能的完成工作。AI 助手向所有用户免费开放，让每一个 REBUILD 用户都不会错过这个 AI 时代！
目前，AI 助手集成了智能对话、文件分析、业务数据分析能力。后期还将添加更多功能，如果你有好点子也可以向我们 提交。
如何启用
非常简单！首先进入管理中心 - AI 助手，然后配置你的 DeepSeek 秘钥（即 API Key）即可（秘钥可在 DeepSeek 开放平台 获取），配置完成后即可使用。
使用其他 AI 模型 ~~v4.2
默认使用 DeepSeek 进行对话，也可以使用 OpenAI 或 Google Gemini 等，REBUILD 兼容市面上几乎所有常用 AI 模型，仅需将参数对应填写即可，以 OpenAI 为例填写如下：
- [API 地址]
https://api.openai.com/v1 - [秘钥] 你的 OpenAI 秘钥
- [使用模型] 如
gpt-5或gpt-4o等 OpenAI 模型
推荐使用方式
我们更推荐使用 AI 聚合服务平台，可以自由选择模型使用，如 阿里云百炼、腾讯云 TokenHub、CloseAI 等。当使用 CloseAI 时参数填写如下：
- [API 地址]
https://api.openai-proxy.org/v1 - [秘钥] 你的 CloseAI 秘钥
- [使用模型] 如
gpt-5或gemini-2.5-pro等常见 AI 模型（具体以 CloseAI 支持为准）
开始使用
当配置完成后，顶部菜单会出现一个 AI 助手图标，点击即可打开/关闭 AI 助手窗口（或使用快捷键 Shift+/），开始畅游你的 AI 世界吧。
用户之间会话独立，不会共享。同时还可以通过 角色 控制哪些用户可以使用 AI 助手功能
选择记录
你可以在对话输入框中选择指定记录，或在列表页面（或其他支持的页面）按照条件选择记录，以便发送给 AI 分析。
选择文件 ~~v4.4
从 V4.4 开始支持上传文件（暂不支持图片），支持常用文件的分析处理（如 Office、PDF 等）。
MCP 接入 ~~v4.5
从 V4.5 开始支持 MCP（Model Context Protocol），你可以将 REBUILD 作为 MCP Server 接入到 WorkBuddy、QoderWork、Trae 等 AI 客户端，让 AI 直接操作你的业务数据。
获取个人秘钥
进入 个人设置 - 安全设置，找到「个人秘钥 (AK)」点击「生成」。秘钥仅显示一次，请妥善保存。
? 每个用户只能有一个有效秘钥，重新生成会使旧秘钥立即失效。秘钥等同于你的账号权限，请勿泄露或提交到代码仓库
配置 AI 客户端
REBUILD 提供原生 MCP Streamable HTTP 端点，无需安装任何本地代理，直接配置 URL 即可接入。以 WorkBuddy 为例，将以下配置放在你的 MCP 配置中即可。
{
"mcpServers": {
"rebuild": {
"url": "https://你的域名/gw/mcp/sse",
"headers": {
"Authorization": "Bearer <你的个人秘钥>"
}
}
}
}
保存后在 WorkBuddy「连接器」页面点击「信任」启用即可。其他支持 MCP 的客户端配置方式类似，核心参数：
| 参数 | 值 |
|---|---|
| 端点 URL | https://你的域名/gw/mcp/sse |
| 认证方式 | Authorization: Bearer <你的个人秘钥> |
| 协议 | MCP Streamable HTTP（JSON-RPC 2.0） |
可用工具
接入后 AI 客户端可调用以下工具：
| 工具 | 说明 |
|---|---|
| ListEntities | 查看实体及其字段结构。不传名称返回所有可用实体列表，传入名称返回完整字段定义 |
| QueryRecords | 查询业务记录，支持按名称模糊搜索、按字段条件过滤和分页排序 |
| UpsertRecord | 智能解析文件或文本为业务记录并保存，支持 PDF、Word、Excel 等格式 |
| DataStatistics | 数据统计分析，支持 COUNT/SUM/AVG/MAX/MIN 聚合、分组统计和条件过滤 |
| ExportReport | 导出报表文件，可查看实体下可用报表模板，指定报表和记录后生成下载链接 |
| Approval | 审批操作，支持提交审批、同意、驳回、撤回、撤销和查询审批状态 |
| FetchUrl | 请求外部 HTTP 接口，支持 GET/POST 方法及自定义请求头 |
| UploadFile | 上传文件或图片，支持 BASE64 和 URL 两种方式，返回 fileKey 供其他工具引用 |
| CreateFeed | 发布动态，支持普通动态、跟进、日程三种类型，可附带图片附件和关联业务记录 |
| CreateProjectTask | 在项目中创建任务，支持指定面板、执行人、优先级、截止时间和附件 |
| SearchHelp | 搜索 REBUILD 帮助文档，返回相关文档标题、链接和摘要 |
工具调用受当前用户权限约束，只能访问你有权限的数据
提提建议
如果你有什么好的 AI 功能建议，请留言 https://gitee.com/getrebuild/rebuild/issues/ICLCN9
常见问题
为什么不能流式回复？
服务端需要支持 WebSocket 连接，否则无法进行流式回复。如你使用 Nginx 配置反向代理，可参考以下配置：
# 位于 server 块内
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;