[TITLE]
Odoo AI 代理：结构、提示与创建完整指南
[DESCRIPTION]
本文详细介绍 Odoo 中 AI 代理的概念、核心结构（主题、工具、数据源）、系统提示编写要点，以及从创建到测试新代理的完整操作步骤，帮助用户快速上手并实现智能化业务流程。
[KEYWORDS]
Odoo,AI 代理,系统提示,主题,工具,数据源,创建,LLM 模型,响应风格,知识库
[TRANSLATED_CONTENT]
AI 代理
AI 代理是 Odoo 中的智能助理，能够理解自然语言、执行任务，并通过交互 Odoo 工具来协助用户。代理是 Odoo AI 架构的核心组成部分。每个代理都有明确的目的、提示词，以及一套主题和工具来指导其行为。
代理由两个主要组件组成：主题（Topics）和 来源（Sources）。
- 主题 是指示和角色，告诉代理需要完成哪些任务。工具 被分配给主题，是代理实际可以使用的功能。
- 来源 为代理提供完成任务所需的信息。
:::: important
::: title
重要
:::
虽然许多 AI 功能可以在未安装 AI 应用的情况下使用 Odoo，但创建和自定义代理必须先安装 AI 应用。
::::
Odoo 中的 AI 提示 {#ai/agents/prompts-in-odoo}
在使用 AI 代理之前，先了解一下 AI 提示的基本概念很重要。
AI 提示是一组书面指令或上下文，提供给 AI 模型，告诉它如何响应请求或扮演何种角色。提示可以定义：
- AI 模型的语气、风格和角色
- 模型可以执行的范围
- 请求期望的输出类型
在 Odoo 中，每个 AI 代理都分配有 系统提示（System Prompt），它定义了代理的整体角色、目的和行为，充当代理的核心使命声明，并驱动所有交互。
每个 主题 <ai/topics> 还包含其类似提示的组件——说明（Instructions）。说明是主题特定的指南，细化代理在特定上下文或工作流中的行为，以及它在 Odoo 框架中的交互方式。
说明通常包括：
- 目的或主题覆盖的内容
- 代理在分配该主题时必须遵守的规则或约束
- 完成特定操作的分步工作流
- 完成任何操作所需的技术细节
代理结构
主题 {#ai/topics}
主题 是一组说明和 工具 <ai/tools>，定义代理在特定上下文中的行为。简而言之，主题决定了代理在数据库中可以做什么、怎么做以及何时做。
:::: important
::: title
重要
:::
如果代理未分配任何主题，它只能提供信息，无法完成任务或对数据库进行更改。
::::
每个主题内部包含详细的提示，为代理提供更深入的任务执行指令，界定行为边界，并决定如何解释用户意图。这些提示确保代理遵循一致的推理模式，并使用适当的工具生成准确、上下文感知的响应。
AI 应用预配置的主题包括：
自然语言搜索（Natural Language Search）：解释用户查询并打开相应的 Odoo 视图，使用执行搜索所需的一套工具。信息检索（Information retrieval）：一组用于检索模型信息的工具。创建线索（Create Leads）：一组支持自动创建线索的工具。该主题仅在安装 CRM 应用后可用。
每个主题都有一组 说明（Instructions），充当提示并提供交互结构指引，同时配备一个或多个 AI 工具 <ai/tools>，指示代理可以执行的功能。
工具 {#ai/tools}
工具 是代理在 Odoo 中可以执行的函数，包括创建线索、打开视图等操作。工具将代理的用途从对话扩展到实际操作。数据库中可用的工具取决于已安装的应用。多个 AI 工具 可以分配给同一个主题。
数据源
数据源是代理在生成响应或完成任务时可以参考的数据。数据源会被索引，以便代理在用户提问时检索相关信息。
::: example
一个用于回答客户支持问题的代理，已将 知识库（Knowledge） 文章作为数据源，其中包含常见问题解答。
:::
数据源可以是以下格式：
- PDF 文件
- 网页链接
- 文档（在 文档（Documents） 应用中上传）
- 知识库（Knowledge） 应用的文章
:::: important
::: title
重要
:::
如果在代理上启用了 限制使用数据源（Restrict to Sources） 选项，代理只能使用已上传且处于激活状态的数据源中的信息。
::::
创建新代理
要创建一个新的 AI 代理，进入 AI 应用 --> 新建。输入 代理名称（Agent Name），如有需要可添加简短描述。
:::: tip
::: title
提示
:::
在创建新代理之前，建议先明确使用场景。这有助于编写 系统提示，以及分配 主题 和 AI 工具。
::::
从下拉菜单中选择一个 LLM 模型（LLM Model）。
:::: important
::: title
重要
:::
Odoo 支持多个版本的 ChatGPT 和 Gemini。
::::
接下来，选择 响应风格（Response Style），它决定代理在回复查询时的整体语气。可选项包括：
分析型（Analytical）：更偏数学化，倾向于对相同问题给出相同答案。适用于精确性比外交性更重要的场景。平衡型（Balanced）：兼具 分析型 与 创造型，适合需要兼顾准确性和外交性的外部客户场景。创造型（Creative）：以更人性化的方式处理问题，答案随对话变化。适用于解决方案随情境变化的情况。
勾选 限制使用数据源（Restrict to Sources） 复选框，以使代理只能基于提供的资源作答。
随后，为代理选择一个或多个 主题（Topics）。如前所述，主题包含说明和工具，引导代理帮助用户完成任务。
在 系统提示（System Prompt） 中输入针对代理角色和职责的详细指令。
:::: tip
::: title
提示
:::
系统提示 的具体程度和长度可根据代理的使用场景变化。可参考预配置代理获取示例信息。
::::
如果代理需要 数据源，切换到 数据源（Sources） 标签页，点击 添加数据源（Add a source）。
选择格式：
- PDF：在文件资源管理器中选择相应文件后点击
打开（Open）。- 网页链接：粘贴 URL。一次可添加多条链接，每行一个，随后点击
保存（Save）。- 文档（已在 文档（Documents） 应用中上传）：勾选一个或多个文档旁的复选框，然后点击
选择（Select）。- 知识库（Knowledge） 应用文章：勾选一个或多个文章旁的复选框，然后点击
选择（Select）。
数据源添加后，状态（Status） 字段会更新以反映当前状态。当状态从 处理中（Processing） 变为 已索引（Indexed） 时，即表示数据源已准备就绪。滑动 激活（Active） 开关以激活该数据源。
:::: important
::: title
重要
:::
如果数据源上传失败，可能是与所选 LLM 模型冲突导致。
::::
点击 测试（Test） 按钮打开对话窗口，测试新建的代理。
[SUMMARY]