I. 概述
阿里雲百煉（通義千問）AI 整合模組是 Odoo ERP 的智慧擴充元件，將阿里雲通義千問大型語言模型無縫整合至 Odoo 業務流程中，提供智慧對話、知識問答、內容生成與業務自動化能力，協助企業實現數位轉型。
核心優勢：
- 技術領導力：通義千問將中文語意理解的準確率提升了 30%，專注於在地化場景。
- 可靠效能：運用阿里雲的全球架構，提供毫秒級回應與 99.95% 的服務可用性。
- 成本優勢：按使用量計費，成本比同類國際服務低 50%-60%。
- 安全合規：完全於境內處理，符合法律法規，資料通訊加密。
2. 架構與模型
2.1 技術架構
此模組採用分層架構：
- 介面層：相容於 OpenAI 標準，並適配 DashScope API。
- AI 引擎層：支援多輪對話、上下文維護、函式呼叫與串流輸出。
- 知識增強層（RAG）：將文字向量化（1536 維），實作基於 pgvector 的語意檢索。
- 業務整合層：連接 CRM、銷售、財務和人力資源等模組，讓 AI 能直接執行查詢或建立記錄。
2.2 模型矩陣
| 模型系列 | 功能與情境 |
|---|---|
| Qwen Max | 高精度推理與專業 Q&A |
| Qwen Plus | 效能均衡，適合辦公與客服使用（推薦） |
| Qwen Turbo | 快速回應、高併發場景 |
| Qwen Long | 長文件處理 |
| QwQ-32B | 邏輯推理與決策分析 |
| Qwen 數學 | 財務計算與分析 |
| Qwen Coder | 程式設計與技術支援 |
3. 核心功能
3.1 智慧對話
- 支援超過 50 輪的連續對話，能理解上下文與指涉。
- 可自訂的角色（客戶服務、銷售顧問、技術專家等）。
-
三種回應模式：
- 分析型 (0.2) 精確
- 平衡 (0.5) 一般
- 創意 (0.8) 靈活
- 支援即時串流輸出（SSE）。
3.2 知識增強問答 (RAG)
- 支援多種格式文件（PDF、Office、TXT、網頁等）的自動索引。
- 向量化儲存 + 語意檢索（餘弦相似度 >90%）。
- 管理知識來源：上傳檔案、新增網址、附加檔案、批次匯入。
- 支援啟用/停用、重新索引、引用註釋及其他操作。
3.3 工具呼叫（函式呼叫）
- 賦予 AI 執行業務操作的能力（例如建立訂單、寄送電子郵件、查詢 CRM）。
- 可自訂工具（JSON Schema + Python 邏輯 + 權限控制）。
- 參數驗證與安全控制已完成。
3.4 內容生成
- 自動產生提案、合約、報告、會議紀錄、行銷文案等。
- 支援電子郵件智慧回覆與多語言翻譯。
- 自動摘要、關鍵字擷取、資訊擷取，以及表格生成。
4. 典型情境
- 智慧客服：qwen-plus-latest 模型、FAQ 文件知識庫 + 工具（訂單查詢、售後等）。自動解決率達到 70%。
- 銷售助理：qwen-max-latest 模型，分析客戶需求，產生解決方案與報價，將轉換率提升 30%。
- 知識管理：qwen-long 模型可建置企業知識庫，將資訊檢索時間縮短至 30 秒。
- 財務分析：qwen-math-plus 模型會自動分析報告與預算，提供優化建議。
- 人力資源：智慧履歷篩選、員工諮詢、訓練內容生成。
- 技術支援：故障診斷與代碼協助，整合工單與裝置查詢。
5. 安裝與設定
5.1 系統需求
- Odoo：19.0+（取決於 ai、ai_app 模組）
- PostgreSQL：12.0+（已啟用 pgvector）
- Python：3.10+
- 網路必須能夠存取 https://dashscope.aliyuncs.com
5.2 部署步驟
- 安裝 pgvector 擴充功能。
- 安裝相依性函式庫：pip install pdfminer.six python-docx openpyxl
- 將模組放入 Odoo 附加元件中並安裝。
- 在「設定 → AI → 供應商」中設定 API Key（從百煉控制台取得）。
- 測試連線並檢視可用的模型。
5.3 建立 AI 代理
- 路徑：應用程式 → AI → 代理程式 → 建立
- 填寫名稱、描述，選擇模型與回應模式。
- 設定系統提示詞（定義角色與行為準則）。
- 新增知識來源（檔案/URL/附件）。
- 設定工具與權限。
- 測試回應效果與工具呼叫。
範例角色：
- 客服助理：親切且專業，回答產品與訂單相關問題。
- 銷售顧問：根據需求推薦解決方案，重點在於信任與價值。
- 技術專家：邏輯清晰，提供技術解決方案和範例。
6. 帳單與費用
計費公式：
成本 = (輸入 Token 數 × 單價) + (輸出 Token 數 × 單價)
| 模型 | 輸入價格（人民幣/千 Token） | 輸出價格 | 場景 |
|---|---|---|---|
| qwen-turbo | 0.0003 | 0.0006 | 快速回應 |
| qwen-plus | 0.0004 | 0.0012 | 日常辦公室工作 |
| qwen-max | 0.012 | 0.012 | 專業分析 |
| qwen-long | 0.0005 | 0.002 | 長篇文件 |
| qwen-math-plus | 0.004 | 0.012 | 財務分析 |
| qwen-coder-plus | 0.004 | 0.012 | 程式碼輔助 |
範例：
客服系統平均每天處理 1,000 次對話，平均輸入 100 個 token、輸出 200 個 token，每天成本約 0.28 元。
最佳化建議：
- 任務層級選擇模型（Turbo→Plus→Max）。
- 簡化提示詞與上下文。
- 限制輸出長度。
- 常見的快取問題。
- 設定預算與警示。
7. 技術支援
資源：
-
快速入門、功能手冊、API 參考、影片教學、常見問題
支援管道： - Odoo 中文社群、阿里雲開發者社群
-
電子郵件：info@zodioo.com(工作日 9:00–18:00)
企業支援： 提供客製化開發與導入指導。
常見問題：
- API 連線失敗 → 檢查金鑰、網路、防火牆。
- 文件索引失敗 → 請檢查格式、相依性函式庫與檔案大小。
- 向量檢索沒有結果 → 請確認索引狀態與相關性。
- 回應緩慢 → 最佳化模型或網路。
- 工具呼叫失敗 → 請檢查權限與參數。
8. 安全與合規
- 傳輸加密：TLS 1.3 全程加密。
- 儲存安全: API 金鑰 AES-256 加密
- 存取控制：根據 Odoo 權限系統。
- 稽核記錄：記錄 AI 呼叫與操作。
- 隱私保護：支援資料本地化與去識別化。
- 合規：遵守《網路安全法》、《資料安全法》及《個人資訊保護法》。
- 最佳實務：最小權限、定期備份、安全訓練，以及監控警示。
IX. 附錄
快速詞彙表：
LLM（大型語言模型） | RAG（檢索增強生成） | 嵌入（向量嵌入） | 符元 | 溫度（輸出隨機性） | 系統提示詞 | 函式呼叫
模型快速參考：
- 客戶服務 → qwen-plus
- 分析 → qwen-max
- 並行 → qwen-turbo
- 長文件 → qwen-long
- 財務 → qwen-math-plus
- 程式設計 → qwen-coder-plus
關鍵路徑：
- API 金鑰：設定 → AI → 提供者
- 建立代理：AI → 代理
- 知識來源：代理 → 知識來源標籤
- 工具設定：Agent → 工具索引標籤
