Odoo 18 集成AI功能详细讲解

一个功能强大、高度集成的 Odoo 18 AI 对话界面模块。它提供了一个现代化的、支持流式输出和 Markdown 渲染的聊天机器人界面，可以轻松连接到任何兼容 OpenAI SDK 的外部 AI 服务，如 DeepSeek, Dify, n8n 等。

✨ 核心功能

• 实时流式输出：AI 的回复以“打字机”效果实时显示，显著提升用户交互体验。
• Markdown 渲染：安全地将 AI 回复中的 Markdown 格式（如标题、列表、代码块、粗体等）渲染成美观、排版精良的样式。
• 通用 AI API 集成：使用官方 openai Python 库，可配置连接到任何兼容 OpenAI API 格式的外部服务。
• 完整的对话管理：用户可以在一个界面中创建新对话、查看并切换历史对话，对话标题可自动生成，所有记录都将永久保存在 Odoo 数据库中。
• 现代化的前端：界面完全使用 Odoo 18 最新的 OWL 2 (Odoo Web Library) 框架构建，响应迅速，体验流畅。
• 友好的用户体验：内置了优雅的加载指示器和清晰的错误/成功通知，让应用在各种状态下都能提供明确反馈。
• 灵活的提供商配置：管理员可以在 Odoo 后台轻松配置和管理多个 AI 服务提供商的凭据、Base URL 和模型名称。

🛠️ 安装

1. 将 ai_chat_interface 文件夹放置到你的 Odoo addons 目录下。
2. 安装 Python 依赖库。此模块需要 openai 库来调用外部 API。在你的 Odoo 环境中运行：

pip install openai

1. 以开发者模式登录 Odoo，导航至 应用 (Apps) 菜单。
2. 点击 更新应用列表 (Update Apps List)。
3. 搜索 AI Chat Interface 并点击 安装 (Install)。

⚙️ 配置

安装成功后，你需要配置至少一个 AI 服务提供商才能开始聊天。

1. 导航至新创建的 AI Chat 应用。
2. 进入菜单 Configuration -> AI Providers。
3. 点击 创建 (Create)。
4. 填写表单：
   • Configuration Name: 为此配置起一个易于识别的名字 (例如, "DeepSeek API")。
   • Provider Type: 选择 Dify 或 n8n (此字段仅用于标识)。
   • API URL: 你的 AI 服务的 Base URL。
     • 对于 DeepSeek: https://api.deepseek.com
     • 对于 Dify: https://api.dify.ai/v1
   • API Key: 用于认证的密钥 (Secret Key)。
   • AI Model Name: (必填) 你的 AI 服务需要使用的模型名称 (例如, deepseek-chat)。
   • 勾选 Active 复选框。
5. 点击 保存 (Save)。

🚀 使用方法

1. 导航至 AI Chat 应用的主菜单 Chat Room。
2. 在左侧的侧边栏，点击 New Chat 按钮以开始一个新的对话。
3. 或者，从列表中选择一个已经存在的历史对话来继续。
4. 在右下角的输入框中输入你的问题，然后点击发送或按 Enter 键。
5. 享受与 AI 的实时对话吧！

ቴክ 技术栈

• Backend: Odoo 18, Python 3.10+
• Frontend: Odoo Web Library (OWL) 2
• Database: PostgreSQL
• Python Libraries: openai
• JavaScript Libraries: marked, dompurify

👨‍💻 作者

• 源力祁老师，联系老师免费获取

📄 许可证

本项目基于 LGPL-3 许可证发布。