智能体配置

智能体是 LinkZone 中负责 AI 对话的核心模块。每个智能体拥有独立的人设、模型配置、记忆、技能和工具。

配置智能体

智能体通过 Web 后台进行配置。打开管理后台 → 智能体管理，即可创建、编辑和管理智能体。

创建智能体时需要填写基本信息（ID、名称）和各项配置，配置数据保存在数据库中，修改后即时生效。

人设配置（personality）

人设决定了智能体的"性格"和"说话方式"：

字段	类型	说明
`name`	string	智能体名称
`custom_identity`	string	自定义身份描述
`custom_role_bounds`	string	角色边界
`backstory`	string	背景故事
`relationship_style`	string	关系风格
`speech_style`	string	说话风格
`humor_style`	string	幽默风格
`response_length`	string	回复长度偏好
`proactive_rules`	string	主动发言规则
`taboo_topics`	[]string	禁忌话题
`behavior_rules`	string	行为规则
`custom_constraints`	string	自定义约束
`custom_safety`	string	自定义安全规则
`traits`	[]string	性格特征，如 `["友善", "幽默", "随和"]`
`emojis`	[]string	常用表情，如 `["😂", "👍"]`
`catchphrase`	[]string	口头禅，如 `["确实", "有道理"]`
`visual_style`	string	视觉描述风格
`examples`	[]DialogueExample	对话示例

示例：

json

{
  "personality": {
    "name": "小助手",
    "custom_identity": "你是一个友好的AI助手",
    "speech_style": "口语化、简短、偶尔用表情",
    "traits": ["友善", "幽默", "随和"],
    "emojis": ["😂", "🤣", "👍"],
    "catchphrase": ["确实", "有道理"],
    "examples": [
      { "user": "你好", "bot": "嗨！有什么我可以帮你的吗？" },
      { "user": "今天天气怎么样", "bot": "让我帮你查一下~" }
    ]
  }
}

模型配置（runtime）

模型配置决定了智能体使用的 LLM 模型和参数：

字段	类型	默认值	说明
`default.model`	string	`"gpt-4o-mini"`	默认模型
`default.temperature`	float	`0.7`	温度参数
`default.max_tokens`	int	`2048`	最大输出 Token
`default.enable_tools`	bool	`true`	是否启用工具调用
`default.enable_stream`	bool	`false`	是否启用流式输出
`default.max_tool_loops`	int	`5`	最大工具调用循环次数
`default.timeout_seconds`	int	`60`	超时时间（秒）
`scenes`	map	—	场景化模型配置

场景配置：可以为不同场景设置不同的模型参数：

json

{
  "runtime": {
    "default": {
      "model": "deepseek-chat",
      "temperature": 0.7,
      "max_tokens": 2048
    },
    "scenes": {
      "chat": { "temperature": 0.7, "max_tokens": 2048 },
      "assist": { "temperature": 0.6, "max_tokens": 2048 },
      "task": { "temperature": 0.3, "max_tokens": 1024 }
    }
  }
}

聊天配置（chat）

字段	类型	默认值	说明
`talk_value`	float	`0.15`	说话概率（0~1）
`mentioned_reply`	bool	`true`	被 @ 时是否回复
`max_context_size`	int	`30`	最大上下文长度
`think_mode`	string	`"dynamic"`	思考模式
`min_delay`	int	`500`	最小回复延迟（毫秒）
`max_delay`	int	`3000`	最大回复延迟（毫秒）
`min_interval`	int	`10000`	最小发言间隔（毫秒）
`trigger_words`	[]string	`[]`	触发词列表
`active_hours`	[]int	`[9..22]`	活跃时段
`rate_limit_rps`	float	`2`	限流 RPS（0 不限）
`rate_limit_burst`	int	`5`	限流突发量
`message_merge_wait`	int	`5000`	消息合并等待时间（毫秒）
`message_merge_max`	int	`10`	消息合并最大条数

记忆配置（memory）

字段	类型	默认值	说明
`max_short_term`	int	`50`	短期记忆最大条数
`short_term_ttl`	int	`3600`	短期记忆 TTL（秒）
`short_term_max_tokens`	int	`4000`	短期记忆最大 Token
`long_term_enabled`	bool	`true`	长期记忆开关
`enable_user_profile`	bool	`true`	用户画像开关
`enable_group_culture`	bool	`true`	群文化开关
`global_memory`	bool	`false`	全局记忆开关
`summary_enabled`	bool	`false`	摘要开关
`summary_threshold`	int	`50`	摘要触发阈值
`summary_model`	string	`""`	摘要模型（建议用便宜模型）
`shared_context_ttl`	int	`1800`	共享上下文 TTL（秒）

工具配置（tools）

字段	类型	说明
`enabled`	bool	是否启用工具
`allowed_plugins`	[]string	允许的插件工具列表（空=全部）
`mcp_servers`	[]MCPServerConfig	MCP 服务器配置

MCP 服务器配置：

字段	类型	说明
`name`	string	服务器名称
`command`	string	启动命令
`args`	[]string	命令参数
`env`	[]string	环境变量

技能配置（skills）

字段	类型	说明
`enabled`	bool	是否启用技能
`allow_all`	bool	允许所有技能
`allowed`	[]string	允许的技能列表
`match_strategy`	string	匹配策略（rule/llm/hybrid）

多模态配置（multimodal）

字段	类型	默认值	说明
`enabled`	bool	`true`	是否启用多模态
`enable_image`	bool	`true`	图片理解
`enable_audio`	bool	`true`	音频理解
`enable_video`	bool	`true`	视频理解
`image_model`	string	`""`	图片理解模型（空则使用默认模型）
`max_image_size`	int	`5120`	图片最大大小（KB）
`image_wait_seconds`	int	`3`	图片等待时间（秒）

表情配置（expression）

字段	类型	默认值	说明
`enable_sticker`	bool	`true`	是否启用表情包
`sticker_rate`	float	`0.1`	表情包发送概率
`emoji_chance`	float	`0.4`	Emoji 发送概率
`steal_emoji`	bool	`true`	是否偷取群内表情
`emoji_inline`	bool	`true`	是否内联 Emoji

智能体路由

当一条消息需要 AI 响应时，框架按以下优先级选择智能体：

群官方绑定智能体
群启用的智能体列表
用户群组上下文偏好
系统默认智能体

在管理后台中，可以为每个群组绑定或启用指定的智能体。

智能体配置 ​

配置智能体 ​

人设配置（personality） ​

模型配置（runtime） ​

聊天配置（chat） ​

记忆配置（memory） ​

工具配置（tools） ​

技能配置（skills） ​

多模态配置（multimodal） ​

表情配置（expression） ​

智能体路由 ​