AI Agent 智能客服
旺财狗 2.3.2.0 版本引入了 AI Agent 智能客服系统，支持对接大语言模型（LLM）实现智能对话、工具调用、知识库检索等功能。
💬 功能简介
AI Agent 在传统指令处理之后执行，有两种工作模式：
- AI 润色：当上层指令已返回结果时（如转链成功），AI 可以对结果进行润色优化
- AI 兜底：当上层指令未匹配到结果时，AI 直接生成回复
配置指南
在旺财狗管理界面中，进入 AI管理 页面进行配置。
基础配置
| 配置项 | 说明 | 默认值 |
|---|---|---|
| AI开关 | 是否启用 AI Agent | 关闭 |
| API地址 | LLM API 地址（OpenAI 兼容） | - |
| API Key | LLM API 密钥 | - |
| 模型名称 | 如 gpt-4o、deepseek-chat 等 | gpt-4o |
| 默认角色 | 默认使用的 AI 角色 ID | 0（默认提示词） |
| 对话历史条数 | 注入给 AI 的历史消息数量 | 10 |
| 温度参数 | 控制回复随机性（0-2） | 0.7 |
| 最大输出Token | 单次回复最大 token 数 | 1000 |
触发模式配置
AI Agent 支持私聊和群聊分别配置触发模式：
私聊触发模式（trigger_mode）：
| 模式 | 说明 |
|---|---|
all | 所有消息都触发 AI |
fallback_only | 仅在传统指令未匹配时触发 AI（推荐） |
at_only | 仅在@机器人时触发 |
群聊触发模式（group_trigger_mode）：
| 模式 | 说明 |
|---|---|
at_only | 仅在@机器人时触发（推荐） |
enabled | 所有消息都触发 AI |
off | 群聊关闭 AI |
频率限制
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 每用户每日上限 | 单用户每天 AI 调用次数上限 | 0（不限） |
| 每机器人每日上限 | 单机器人每天 AI 调用次数上限 | 0（不限） |
⚠️ 注意
频率限制按日维度计数，每日自动重置。只有真正调用 AI 时才扣减配额，普通指令不会消耗。
其他配置
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 启用工具调用 | 是否允许 AI 调用工具（转链、查单等） | 开启 |
| 排除IM类型 | 不接 AI 的聊天平台 | 公众号 |
| 回复最大字数 | AI 回复的字符数上限 | 600 |
| 转人工提示语 | AI 失败时转人工的提示 | - |
| AI失败降级 | AI 失败是否降级到传统指令 | 开启 |
| 群聊沉默分钟数 | 群聊中机器人沉默多久后不回复 | 5 |
| 相关性守门 | 群聊中判断消息是否与角色相关 | 开启 |
| 相关性阈值 | 余弦相似度阈值，低于则不回复 | 0.4 |
AI 角色
系统内置 5 个 AI 角色，可在管理界面中查看和编辑：
内置角色
| 角色名称 | 适用场景 | 可用工具 |
|---|---|---|
| 返利助手 | 全功能返利服务 | 全部14个工具 |
| 客服助手 | 专注客服咨询 | 5个工具（查单、积分、提现等） |
| 群聊助手 | 群聊场景 | 搜索、转链等 |
| 软件使用向导 | 软件使用指导 | 基于知识库回答 |
| 闲鱼省钱达人 | 闲鱼专用 | 转链、搜索（使用"内购礼金"话术） |
角色配置项
每个角色可以配置以下内容：
- 系统提示词：定义 AI 的角色、行为和回复风格
- 可用工具：该角色可以使用的工具列表（留空=全部可用）
- 知识库开关：该角色是否启用知识库检索
- 知识库标识：绑定的特定知识库
通用规则
系统内置 4 条通用规则，自动拼接到系统提示词中：
- 对话上下文规则：让 AI 理解前置流程已做了什么，避免重复建议
- 数据展示规则：禁止对用户数据打码，必须原样展示真实数字
- 工具路由规则：指导 AI 什么意图调什么工具
- 回复风格规则：简洁友好、100字以内、纯文本
AI 工具
AI Agent 内置 14 个工具，通过 Function Calling 协议调用：
| 工具名 | 功能 |
|---|---|
search_goods | 搜索优惠商品（支持京东/淘宝/拼多多/唯品会/抖音） |
convert_link | 购物链接转返利链接 |
get_user_orders | 查询用户返利订单明细 |
get_rebate_stats | 查询返利统计（今日/本月） |
get_my_points | 查询用户积分和返利汇总 |
request_withdrawal | 申请提现（仅私聊） |
bind_order | 手动绑定订单号 |
get_personal_center | 获取个人中心链接 |
subscribe_notifications | 获取消息推送订阅链接 |
call_customer_service | 呼叫人工客服 |
subscribe_keyword | 订阅商品关键词推送 |
unsubscribe_keyword | 删除关键词订阅 |
clear_all_subscriptions | 清空所有订阅 |
taobao_auth | 淘宝渠道关系授权（仅私聊） |
💡 工具调用
AI 最多进行 5 轮工具调用。例如用户问"帮我查一下今天的订单"，AI 会自动调用 get_rebate_stats 工具获取数据，然后生成自然语言回复。
支持的 AI 模型
系统采用 OpenAI 兼容 API 架构，支持任何兼容 OpenAI Chat Completions 协议的服务：
- OpenAI：gpt-4o、gpt-4o-mini 等
- DeepSeek：deepseek-chat、deepseek-reasoner 等
- 通义千问：通过 OpenAI 兼容接口
- Moonshot（月之暗面）：moonshot-v1-8k 等
- 本地 Ollama：本地部署的开源模型
- 其他兼容服务：任何提供 OpenAI 兼容 API 的服务
⚠️ 注意
- API 地址需填写完整的 chat completions 路径，如
https://api.openai.com/v1/chat/completions - HTTP 客户端超时为 30 秒，请确保模型响应速度在合理范围内
- 公众号场景默认不接 AI（因5秒超时限制）