智能体管理页面设计文档

📋 页面概述

智能体管理页面用于创建、编辑和管理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），支持逗号分隔
• 建议添加常用触发词快捷选择