AI 智能助理指南

本指南覆盖 MihootCRM 的 AI 智能助手系统——从日常使用到高级配置，帮助你充分发挥 AI 能力。

1. 概述

AI 智能助手是 MihootCRM 的核心智能层，提供两种运行模式：

系统支持多家 LLM 提供商：Google Gemini、OpenAI、Anthropic Claude、Qwen（通义千问）、DeepSeek。

2. 访问 AI 助手

2.1 Web 端

三种入口：

1. 助手主页面：直接访问 /assistant，获得完整的对话界面
2. 全局浮动按钮：任意页面右下角的浮动 AI 按钮，点击后在右侧滑出对话面板
   • 快捷唤醒：Cmd+Shift+A（Mac）/ Ctrl+Shift+A（Windows）
3. 工作流编辑器：在节点面板中添加 AI Agent 节点

2.2 企业微信端

• 侧边栏：在企业微信客户端右侧侧边栏的 Assistant Tab 中直接使用
• AI Bot：在企微中向 MihootCRM Bot 发送消息，Bot 自动响应

详见「企业微信集成指南」。

3. 助手基础用法

3.1 消息输入与发送

1. 在输入框中输入自然语言指令或问题
2. 按 Enter 发送消息
3. AI 分析你的意图，调用相应的 CRM 工具，返回结果

3.2 页面上下文感知

当你在某个 CRM 页面（如联系人详情页）打开 AI 助手时，助手会自动感知当前页面上下文：

• 所在页面：自动获取当前路由（如 /people/xxx）
• 实体信息：自动获取当前实体的类型和 ID
• 场景化建议：助手会优先提供与当前页面相关的帮助

3.3 两种交互模式

在 /assistant 页面，可在两种模式间切换：

• Chat（对话）模式：标准 ReAct 模式，适合单步骤查询和操作。助手每轮思考 → 调用工具 → 返回结果
• Planner（规划器）模式：多步骤任务规划，适合复杂操作。助手先生成执行计划，再按计划逐步执行，并实时展示进度

选择建议：

• 简单查询（"张三的手机号"）→ Chat 模式
• 复杂任务（"给所有高价值客户创建跟进任务，并按优先级排序"）→ Planner 模式

4. AI 工具能力

AI 助手拥有 47 个 CRM 工具，分为四大类：

4.1 查询类（Search）

查询 CRM 中的各种实体数据。

示例对话：

• "帮我查一下张三的联系方式" → search_patient
• "李四有哪些待跟进的商机" → search_opty
• "最近一周创建的高优先线索有哪些" → search_inquiry
• "我今天的待办任务" → search_task

4.2 创建类（Create）

在 CRM 中创建新的实体记录。

示例对话：

• "创建一个明天下午 2 点回访张三的任务" → create_task
• "把王五添加为新线索，来源是活动报名" → create_inquiry
• "给赵六创建正畸方案商机，金额 3 万" → create_opty

4.3 更新类（Update）

修改现有 CRM 记录。

示例对话：

• "把张三的联系方式更新为 138xxxx" → update_patient
• "将线索王五的阶段改成已到店" → update_inquiry（自动触发线索到联系人转化）
• "把商机报价阶段的金额改成 5 万" → update_opty

4.4 专项分析（Analysis）

深度分析客户价值和行为。

示例对话：

• "帮我分析一下张三的客户价值" → get_patient_value（返回 CLV、家庭贡献、pLTV 等）
• "张三最近一个月有哪些交互记录" → search_pulse（查看活动审计日志）

所有对话式操作的详细说明与销售场景示例见「对话式 CRM 操作指南」。

5. AI 技能（AI Skills）

什么是 AI 技能

AI 技能是可配置的专用能力单元，执行特定任务并输出结构化结果。技能可被 AI 助手在工作流中按需调用，也可以被组合进 AI 剧本。

配置步骤

1. 进入 AI 技能配置页（Settings → AI Skills）
2. 点击"创建技能"，填写：
   • 名称：技能的唯一标识（如"线索评分分析"）
   • 描述：告诉 AI 何时调用此技能
   • 触发关键词：逗号分隔，如"评分,打分,评估线索质量"
   • 提示词：技能的详细指令和输出格式要求
3. 勾选"启用"开关
4. 保存后，技能自动在下一轮对话中生效

使用场景

不使用技能时：每次分析线索都需要在对话中详细描述分析维度。

使用技能后：只需说"分析下这条线索"，AI 自动匹配"线索评分分析"技能，从多个维度输出结构化报告——省去重复描述分析标准的麻烦。

6. AI 剧本（AI Playbooks）

什么是 AI 剧本

AI 剧本是多步骤的 AI 工作流，将多个 AI 技能串联执行，输出综合结果。剧本的每个步骤可设置为：

• 普通步骤：执行 AI 技能，输出传递给后续步骤
• 终端步骤：最后一步，其输出作为整个剧本的最终结果

配置步骤

1. 进入 AI 剧本配置页（Settings → AI Playbooks）
2. 点击"创建剧本"：
   • 名称：如"新线索全面评估"
   • 触发关键词：如"全面评估,综合评估新线索"
   • 步骤 JSON：定义步骤链，每步包含技能 ID、步骤类型、依赖关系、并行组
3. 保存后启用，版本号自动递增

剧本执行流程

1. 用户说出触发关键词
2. 系统匹配对应剧本（取最高版本）
3. 按依赖关系拓扑排序执行步骤
4. 支持并行组（同一组内的步骤并行执行）
5. 终端步骤的输出作为最终结果返回给用户

7. 语义层（Semantic Layer）

什么是语义层

语义层是租户特定的 CRM 数据字典，将业务术语映射到系统实体和字段，帮助 AI 准确理解你的行业用语。

为什么需要语义层

不同行业对同一概念有不同的称呼：

有了语义层，AI 就不会把"患者"理解错误，也知道"治疗方案"对应的数据表是商机表。

配置步骤

1. 进入 语义层配置页（Settings → Semantic Layer）
2. 配置内容：
   • 行业选择：选择你的行业（如 dental 口腔医疗）
   • 实体定义：添加业务别名和 canonical 表名
   • 字段映射：将业务术语映射到具体的实体.字段
   • 业务规则：列出 AI 应遵守的业务约束
3. 右侧实时预览：以 Markdown 格式预览语义档案（这就是注入 AI 提示词的内容）
4. 保存后，下一轮对话生效

8. AI 模型配置

为什么需要配置 AI 模型

你可以为租户配置专用的 LLM 模型和 API Key：

• 成本控制：选择性价比最高的模型（如 Gemini 2.0 Flash 适合简单任务）
• 合规要求：使用企业自有的模型或私有化部署的 API
• 能力匹配：复杂推理任务使用 GPT-4o，简单任务使用轻量模型

配置步骤

1. 进入 AI 模型配置页（Settings → AI Model Config）
2. 选择提供商（OpenAI / Google / Anthropic / Qwen / DeepSeek）
3. 选择凭证（从已存凭证中选取，或内联新建凭证）
4. 配置参数：
   • 模型 ID：自定义模型名称（留空使用提供商默认）
   • 温度：0（精确）到 1（创意），步长 0.1
   • 翻译语言：选择目标翻译语言（若使用翻译功能）

模型解析优先级

1. 租户 AI 模型配置（/settings/ai-model-config）
2. 工作流 AI Agent 节点独立的模型配置
3. 环境变量配置的 Gemini（最终回退）

9. MCP 服务端

什么是 MCP

MihootCRM 内置了 MCP（Model Context Protocol）服务端，允许外部 AI 客户端（Cursor、Claude Desktop 等）通过标准协议调用 CRM 工具。

典型使用场景

• 在 Cursor IDE 中直接查询 CRM 数据：帮我在 CRM 中查一下张三的客户价值
• 在 Claude Desktop 中操作 CRM：在 MihootCRM 中创建一个跟进任务

配置方式

详见「MCP Server 配置指南」。

10. 相关文档

• 对话式 CRM 操作指南 — 用自然语言完成所有 CRM 操作
• 自动化工作流指南 — AI Agent 节点配置
• MCP Server 配置指南 — 外部 AI 客户端连接
• 设置中心指南 — AI 相关配置入口汇总