Skip to content

feat(chat): helper bot ui & file upload support #7245

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
DigHuang wants to merge 3 commits into
base: main
Choose a base branch
from
+1,713 −3,168
Open

feat(chat): helper bot ui & file upload support #7245

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
f4f04dc
fix(permission): handle sandbox checks without standard plan
DigHuang Jul 5, 2026
87f8451
refactor(chat): unify helper bot with main chat flow
DigHuang Jul 5, 2026
c96dc89
chore(helperbot): clean unified chat flow leftovers
DigHuang Jul 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion deploy/version/v4.15/docker-compose.template.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@ x-service-env-config: &x-service-env-config
MAX_LOGIN_SESSION:
ALLOWED_ORIGINS:
AGENT_ENGINE: default
HELPER_BOT_MODEL: qwen-max
CHAT_TITLE_MODEL:
SKIP_FILE_TYPE_CHECK: false
WECHAT_CHANNEL_CONCURRENCY: 1000
Expand Down
1 change: 0 additions & 1 deletion document/content/self-host/config/env.en.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -180,7 +180,6 @@ These variables are mainly validated by `packages/service/env.ts` and apply to `
| Variable | Default | Description |
| -------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AGENT_ENGINE` | `default` | Agent engine. Supported values are `default` and `pi`. |
| `HELPER_BOT_MODEL` | Empty | Helper generation model. The model must be enabled in the system. |
| `SKIP_FILE_TYPE_CHECK` | `false` | Whether upload file type checks are skipped. |
| `WECHAT_CHANNEL_CONCURRENCY` | `1000` | WeChat channel poll worker concurrency. Minimum value is `10`. |
| `PARSE_FILE_WORKERS` | `10` | Resident file parsing worker count. |
Expand Down
1 change: 0 additions & 1 deletion document/content/self-host/config/env.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -180,7 +180,6 @@ description: projects/app、projects/code-sandbox 与 pro/admin 环境变量说
| 变量 | 默认值 | 说明 |
| -------------------------------------- | --------- | ---------------------------------------------------------------------------------------------- |
| `AGENT_ENGINE` | `default` | Agent 引擎，可选 `default` 或 `pi`。 |
| `HELPER_BOT_MODEL` | 空 | 辅助生成模型，需保证系统中已启用对应模型。 |
| `SKIP_FILE_TYPE_CHECK` | `false` | 是否跳过上传文件类型检查。 |
| `WECHAT_CHANNEL_CONCURRENCY` | `1000` | 微信渠道 poll worker 并发数，最小 `10`。 |
| `PARSE_FILE_WORKERS` | `10` | 文件解析 worker 常驻线程数。 |
Expand Down
8 changes: 4 additions & 4 deletions document/data/doc-last-modified.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -203,8 +203,8 @@
"content/self-host/custom-models/ollama.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/custom-models/xinference.en.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/custom-models/xinference.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/deploy/docker.en.mdx": "2026-07-03T23:51:40+08:00",
"content/self-host/deploy/docker.mdx": "2026-07-03T23:51:40+08:00",
"content/self-host/deploy/docker.en.mdx": "2026-07-04T00:03:29+08:00",
"content/self-host/deploy/docker.mdx": "2026-07-04T00:03:29+08:00",
"content/self-host/deploy/sealos.en.mdx": "2026-06-30T22:10:03+08:00",
"content/self-host/deploy/sealos.mdx": "2026-06-30T22:10:03+08:00",
"content/self-host/design/dataset.en.mdx": "2026-04-26T21:08:47+08:00",
Expand Down Expand Up @@ -314,8 +314,8 @@
"content/self-host/upgrading/4-15/41506.mdx": "2026-07-01T12:13:58+08:00",
"content/self-host/upgrading/4-15/41507.en.mdx": "2026-06-30T17:31:43+08:00",
"content/self-host/upgrading/4-15/41507.mdx": "2026-06-30T17:31:43+08:00",
"content/self-host/upgrading/4-15/4151.en.mdx": "2026-07-03T22:44:25+08:00",
"content/self-host/upgrading/4-15/4151.mdx": "2026-07-03T22:44:25+08:00",
"content/self-host/upgrading/4-15/4151.en.mdx": "2026-07-04T00:03:29+08:00",
"content/self-host/upgrading/4-15/4151.mdx": "2026-07-04T00:03:29+08:00",
"content/self-host/upgrading/outdated/40.en.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/upgrading/outdated/40.mdx": "2026-04-26T21:08:47+08:00",
"content/self-host/upgrading/outdated/41.en.mdx": "2026-04-26T21:08:47+08:00",
Expand Down
1 change: 0 additions & 1 deletion document/public/deploy/docker/v4.15/cn/docker-compose.milvus.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@ x-service-env-config: &x-service-env-config
MAX_LOGIN_SESSION:
ALLOWED_ORIGINS:
AGENT_ENGINE: default
HELPER_BOT_MODEL: qwen-max
CHAT_TITLE_MODEL:
SKIP_FILE_TYPE_CHECK: false
WECHAT_CHANNEL_CONCURRENCY: 1000
Expand Down
1 change: 0 additions & 1 deletion document/public/deploy/docker/v4.15/cn/docker-compose.oceanbase.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@ x-service-env-config: &x-service-env-config
MAX_LOGIN_SESSION:
ALLOWED_ORIGINS:
AGENT_ENGINE: default
HELPER_BOT_MODEL: qwen-max
CHAT_TITLE_MODEL:
SKIP_FILE_TYPE_CHECK: false
WECHAT_CHANNEL_CONCURRENCY: 1000
Expand Down
1 change: 0 additions & 1 deletion document/public/deploy/docker/v4.15/cn/docker-compose.opengauss.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@ x-service-env-config: &x-service-env-config
MAX_LOGIN_SESSION:
ALLOWED_ORIGINS:
AGENT_ENGINE: default
HELPER_BOT_MODEL: qwen-max
CHAT_TITLE_MODEL:
SKIP_FILE_TYPE_CHECK: false
WECHAT_CHANNEL_CONCURRENCY: 1000
Expand Down
1 change: 0 additions & 1 deletion document/public/deploy/docker/v4.15/cn/docker-compose.pg.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@ x-service-env-config: &x-service-env-config
MAX_LOGIN_SESSION:
ALLOWED_ORIGINS:
AGENT_ENGINE: default
HELPER_BOT_MODEL: qwen-max
CHAT_TITLE_MODEL:
SKIP_FILE_TYPE_CHECK: false
WECHAT_CHANNEL_CONCURRENCY: 1000
Expand Down
1 change: 0 additions & 1 deletion document/public/deploy/docker/v4.15/cn/docker-compose.seekdb.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@ x-service-env-config: &x-service-env-config
MAX_LOGIN_SESSION:
ALLOWED_ORIGINS:
AGENT_ENGINE: default
HELPER_BOT_MODEL: qwen-max
CHAT_TITLE_MODEL:
SKIP_FILE_TYPE_CHECK: false
WECHAT_CHANNEL_CONCURRENCY: 1000
Expand Down
1 change: 0 additions & 1 deletion document/public/deploy/docker/v4.15/cn/docker-compose.zilliz.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@ x-service-env-config: &x-service-env-config
MAX_LOGIN_SESSION:
ALLOWED_ORIGINS:
AGENT_ENGINE: default
HELPER_BOT_MODEL: qwen-max
CHAT_TITLE_MODEL:
SKIP_FILE_TYPE_CHECK: false
WECHAT_CHANNEL_CONCURRENCY: 1000
Expand Down
1 change: 0 additions & 1 deletion document/public/deploy/docker/v4.15/global/docker-compose.milvus.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@ x-service-env-config: &x-service-env-config
MAX_LOGIN_SESSION:
ALLOWED_ORIGINS:
AGENT_ENGINE: default
HELPER_BOT_MODEL: qwen-max
CHAT_TITLE_MODEL:
SKIP_FILE_TYPE_CHECK: false
WECHAT_CHANNEL_CONCURRENCY: 1000
Expand Down
1 change: 0 additions & 1 deletion document/public/deploy/docker/v4.15/global/docker-compose.oceanbase.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@ x-service-env-config: &x-service-env-config
MAX_LOGIN_SESSION:
ALLOWED_ORIGINS:
AGENT_ENGINE: default
HELPER_BOT_MODEL: qwen-max
CHAT_TITLE_MODEL:
SKIP_FILE_TYPE_CHECK: false
WECHAT_CHANNEL_CONCURRENCY: 1000
Expand Down
1 change: 0 additions & 1 deletion document/public/deploy/docker/v4.15/global/docker-compose.opengauss.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@ x-service-env-config: &x-service-env-config
MAX_LOGIN_SESSION:
ALLOWED_ORIGINS:
AGENT_ENGINE: default
HELPER_BOT_MODEL: qwen-max
CHAT_TITLE_MODEL:
SKIP_FILE_TYPE_CHECK: false
WECHAT_CHANNEL_CONCURRENCY: 1000
Expand Down
1 change: 0 additions & 1 deletion document/public/deploy/docker/v4.15/global/docker-compose.pg.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@ x-service-env-config: &x-service-env-config
MAX_LOGIN_SESSION:
ALLOWED_ORIGINS:
AGENT_ENGINE: default
HELPER_BOT_MODEL: qwen-max
CHAT_TITLE_MODEL:
SKIP_FILE_TYPE_CHECK: false
WECHAT_CHANNEL_CONCURRENCY: 1000
Expand Down
1 change: 0 additions & 1 deletion document/public/deploy/docker/v4.15/global/docker-compose.seekdb.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@ x-service-env-config: &x-service-env-config
MAX_LOGIN_SESSION:
ALLOWED_ORIGINS:
AGENT_ENGINE: default
HELPER_BOT_MODEL: qwen-max
CHAT_TITLE_MODEL:
SKIP_FILE_TYPE_CHECK: false
WECHAT_CHANNEL_CONCURRENCY: 1000
Expand Down
1 change: 0 additions & 1 deletion document/public/deploy/docker/v4.15/global/docker-compose.zilliz.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@ x-service-env-config: &x-service-env-config
MAX_LOGIN_SESSION:
ALLOWED_ORIGINS:
AGENT_ENGINE: default
HELPER_BOT_MODEL: qwen-max
CHAT_TITLE_MODEL:
SKIP_FILE_TYPE_CHECK: false
WECHAT_CHANNEL_CONCURRENCY: 1000
Expand Down
1 change: 0 additions & 1 deletion packages/global/core/ai/model.schema.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,6 @@ export const LLMModelItemSchema = PriceTypeSchema.extend(BaseModelItemSchema.sha
isDefaultDatasetTextModel: z.boolean().optional(),
isDefaultDatasetImageModel: z.boolean().optional(),
isDefaultChatTitleModel: z.boolean().optional(),
isDefaultHelperBotModel: z.boolean().optional(),

/** @deprecated */
datasetProcess: z.boolean().optional(), // dataset
Expand Down
3 changes: 2 additions & 1 deletion packages/global/core/chat/constants.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,8 @@ export enum ChatSourceEnum {
*/
export enum ChatSourceTypeEnum {
app = 'app',
skillEdit = 'skillEdit'
skillEdit = 'skillEdit',
helperBot = 'helperBot'
}

export const ChatSourceMap = {
Expand Down
115 changes: 0 additions & 115 deletions packages/global/core/chat/helperBot/adaptor.ts
View file
Open in desktop

This file was deleted.

62 changes: 62 additions & 0 deletions packages/global/core/chat/helperBot/constants.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
import {
AppTypeEnum,
defaultAppSelectFileConfig,
defaultQGConfig,
defaultWhisperConfig
} from '../../app/constants';
import type { AppQGConfigType, AppWhisperConfigType } from '../../app/type';
import type { AppFileSelectConfigType } from '../../app/type/config.schema';

export const HelperBotAppName = 'Top Agent';
export const HelperBotAvatar = '/imgs/bot.svg';

export const helperBotFileSelectConfig: AppFileSelectConfigType = {
...defaultAppSelectFileConfig,
maxFiles: 10,
canSelectFile: true,
canSelectImg: true,
canSelectVideo: true,
canSelectAudio: true,
customPdfParse: false,
canSelectCustomFileExtension: true,
customFileExtensionList: []
};

export const helperBotQuestionGuideConfig: AppQGConfigType = {
...defaultQGConfig,
open: false
};

export const helperBotWhisperConfig: AppWhisperConfigType = {
...defaultWhisperConfig,
open: false
};

/** 创建 HelperBot 专用 Chat 配置，避免调用方共享并误改全局对象。 */
export const createHelperBotChatConfig = () => {
return {
fileSelectConfig: {
...helperBotFileSelectConfig,
customFileExtensionList: [...(helperBotFileSelectConfig.customFileExtensionList ?? [])]
},
questionGuide: {
...helperBotQuestionGuideConfig
},
whisperConfig: {
...helperBotWhisperConfig
}
};
};

/** 创建 HelperBot 在通用 ChatBox 中使用的轻量 App 信息。 */
export const createHelperBotAppConfig = () => {
return {
chatConfig: createHelperBotChatConfig(),
chatModels: [],
name: HelperBotAppName,
avatar: HelperBotAvatar,
intro: '',
type: AppTypeEnum.simple,
pluginInputs: []
};
};
7 changes: 6 additions & 1 deletion packages/global/core/chat/helperBot/topAgent/type.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,12 @@ export const topAgentParamsSchema = z.object({
selectedDatasets: z.array(z.string()).nullish(),
selectedAgentSkills: z.array(SelectedAgentSkillItemTypeSchema).nullish(),
fileUpload: z.boolean().nullish(),
enableSandbox: z.boolean().nullish()
enableSandbox: z.boolean().nullish(),
modelConfig: z
.object({
model: z.string().optional()
})
.optional()
});
export type TopAgentParamsType = z.infer<typeof topAgentParamsSchema>;

Expand Down
Loading
Loading