智能体管理页面设计文档
智能体管理页面设计文档
📋 页面概述
智能体管理页面用于创建、编辑和管理AI智能体配置。支持多种协议类型（系统定制协议、OpenAI标准协议），可配置智能体的人设、行为、回复策略等参数。
🎨 页面布局建议
侧边栏导航
- 智能体列表
- 新建智能体
主内容区
- 智能体列表视图
- 智能体编辑/创建表单（标签页式设计）
📝 表单字段说明
第一部分：基础信息
| 字段名 | 类型 | 必填 | 说明 | 表单控件 |
|---|---|---|---|---|
| name | varchar(100) | 是 | 智能体名称 | 文本输入框，建议最大长度100字符 |
| avatar | varchar(255) | 否 | 智能体头像URL | 图片上传控件或URL输入框 |
| description | varchar(255) | 否 | 智能体描述 | 文本输入框，建议最大长度255字符 |
| status | tinyint(1) | 是 | 状态：0-正常，1-关闭 | 开关控件（Toggle）或下拉选择 |
UI设计建议：
- 头像区域可使用圆形裁剪显示
- 名称和描述使用明显的标题样式
- 状态开关位置醒目，便于快速启用/禁用
第二部分：接入配置
| 字段名 | 类型 | 必填 | 说明 | 表单控件 | 依赖关系 |
|---|---|---|---|---|---|
| protocol_type | tinyint | 否 | API协议类型：0-系统定制协议，1-OpenAI标准协议 | 单选框（Radio）或下拉选择 | 无 |
| custom_agent_type | tinyint | 否 | 接入类型：0-模型（需预设提示词），1-智能体（直接调用接口） | 单选框（Radio）或下拉选择 | 无 |
| base_url | varchar(255) | 否 | Base URL（域名），例如 https://api.deepseek.com | URL输入框 | protocol_type=1时显示 |
| ai_mode | varchar(128) | 否 | 模型ID，如 deepseek-chat、gpt-4 | 文本输入框 | custom_agent_type=0时显示 |
| api_secret | varchar(255) | 否 | API密钥 | 密码输入框（带显示/隐藏） | protocol_type=1时显示 |
| model_alias | varchar(100) | 否 | 模型显示名称，用于前端展示 | 文本输入框 | custom_agent_type=0时显示 |
UI设计建议：
- protocol_type 和 custom_agent_type 使用卡片式单选，每个选项带说明
- 根据选择动态显示/隐藏相关字段
- API Secret 使用密码输入框，提供"显示/隐藏"切换按钮
- 字段旁边添加"?"图标，鼠标悬停显示说明
动态显示逻辑：
protocol_type = 0 (系统定制协议) ├── 显示：custom_agent_type ├── custom_agent_type = 0 (模型) │ ├── 显示：ai_mode │ └── 显示：model_alias └── custom_agent_type = 1 (智能体) └── 无额外字段 protocol_type = 1 (OpenAI标准协议) ├── 显示：base_url ├── 显示：api_secret ├── 显示：custom_agent_type ├── custom_agent_type = 0 (模型) │ ├── 显示：ai_mode │ └── 显示：model_alias └── custom_agent_type = 1 (智能体) └── 无额外字段第三部分：人设与行为
| 字段名 | 类型 | 必填 | 说明 | 表单控件 | 默认值 |
|---|---|---|---|---|---|
| persona_prompt | text | 否 | 人设提示词，定义角色、性格和行为 | 多行文本框（TextArea） | 无 |
| opening_message | text | 否 | 开场白，首次对话时自动发送 | 多行文本框（TextArea） | 无 |
| output_lang | varchar(45) | 否 | 输出语言：auto-自动匹配，zh-中文，en-英文 | 下拉选择 | en-US |
| max_tokens（高级配置） | int | 否 | 单次交互所用的最大Token数 | 数字输入框（带说明） | 0（不限制） |
| temperature（高级配置） | decimal(3,2) | 否 | 模型温度参数，控制随机性（0-2） | 滑块（Slider）+ 数字输入 | 0.70 |
| top_p（高级配置） | decimal(3,2) | 否 | Top-P 核采样参数（0-1） | 滑块（Slider）+ 数字输入 | 1.00 |
| final_prompt | text | 否 | 最终提示词（系统自动合并生成） | 只读文本框 | 系统生成 |
UI设计建议：
- persona_prompt 和 opening_message 使用富文本编辑器或支持多行的文本框
- output_lang 使用下拉选择：auto、zh、en
- max_tokens 添加"根据模型上下文限制设置，0表示不限制"的提示
- temperature 使用滑块控件，范围 0-2，步长 0.01，显示当前值
- top_p 使用滑块控件，范围 0-1，步长 0.01，显示当前值
- final_prompt 为只读字段，显示"系统自动生成"标识
- 滑块控件建议提供常用值快速选择按钮（如：0、0.5、0.7、1.0）
第四部分：历史记录
| 字段名 | 类型 | 必填 | 说明 | 表单控件 | 默认值 |
|---|---|---|---|---|---|
| is_chat_history（高级配置） | bit(1) | 否 | 是否使用公共成交案例聊天记录完善角色设定 | 开关控件（Toggle） | 0（否） |
| is_history_message（高级配置） | bit(1) | 否 | 是否在和智能体对话时传入本次会话的历史记录 | 开关控件（Toggle） | 1（是） |
| history_message_count（高级配置） | int | 否 | 传入本次会话的历史消息条数 | 数字输入框 | 20 |
UI设计建议：
- 使用开关控件，状态清晰可见
- history_message_count 仅在 is_history_message=1 时启用
- history_message_count 添加"建议范围：10-50"的提示
第五部分：回复设置
| 字段名 | 类型 | 必填 | 说明 | 表单控件 | 默认值 |
|---|---|---|---|---|---|
| reply_start_time（高级配置） | time | 否 | 自动回复开始时间（开始和结束时间一致代表全天） | 时间选择器 | 无 |
| reply_end_time（高级配置） | time | 否 | 自动回复结束时间 | 时间选择器 | 无 |
| message_new_enabled（高级配置） | tinyint(1) | 是 | 是否回复新消息：0-否，1-是 | 开关控件（Toggle） | 1（是） |
| message_history_enabled（高级配置） | tinyint(1) | 是 | 是否回复历史未回消息：0-否，1-是 | 开关控件（Toggle） | 0（否） |
| emoji_message_template（高级配置） | varchar(255) | 否 | 用户发送大表情时替换发送给智能体的固定内容 | 文本输入框，带占位符示例 | [用户发送了一个大表情] |
| image_message_template（高级配置） | varchar(255) | 否 | 用户发送图片时替换发送给智能体的固定内容 | 文本输入框，带占位符示例 | [用户发送了一张图片] |
| reply_delay（高级配置） | int | 是 | 回复间隔（秒）：控制AI回复的发送频率 | 数字输入框，带说明 | 0（不限制） |
UI设计建议：
- reply_start_time 和 reply_end_time 使用时间段选择控件
- 添加"全天自动回复"快捷选项（两个时间一致）
- message_new_enabled 和 message_history_enabled 使用开关控件
- emoji_message_template 和 image_message_template 使用文本输入框，提供默认值占位符
- reply_delay 添加"0表示不限制"的提示
- 回复设置建议使用卡片分组，标题为"自动回复控制"
第六部分：关注回复
| 字段名 | 类型 | 必填 | 说明 | 表单控件 | 默认值 |
|---|---|---|---|---|---|
| follow_new_enabled（高级配置） | tinyint(1) | 是 | 是否回复新关注：0-否，1-是 | 开关控件（Toggle） | 1（是） |
| follow_history_enabled（高级配置） | tinyint(1) | 是 | 是否回复历史关注：0-否，1-是 | 开关控件（Toggle） | 0（否） |
| follow_new_mode（高级配置） | tinyint(1) | 是 | 关注回复模式：0-固定回复，1-智能体回复 | 单选框（Radio） | 1（智能体回复） |
| follow_new_fixed_content（高级配置） | varchar(255) | 否 | 关注固定回复内容 | 多行文本框（TextArea） | 无 |
| follow_message_template（高级配置） | varchar(255) | 否 | 新关注事件发生时，替换发送给智能体的固定内容 | 文本输入框，带占位符示例 | [新用户关注了你] |
UI设计建议：
- follow_new_enabled 和 follow_history_enabled 使用开关控件
- follow_new_mode 使用单选框，每个选项带说明
- follow_new_fixed_content 仅在 follow_new_mode=0 时显示
- follow_message_template 仅在 follow_new_mode=1 时显示
- 所有字段建议放在"新用户关注设置"卡片中
动态显示逻辑：
follow_new_mode = 0 (固定回复) └── 显示：follow_new_fixed_content follow_new_mode = 1 (智能体回复) └── 显示：follow_message_template第七部分：异常处理
| 字段名 | 类型 | 必填 | 说明 | 表单控件 | 默认值 |
|---|---|---|---|---|---|
| fallback_content | varchar(255) | 否 | 兜底回复（当智能体无法回复时使用） | 多行文本框（TextArea） | 无 |
| is_stop_fail | bit(1) | 是 | 不达标是否终止：0-否，1-是 | 开关控件（Toggle） | 0（否） |
| fail_condition | text | 否 | 不达标终止触发条件，多个词语用逗号分隔 | 标签输入框（Tags Input）或文本框 | 无 |
| is_stop_pass | bit(1) | 是 | 达标是否终止：0-否，1-是 | 开关控件（Toggle） | 0（否） |
| pass_condition | text | 否 | 达标终止触发条件，多个词语用逗号分隔 | 标签输入框（Tags Input）或文本框 | 无 |
UI设计建议：
- fallback_content 使用多行文本框，提供"例如：抱歉，我现在无法回复，请稍后再试"的占位符
- is_stop_fail 和 is_stop_pass 使用开关控件
- fail_condition 仅在 is_stop_fail=1 时显示
- pass_condition 仅在 is_stop_pass=1 时显示
- fail_condition 和 pass_condition 使用标签输入框（Tags Input），支持逗号分隔
- 建议添加常用触发词快捷选择