夜雨聆风前言：在我们Dmmsys Enterprise Essence AI产品规划到实现的过程中，我们对Odoo 19企业版和SAP系统当前AI产品的进展情况，通过Deepseek进行了大量的分析工作，得出的结论是，Odoo19企业版的AI产品，核心价值在于意图驱动业务流程，因此我们的第一个层级的产品，就以这个核心功能为目标进行规划和实现。下面是对OdooAI功能的总结内容。
本总结整合了 Odoo 19 企业版 AI 模块的核心能力及其扩展功能，全文以“意图驱动”为主线，从管理员配置、用户交互、系统执行到后台管理，逐层描述所有业务功能及其操作流程，不包含任何代码实现细节。
一、总体理念：从操作界面到表达意图
传统企业软件要求用户记住菜单路径、筛选条件、报表配置等操作步骤。Odoo 19 AI 模块颠覆了这一模式：用户只需用自然语言说出业务意图（例如“查看本月销售订单，按客户分组”），AI 便会自动理解、匹配系统能力、执行操作并返回结果。
整个模块的设计围绕“意图驱动”展开：
管理员为意图准备“能力”（工具、菜单、知识源）和“上下文”（文档、字段提示词、知识文章、客服规则、自动化动作）。
用户通过对话、语音、内联提示框或点击字段/编辑器/客服窗口按钮表达意图。
AI 代理解析意图，调用 RAG 检索私有知识，执行工具或操作界面，自动填充字段，生成文章内容，并作为在线客服自动回复访客。
系统记录所有意图处理过程，供审计和优化。
下面按照配置 → 交互 → 执行 → 管理的层次，逐一列举所有功能细节。
二、管理员配置层：为意图准备能力与上下文
1. AI 代理：定义意图处理器
创建代理：管理员可创建多个代理，分别对应不同业务领域（如“销售助理”、“HR 问答机器人”、“在线客服 AI”）。每个代理有独立名称、头像、副标题。
设定系统提示词：详细描述代理的行为准则、回复格式、专业知识范围，用于指导意图解析。对于用于在线客服的代理，系统会自动附加专门的客服提示（如“严格采用问答风格，给出简短准确的答案”）。
选择响应风格：分析型（严谨）、平衡型（适中）、创意型（灵活）。影响代理对模糊意图的倾向。
选择语言模型：支持 OpenAI（GPT‑3.5/4/4o/4.1/5）和 Google Gemini 系列。不同模型在处理复杂意图、长文本上的能力不同。
限制信息来源：开启后，代理仅基于上传的知识源回答，不依赖通用知识。适用于“内部政策问答”等严格意图。
复制与删除：系统内置代理不可删除，但可复制后修改；普通代理可删除。
2. 知识源：为意图提供事实依据
上传文件：支持 PDF、Word、Excel、PowerPoint、OpenDocument、纯文本。系统自动提取文本、分块、生成向量嵌入。
添加网页链接：提供 URL，系统抓取正文、过滤无关元素，同样分块并向量化。
从文档管理系统添加：从 Documents 应用中选择已有文档，自动复制附件并创建知识源。
从知识库添加：从 Odoo 知识库中选择一个或多个知识文章及其子文章，系统提取所有正文内容并向量化。
状态跟踪：知识源状态分为“处理中”、“已索引”、“失败”。失败时可手动重试。
权限控制：对文件/文档/文章无权限的用户，其意图无法引用对应来源。
激活开关：可临时停用某个来源而不删除数据。
3. 话题与工具：将业务操作封装为意图可调用的能力
话题：一组指令和工具的集合。管理员创建话题，编写额外的行为指导（如“当用户询问库存时，优先使用库存查询工具”）。
工具（AI 可调用的服务器动作）：
将任意服务器动作标记为“用于 AI”。
编写描述：一句话告诉 AI 这个工具实现什么业务意图（例如“将订单状态改为已确认”）。
定义参数 Schema：通过图形化界面定义参数名称、类型（文本、整数、布尔、枚举、数组等）、验证规则（正则、最大长度）、是否必需。
工具链：一个工具可以包含多个子动作（多步骤动作），实现复杂意图的一站式执行。
4. 场景规则：为不同 UI 入口绑定代理
场景类型：邮件编辑器、HTML 字段重写、记录卡片、系统托盘、知识文章编辑器、在线客服等。
配置内容：每个场景可指定使用哪个 AI 代理、默认提示词（可选）。
预设提示按钮：为每个场景配置最多 3 个快捷提示按钮。用户在界面中点击即可快速填充意图。
模型过滤：可限制规则仅对特定业务模型生效（例如仅在“销售订单”表单中显示）。
5. AI 字段自动填充
概念：让 AI 根据记录的其他字段值自动推导并填充某个字段。管理员在模型字段或动态属性中勾选“AI 字段”并填写提示词。
触发方式：
自动批量填充：系统定时任务扫描空值字段，调用 LLM 填充。
即时手动填充：用户点击字段旁的 AI 图标按钮，立即基于当前记录的变更值计算并填入。
记录创建时触发：新建记录后立即安排定时任务尽快填充。
权限与安全：只有具有“邮件模板编辑器”权限的用户才能配置 AI 字段提示词；提示词中引用的字段必须在允许的白名单内。
典型应用：自动摘要、智能分类、翻译润色、数据补全。
6. 服务器动作中的 AI 字段更新
背景：除了在模型字段级别配置 AI 填充外，Odoo 还允许管理员在服务器动作中配置 AI 驱动的字段更新。这为自动化流程提供了更大的灵活性。
配置方法：
创建一个服务器动作，类型选择“更新记录” 。
在“评估类型”选项中，选择 “用 AI 更新” 。
选择要更新的目标字段（必须是可存储的数据库字段，不能是计算字段或关系字段）。
在“AI 更新提示词”字段中编写提示词（同样支持 /field 和 /record 引用当前记录的任何字段值或关联记录）。
提示词会告诉 AI 如何根据当前记录的其他信息推导出目标字段的值。例如：“根据产品名称 [name]和描述 [description]，生成一个 SEO 友好的产品副标题。”
与普通 AI 字段的区别：
普通 AI 字段是与特定字段绑定的，由系统定时任务或用户手动点击触发，适合“固定字段自动填充”的场景。
服务器动作中的 AI 字段更新则是可复用的自动化逻辑：同一个动作可以被定时任务、自动化规则、按钮点击等多种方式触发，并且可以与其他服务器动作（如发送邮件、创建记录）组合使用。
触发方式示例：
定时自动触发：将服务器动作附加到一个自动化规则（base.automation）上，当记录创建或更新时自动执行，AI 会计算并更新字段值。
手动批量触发：在列表视图中选择多条记录，从“动作”菜单中执行该服务器动作，AI 会逐条计算并更新字段。
在流程中调用：在更复杂的服务器动作链中，可以作为一个步骤调用（例如先 AI 计算一个值，然后发送邮件）。
安全性：只有具有“邮件模板编辑器”权限的管理员才能配置这类动作；提示词中引用的字段同样受白名单限制。
典型应用场景：
批量数据清洗：对大量历史数据统一使用 AI 生成缺失的字段值。
自动化流程增强：例如当客户创建时，AI 自动根据客户名称和行业推测客户等级并填入字段。
与其他动作联动：AI 计算出结果后，立即触发状态变更、邮件通知或审批流程。
7. 在线客服规则：将 AI 代理配置为客服机器人（ai_livechat 扩展）
背景：Odoo 的在线客服（Livechat）原本支持人工客服和脚本化聊天机器人（chatbot）。ai_livechat 模块新增了 AI 代理作为第三种客服类型。
配置方法：
管理员进入“在线客服”应用的“渠道”设置，在某个渠道的“规则”中，可以配置一个 AI 代理。
对于每条规则，可以设置触发的条件（例如 URL 匹配、页面位置等）。当访客在该规则匹配的页面上点击客服按钮时，系统会优先分配一个 AI 代理（如果规则中指定了）。
同一规则下可以同时配置脚本化聊天机器人和 AI 代理，但 AI 代理拥有更高优先级（如果两者都存在，系统会使用 AI 代理）。
AI 代理的专用系统提示：当代理被用于在线客服场景时，系统会自动向其注入额外的提示词，强制代理采用“问答风格”，给出简短、准确的答案，模拟真人客服的交互习惯。
访客无需登录：在线客服允许匿名访客（未登录用户）发起对话，AI 代理能够直接响应，无需用户注册或登录。
8. 跨域支持（CORS）
为了使 AI 客服功能能够被嵌入到外部网站（例如企业官网），模块提供了带有 CORS 头的路由端点。外部网站可以通过 JavaScript 直接调用 AI 生成回复、错误处理、关闭聊天等功能，从而实现将 Odoo AI 客服无缝嵌入任何第三方网站。
三、用户交互层：用自然语言表达意图
1. 对话式交互：直接说出意图
用户可以通过多种入口打开与 AI 代理的聊天窗口：系统托盘图标、命令面板（Ctrl+K）、搜索栏菜单、代理详情页。
聊天窗口支持文字和语音输入，代理能记住历史对话，支持连续追问。
对于代理的回复，用户可执行“使用此回复”、“作为消息发送”、“记录为笔记”等操作。
当从业务表单打开聊天时，代理自动获得当前记录的上下文（模型、记录 ID、关键字段值），从而给出更精准的回答。
2. 在线客服中与 AI 代理对话
访客发起会话：
访客在网站上点击客服按钮（例如浮动聊天图标），系统根据当前页面的 URL 匹配规则，决定分配人工客服、脚本化聊天机器人还是 AI 代理。
如果规则配置了 AI 代理，访客会立即与 AI 代理建立对话。AI 代理会首先发送一条欢迎消息（由系统预定义）。
AI 代理自动回复：
访客输入问题后，AI 代理根据其配置的知识源（文件、文档、知识文章）和通用能力，自动生成回答。整个回复过程类似与真人客服聊天。
AI 代理遵循专用的“客服风格”提示，回答简洁、直接，符合实时聊天场景。
转接给人工客服：
如果 AI 代理无法解答访客的问题，或者访客明确要求“转人工”，聊天窗口中会显示一个“转人工”按钮。
访客点击该按钮后，系统会尝试将对话转接给真人客服（或继续转给脚本化聊天机器人，如果规则中配置了）。如果当前没有可用的人工客服，系统会提示“暂无人工客服可用，请稍后再试”。
转接成功后，AI 代理会从频道成员中移除，人工客服加入；同时频道名称会更新为客服的名称。
与脚本化聊天机器人的协作：
规则可以同时配置 AI 代理和一个脚本化聊天机器人（例如预先编好的问答流程）。AI 代理拥有更高优先级，只有AI 代理不可用或转接失败时，才会启用脚本化聊天机器人。
如果规则仅配置了脚本化聊天机器人而没有 AI 代理，则行为与标准 Odoo 一致（机器人按脚本回复，然后转人工）。
3. 自然语言操作界面：意图直接驱动 UI
用户在与 AI 代理的普通对话中，可以直接说出操作意图，例如“打开销售订单列表，只显示本月创建的，按客户分组”。AI 会解析意图，找到对应菜单，应用筛选和分组，并打开视图。
支持动态调整当前视图。
所有操作通过系统总线事件传递，用户无需手动操作菜单和筛选器。
4. 内联 AI 提示：在文档/邮件中嵌入生成意图
在支持富文本编辑器的任何地方（邮件正文、邮件模板、HTML 字段、知识文章正文），用户输入 /提示词可插入一个蓝色提示框，框内写生成意图。
保存或发送时，系统调用 AI 生成内容替换提示框。
5. 知识文章编辑器中的 AI 生成文章
在知识库编辑器中，点击按钮打开 AI 聊天窗口。
用户告诉 AI 写作主题和要求，AI 生成完整的文章 HTML（含标题结构），并替换编辑器内容。系统自动确保至少有一个 <h1> 标题。
6. 手动触发 AI 字段计算
在表单视图中，AI 字段旁有一个 AI 图标按钮。用户点击后，系统立即基于当前记录（包括未保存的变更）调用 LLM 计算新值并填入字段。
7. 语音输入
在聊天窗口或支持语音的编辑器中点击麦克风图标，说话即可实时转为文字。
四、系统执行层：意图的解析与执行
1. 意图解析与 RAG 检索
AI 代理将用户输入与系统提示、话题指令、客服专用提示结合，判断意图类型。
若需要私有知识，自动将问题向量化，从知识源（文件、文档、知识文章）中检索最相关的 5 个文本块。
回答末尾列出引用来源，无权限来源标注“不可引用”。
2. 工具调用
代理根据意图匹配工具（如“确认订单”、“发送邮件”），从用户话语和上下文中提取参数，执行并反馈结果。
支持链式调用（多个工具顺序执行）和终止消息机制。
3. 视图操作
代理通过内部事件打开菜单，设置筛选、分组、度量、排序等参数；或动态调整当前视图。
4. 批量意图处理（AI 动作）
用户在列表视图选择多条记录后执行 AI 动作，代理根据提示词逐条处理并记录结果。
5. AI 字段自动填充的执行逻辑（包括普通 AI 字段和服务器动作 AI 更新）
普通 AI 字段：
定时任务批量填充空值字段。
即时填充：基于前端提交的变更集，调用 LLM 计算值并返回。
新建记录时立即触发定时任务。
服务器动作中的 AI 字段更新：
当服务器动作被触发时（定时、自动化规则、按钮点击），系统会获取当前上下文中的所有记录（可以是单条或多条）。
对于每条记录，系统提取提示词中引用的字段值（包括尚未保存的变更，如果通过前端调用），调用 LLM 计算出目标字段的值。
计算结果直接写入数据库（如果动作是通过前端触发的，会先暂存变更，待用户保存时提交）。
该动作可以与其他服务器动作组合（例如先 AI 计算，再发送邮件），形成一个完整的自动化流程。
6. 在线客服 AI 的会话处理逻辑
会话分配：当访客发起聊天时，系统根据当前 URL 匹配规则。如果规则指定了 AI 代理且该代理允许公共访问，则将会话分配给该 AI 代理。
AI 回复生成：访客发送消息后，后端调用 AI 代理方法。代理会检索知识源（若已配置）并生成回复，通过 WebSocket 或轮询发送给访客。
转接逻辑：
访客点击“Ask a Human”按钮后，前端调用路由。
后端检查当前规则中是否配置了脚本化聊天机器人。如果有，则将会话转给脚本机器人（机器人执行预设步骤后再转人工）。
如果没有脚本机器人，则尝试寻找可用的真人客服（根据渠道的在线状态和分配策略）。
转接成功时，AI 代理从频道成员中移除，新客服加入，并发送成功通知。
转接失败（无可用人工）时，返回失败消息，AI 代理继续留在频道中。
跨域支持：外部网站可以通过 CORS 路由调用生成回复、错误处理、关闭聊天等接口，实现完全的自定义前端。
7. AI 生成知识文章的逻辑
用户点击按钮后打开 AI 聊天，写作指令被发送给 AI 代理，代理生成 HTML 内容，前端替换编辑器内容并自动调整标题结构。
五、系统管理层：意图的追踪、审计与优化
1. API 密钥配置
管理员在系统设置中配置 OpenAI 或 Google 的 API 密钥。
2. 日志与审计
记录每次 AI 响应的模型、调用次数、工具调用、token 消耗、耗时等。
专门记录 AI 字段填充（包括普通字段和服务器动作）的成功率、失败原因；知识文章生成请求的上下文；在线客服会话的转接记录。
3. 自动清理
每天清理超过 1 天无活动的 AI 聊天频道（包括客服频道）。
定期清理孤立向量数据。
当文档或知识文章被删除时，自动删除关联的 AI 代理来源。
4. 系统内置代理与主题
模块安装时自动创建系统代理（如“自然语言查询代理”），不可删除。
5. AI 字段与服务器动作的维护
管理员可在“技术 → 模型”中修改普通 AI 字段的提示词，系统会自动重新计算空记录。
管理员可在“技术 → 服务器动作”中修改 AI 更新动作的提示词，下次动作触发时会使用新提示词。
如果提示词引用了被删除的字段，系统会在保存时给出警告。
六、完整意图驱动业务关系闭环（含所有扩展）
意图能力准备（管理员）
配置 API 密钥 → 创建代理（定义意图处理器） → 添加知识源（文件、文档、知识文章） → 创建话题与工具 → 配置场景规则（邮件编辑器、知识文章编辑器、在线客服规则） → 为文件夹配置文档分类提示词 → 为模型字段配置 AI 提示词（普通 AI 字段） → 创建服务器动作并配置 AI更新提示词（用于自动化流程）。
意图表达（用户/访客）
内部用户：通过聊天窗口、语音、内联提示框、字段按钮、文章生成按钮表达意图。
网站访客：点击客服按钮，在聊天窗口中输入问题（文字或语音）。
自动化系统：定时任务、自动化规则、按钮点击等触发服务器动作，表达“自动填充字段”的意图。
系统自动提供上下文（当前记录、视图状态、URL 等）。
意图解析与执行（AI 代理）
代理判断意图类型（问答、操作、填充字段、生成文章、客服回复）。
若需私有知识，检索 RAG（文件、文档、知识文章）。
调用工具执行业务操作，操作界面，填充字段值（通过普通 AI 字段或服务器动作），生成文章内容。
在客服场景中：生成简短、问答风格的回复；如果无法解答，引导用户转接人工。
将结果以对话形式反馈用户，或直接写入数据库（服务器动作）。
意图追踪与优化（管理员）
通过日志审计成本与准确率。
调整代理配置、工具描述、字段提示词、客服规则、服务器动作的提示词。
系统自动清理过期会话、孤立向量、被删除的知识源关联数据。
在线客服方面：根据 AI 未能解答的问题，补充知识源或优化提示词。
自动化流程方面：根据 AI 填充的准确性，调整服务器动作中的提示词。
七、总结：Odoo 19 AI 模块的完整价值
Odoo 19 企业版 AI 模块实现了从“用户操作界面”到“用户表达意图”的范式转变。它不仅是一个聊天机器人，更是一个意图驱动的企业级智能操作系统，整合了以下核心能力：
对话即操作：自然语言直接驱动界面和数据操作。
私有知识问答：RAG 让 AI 基于企业文档、网页、知识文章回答。
自动化任务：将任何服务器动作变为 AI 可调用的工具。
内容生成：在邮件、模板、文档、知识文章中动态插入或完全生成 AI 内容。
多模态输入：语音转录降低使用门槛。
智能文档分类：AI 自动将上传的文档归档到正确文件夹。
AI 字段自动填充：在模型字段级别和服务器动作级别，让 AI 根据上下文自动填写表单字段，减少手动数据录入，并支持复杂的自动化流程。
AI 生成知识文章：用户只需说出主题，AI 即可生成结构完整、内容专业的文章初稿。
AI 在线客服：将 AI 代理无缝集成到网站客服系统，自动回答访客问题，并在必要时转接人工客服，支持跨域部署。
用户（无论是内部员工还是网站访客）始终停留在“表达我要什么”的层面，而AI 负责“如何做到”。管理员则可以通过灵活的配置（代理、知识源、工具、字段、动作、客服规则）将 AI 能力嵌入到企业运营的每一个环节。这标志着企业软件从“以界面为中心”到“以意图为中心”的里程碑式演进。
