AI 助手

AI 助手是 Odoo 中的智能助理,能够理解自然语言、执行任务并通过与 Odoo 工具交互来协助用户。助手是 Odoo 中 AI 结构的核心组成部分。每个助手都有明确的目的、提示词,以及一组指导其行为的主题和工具。

助手由两个主要部分组成:主题*和*来源

  • *主题*是告知助手需要完成哪些任务的指令和角色。*工具*被分配给主题,是助手可以用来执行任务的实际功能。

  • *来源*为助手提供完成任务所需的信息。

重要

虽然许多 AI 功能可以在不安装**AI**应用的情况下于 Odoo 中使用,但创建和自定义助手则需要安装**AI**应用。

Odoo 中的 AI 提示

在处理 AI 助手之前,了解一些关于 AI 提示的基本概念非常重要。

AI 提示是一组提供给 AI 模型的书面指令或上下文,用于告知它如何响应请求或扮演什么角色。提示可以定义:

  • AI 模型的语气、风格和角色设定

  • 模型能够执行的操作范围

  • 请求期望的输出类型

在 Odoo 中,每个 AI 助手都被分配了一个 系统提示,它定义了助手的整体角色、目的和行为。它充当了助手的核心使命宣言,并驱动所有交互。

每个 主题 <ai/topics>`也包含其自身类似提示的组成部分,称为 :guilabel:`指令。指令是特定于主题的指导原则,用于细化助手在特定上下文或工作流中的行为方式,以及它在 Odoo 框架内的交互方式。

指令通常包括:

  • 一个目的,或说明该主题涵盖的内容

  • 助手在被分配此主题时需要遵循的规则或约束

  • Step-by-step workflows for how to complete a specific action

  • 完成任何操作所需的技术细节

助手结构

主题

Topics are a collection of instructions and tools that define how an agent behaves within a specific context. Essentially, the topics define what an agent can do within the database. Topics guide conversations, telling the agent what it can do, how it can do it, and when it should do it.

重要

如果助手未被分配任何主题,它只能提供信息,而无法完成任务或对数据库进行更改。

Within each topic includes a detailed prompt, which provides the agent with more in-depth instructions on how to perform the tasks associated with that topic, define the boundaries of its behavior, and determine how it should interpret user intent. These prompts ensure that the agent follows a consistent reasoning pattern and uses the appropriate tools to generate accurate, context-aware responses.

AI 应用中预配置了以下主题:

  • 自然语言搜索:支持解释用户查询,以使用执行搜索所需的一套工具来打开相应的 Odoo 视图。

  • 信息检索:一套用于检索模型信息的工具集合。

  • 创建潜在客户:一套支持自动化潜在客户创建的工具集合。此主题**仅**在安装了**CRM**应用时可用。

每个主题内部都包含一套 指令,它们充当提示并为交互结构提供指导,以及一个或多个 AI 工具,这些工具指明了助手可以执行的功能。

工具

工具 是助手在 Odoo 中可以执行的功能。这包括诸如创建潜在客户或打开视图等操作。工具将助手的目的扩展到对话之外,使其能够执行实际动作。数据库中可用的工具根据已安装的应用而异。可以将多个 AI 工具 分配给单个主题。

来源

来源是助手在生成响应或完成任务时可以引用的数据。来源会被建立索引,以便当用户提问时,助手能够检索到相关信息。

Example

一个旨在回答客户支持问题的助手,其来源中包含了**知识库**文章,这些文章包含常见问题解答。

来源可以采用以下格式:

  • PDF

  • 网站链接

  • 文件(上传到**文件管理**应用程序中)

  • **知识库**应用文章

重要

如果在助手上启用了 限制使用来源 选项,则该助手只能利用已上传且处于活动状态的来源中的信息。

创建新助手

要创建新的 AI 助手,请导航至 AI 应用 ‣ 新建。输入 助手名称,然后根据需要添加简短描述。

小技巧

在创建新助手之前,建议先明确其使用场景。这有助于编写 系统提示,以及分配 主题AI 工具

从下拉菜单中选择一个 LLM 模型

重要

Odoo 支持多个版本的 ChatGPT 和 Gemini。

接下来,选择一个 响应风格。这用于管理助手在回应询问时的整体语气。从以下选项中选择:

  • 分析型:更具数学逻辑性,此选项更有可能对相同的问题给出相同的答案。建议在准确性比圆融性更重要的场景下使用此选项。

  • 平衡型分析型创意型 的混合。对于外部客户而言,这是一个极好的选择,因为他们能同时受益于准确性和圆融性。

  • 创意型:以更人性化的方式处理问题,每次都会根据对话变化答案。此选项最适用于解决方案通常因情况而异的场景。

勾选 限制使用来源 复选框,以将助手限制为**仅**能基于提供的资源进行回应。

接下来,为助手选择一个或多个 主题。如上所述,主题 包含指导助手帮助用户完成任务所需的指令和工具。

输入 系统提示,其中包含关于助手角色和职责的详细说明。

小技巧

系统提示 的具体程度和长度可以有所不同,这取决于助手的使用场景。可以参考预配置的助手作为可能包含信息的示例。

包含所需信息的新建助手表单。

如果助手需要*来源*,请滚动到 来源 选项卡,然后点击 添加来源

选择格式:

  • PDF 文件:从文件浏览器窗口中选择相应文件,然后点击 打开

  • 网页链接:粘贴 URL。可以一次性添加多个链接,每行粘贴一个链接。点击 保存

  • 文档(在**文件管理**应用中上传的文件):勾选一个或多个文档旁边的复选框,然后点击 选择

  • 知识库 应用文章:勾选一篇或多篇文章旁边的复选框,然后点击 选择

添加来源后,状态 字段会更新以反映其当前状态。当状态从处理中变为已索引时,来源即准备就绪。滑动 启用 开关以激活该来源。

助手的来源列表,每个来源都标明了其格式。

重要

如果来源上传失败,可能是与所选 LLM 模型冲突导致的。

点击 测试 按钮打开对话窗口,测试新助手。