Mẹo sử dụng và khắc phục sự cố
Tối ưu prompt, chọn mô hình phù hợp và xử lý các lỗi người dùng gặp nhiều nhất khi dùng Odoo AI.
AI hoạt động tốt nhất khi agent có phạm vi rõ ràng, prompt ngắn gọn và dữ liệu nguồn được giữ gọn, cập nhật. Module AI cung cấp Ask AI, chat với agent, soạn email AI, phiên âm giọng nói và tìm kiếm ngữ nghĩa (RAG).
Khi có lỗi, nên kiểm tra thứ tự từ cấu hình API, trạng thái nguồn, kết nối mạng đến quyền truy cập người dùng. Hầu hết lỗi liên quan đến API key sai, file không hỗ trợ hoặc quyền hạn chưa đủ. Nếu cần đối chiếu quy trình chuẩn, xem lại cấu hình Odoo AI, AI Agent và nguồn tài liệu và AI Knowledge.
Mẹo viết System Prompt hiệu quả
System prompt là hướng dẫn quan trọng nhất để định nghĩa vai trò và hành vi của agent. Prompt tốt giúp agent trả lời chính xác, nhất quán và phù hợp với nghiệp vụ.
Điểm chính
• Rõ ràng: Nêu rõ vai trò của agent (ví dụ: "Bạn là trợ lý bán hàng chuyên nghiệp").
• Cụ thể: Cho ví dụ về cách trả lời mong muốn để agent hiểu rõ kỳ vọng.
• Ngắn gọn: Không quá dài, tập trung vào điểm chính, tránh thông tin dư thừa.
• Ví dụ tốt: "Bạn là trợ lý bán hàng. Giúp khách hàng tìm sản phẩm. Luôn lịch sự và chuyên nghiệp. Nếu không biết, hãy nói rõ ràng."
• Ví dụ cho Customer Support: "Bạn là chuyên viên chăm sóc khách hàng. Trả lời lịch sự, thấu hiểu, và cung cấp giải pháp cụ thể."
Chọn mô hình LLM phù hợp
Mỗi mô hình LLM có điểm mạnh riêng về tốc độ, chất lượng và chi phí. Chọn mô hình phù hợp với nhu cầu nghiệp vụ để tối ưu hiệu suất và chi phí.
So sánh mô hình LLM
| Mô hình | Tốc độ | Chất lượng | Dùng cho | Ghi chú |
|---|---|---|---|---|
| GPT-4.1 Mini | Nhanh | Tốt | Câu hỏi đơn giản, tìm kiếm nhanh | Chi phí thấp, phù hợp cho khối lượng lớn |
| GPT-4o | Trung bình | Rất tốt | Hầu hết trường hợp nghiệp vụ | Cân bằng tốt giữa chất lượng và tốc độ |
| GPT-4.1 | Chậm | Xuất sắc | Phân tích phức tạp, quyết định quan trọng | Chi phí cao, dùng khi cần chất lượng tối đa |
| Gemini 2.5 Flash | Rất nhanh | Tốt | Tìm kiếm nhanh, phản hồi tức thì | Tốc độ cao, phù hợp cho chat real-time |
| Gemini 2.5 Pro | Trung bình | Rất tốt | Phân tích dữ liệu, báo cáo | Xử lý tốt dữ liệu lớn và đa phương tiện |
Khi nào dùng RAG (Retrieval-Augmented Generation)
RAG cho phép agent tham khảo tài liệu nội bộ khi trả lời. Không phải lúc nào cũng cần RAG, chỉ dùng khi có tài liệu riêng cần tham chiếu.
Điểm chính
• Dùng RAG khi: Có tài liệu nội bộ (hướng dẫn, chính sách, quy trình), cần trích dẫn nguồn, thông tin thay đổi thường xuyên.
• Không dùng RAG khi: Chỉ cần dữ liệu Odoo (đơn hàng, khách hàng, sản phẩm), câu hỏi chung không cần tài liệu cụ thể.
• Tối ưu tài liệu RAG: Chia nhỏ tài liệu dài thành phần (mỗi phần 1-2 trang), dùng tiêu đề rõ ràng, cập nhật thường xuyên.
• Định dạng tốt nhất: PDF (tối đa 5 trang), Markdown (dễ xử lý), TXT (đơn giản nhất).
• Tránh: File quá lớn (>10MB), định dạng phức tạp, tài liệu lỗi thời.
Thiết kế Agent hiệu quả
Điểm chính
• Đặt Name rõ nghiệp vụ (ví dụ: "Sales Coach", "Support Assistant", "HR Helper") để người dùng dễ nhận diện.
• Viết Subtitle ngắn (1 câu) để người dùng hiểu nhanh công dụng mà không cần mở chi tiết.
• Gắn Topic đúng chuyên môn, tránh 1 agent làm mọi thứ. Mỗi agent nên có phạm vi rõ ràng (ví dụ: chỉ bán hàng, chỉ CSKH).
• Dùng Default Prompts để chuẩn hóa giọng điệu và tạo Buttons cho câu lệnh thường dùng (ví dụ: "Viết email cảm ơn").
• Thử nghiệm bằng nút Test trước khi triển khai rộng để đảm bảo chất lượng phản hồi.
• Theo dõi trạng thái Sources thường xuyên, xử lý Failed ngay để agent luôn có nguồn kiến thức đầy đủ.
Quản lý Sources (Nguồn kiến thức) thông minh
Điểm chính
• Chỉ thêm tài liệu chất lượng, cập nhật và liên quan trực tiếp đến vai trò của agent.
• Theo dõi trạng thái nguồn: Processing (đang xử lý), Indexed (sẵn sàng), Failed (lỗi).
• Nếu nguồn thất bại, dùng Retry trước khi xóa. Kiểm tra định dạng file hoặc URL có hợp lệ không.
• Dùng Reprocess để lập chỉ mục lại nguồn URL đã thành công (ví dụ: khi nội dung web thay đổi).
• Chia tài liệu dài thành phần nhỏ với tiêu đề rõ ràng để agent dễ tìm kiếm và trích dẫn.
• Không thêm tài liệu nhạy cảm (mật khẩu, thông tin cá nhân, tài chính) vào nguồn kiến thức.
Chuẩn hóa Prompt với Default Prompts
Default Prompts giúp chuẩn hóa cách agent được gọi theo ngữ cảnh. Ví dụ: khi soạn email cho khách hàng, tự động gọi agent phù hợp với prompt mặc định.
Điểm chính
• Dùng Default Prompts để chuẩn hóa giọng điệu (lịch sự, chuyên nghiệp, ngắn gọn).
• Tạo Buttons cho câu lệnh thường dùng để tiết kiệm thời gian (ví dụ: "Viết email theo dõi", "Viết email xin lỗi").
• Tách rule theo model để tránh prompt quá tổng quát (ví dụ: rule riêng cho res.partner, sale.order).
• Chỉ admin hệ thống mới có quyền cấu hình Default Prompts.
Bảo mật thông tin khi dùng AI
Điểm chính
• API key được nhập dạng mật khẩu (ẩn ký tự), chỉ admin hệ thống mới xem/chỉnh sửa được.
• Không chia sẻ API key qua chat/email nội bộ, Slack hoặc công cụ không mã hóa.
• Rà soát key định kỳ (3-6 tháng) và xoay vòng khi cần để bảo mật.
• Chỉ thêm tài liệu công khai vào RAG, không thêm thông tin nhạy cảm (mật khẩu, CMND, tài chính).
• Kiểm tra quyền truy cập: Ask AI chỉ truy cập dữ liệu mà người dùng hiện tại có quyền xem.
• Dữ liệu có thể được gửi tới OpenAI hoặc Google để xử lý, vì vậy cần xem chính sách bảo mật của nhà cung cấp.
• Quản trị viên có thể tắt AI trong Settings khi không muốn sử dụng hoặc cần bảo trì.
Lỗi thường gặp và cách khắc phục
Lỗi API và cấu hình
| Lỗi | Nguyên nhân phổ biến | Cách khắc phục | Ghi chú |
|---|---|---|---|
| API key không hợp lệ | Key sai, hết hạn hoặc chưa nhập | Tạo key mới từ OpenAI/Google, cập nhật trong Settings → AI → Providers, lưu và thử lại | Kiểm tra key có đúng provider không (OpenAI vs Google) |
| Không gọi được OpenAI/Gemini | API key sai, chưa bật provider hoặc hết quota | Vào Settings → Providers, kiểm tra key và bật đúng provider, kiểm tra quota còn lại | Liên hệ nhà cung cấp nếu hết quota |
| Không thấy menu AI | Chưa cài module ai_app hoặc không có quyền | Kiểm tra module đã cài, kiểm tra quyền user (phải là người dùng nội bộ), tải lại giao diện | Liên hệ admin nếu vẫn không thấy |
| Không thấy Settings/Default Prompts | Không phải admin hệ thống | Đăng nhập bằng tài khoản có quyền base.group_system | Chỉ admin mới thấy menu này |
Lỗi nguồn kiến thức (RAG)
| Lỗi | Nguyên nhân phổ biến | Cách khắc phục | Ghi chú |
|---|---|---|---|
| Nguồn lập chỉ mục thất bại | File không hỗ trợ, quá lớn (>10MB) hoặc bị lỗi | Kiểm tra định dạng (PDF, PNG, Excel, TXT), thử file khác, nhấn Retry, xem chi tiết lỗi | Chia file lớn thành phần nhỏ hơn |
| Nguồn Processing quá lâu | File lớn hoặc hệ thống đang xử lý nhiều nguồn | Chờ vài phút, kiểm tra lại trạng thái, nếu quá 10 phút thì Retry | File PDF >5 trang có thể mất lâu |
| Agent không dùng nguồn kiến thức | Nguồn chưa Indexed hoặc Restrict to Sources chưa bật | Kiểm tra trạng thái nguồn (phải là Indexed), bật Restrict to Sources nếu muốn bắt buộc | Agent có thể dùng kiến thức chung nếu không bật Restrict |
| URL source lỗi | URL không truy cập được, cần đăng nhập hoặc bị chặn | Kiểm tra URL có mở được trong trình duyệt không, thử URL khác, dùng Binary thay vì URL | Chỉ hỗ trợ URL công khai |
Lỗi sử dụng tính năng
| Lỗi | Nguyên nhân phổ biến | Cách khắc phục | Ghi chú |
|---|---|---|---|
| Ask AI không hoạt động | Thiếu API key, lỗi kết nối hoặc không có quyền | Kiểm tra API key đã cấu hình, kiểm tra kết nối internet, thử lại sau vài phút, liên hệ admin | Có thể do quota hết hoặc service down |
| Email AI không hiển thị | Chưa cấu hình AI Composer hoặc không có Default Prompts | Kiểm tra cài đặt AI Composer, tạo Default Prompts cho mail composer, liên hệ admin | Cần cấu hình Default Prompts trước |
| Agent trả lời kém chất lượng | Prompt chưa rõ, topic chưa đúng, source chưa xử lý xong hoặc lỗi | Cải thiện system prompt (rõ ràng, ngắn gọn), gắn lại topic phù hợp, kiểm tra tab Sources và xử lý Failed, dùng nút Test để thử nghiệm | Thử đổi mô hình LLM nếu vẫn kém |
| Chat AI không phản hồi | Lỗi kết nối, API key sai hoặc agent chưa cấu hình đúng | Kiểm tra kết nối, kiểm tra API key, kiểm tra agent có System Prompt và LLM Model chưa | Xem log để biết chi tiết lỗi |
| Phiên âm giọng nói lỗi | File âm thanh không hỗ trợ hoặc quá lớn | Dùng định dạng MP3, WAV, M4A, giảm kích thước file nếu quá lớn | Tối đa 25MB cho file âm thanh |
Mẹo sử dụng Ask AI hiệu quả
Ask AI cho phép đặt câu hỏi bằng ngôn ngữ tự nhiên để tìm dữ liệu Odoo. AI hiểu ý của bạn, tìm dữ liệu phù hợp và mở view (danh sách, biểu đồ, pivot).
Điểm chính
• Cụ thể: "Hiển thị hoá đơn chưa thanh toán" thay vì "Hoá đơn".
• Rõ ràng: "Danh sách khách hàng từ Hà Nội" thay vì "Khách hàng".
• Có ngữ cảnh: "Tổng doanh số tháng này" thay vì "Doanh số".
• Ví dụ câu hỏi tốt: "Mở đơn hàng của công ty ABC", "Sản phẩm bán chạy nhất tháng 3", "Hoá đơn quá hạn thanh toán".
• AI có thể mở danh sách, biểu đồ, pivot hoặc áp dụng bộ lọc tự động.
Mẹo soạn email với AI
Điểm chính
• Cụ thể: "Viết email xin lỗi vì giao hàng trễ" thay vì "Viết email".
• Rõ ràng: "Viết email theo dõi đơn hàng #12345" thay vì "Theo dõi đơn hàng".
• Chuyên nghiệp: "Viết email chính thức cho khách hàng mới" để có giọng điệu phù hợp.
• Chỉnh sửa: Dùng "Viết lại chuyên nghiệp hơn", "Viết ngắn gọn hơn", "Thêm chi tiết", "Sửa lỗi chính tả".
• Luôn kiểm tra lại nội dung trước khi gửi để đảm bảo chính xác.
Quản trị vận hành AI
Điểm chính
• Phân quyền rõ: user dùng Agent, admin quản lý Settings/Prompts, chỉ admin hệ thống thấy Configuration.
• Thử nghiệm bằng nút Test trước khi triển khai rộng để đảm bảo agent hoạt động tốt.
• Rà soát key định kỳ (3-6 tháng) và xoay vòng khi cần để bảo mật.
• Theo dõi usage và quota của API để tránh hết hạn mức giữa chừng.
• Tạo agent riêng cho từng bộ phận (Sales, Support, HR) thay vì dùng chung 1 agent.
• Cập nhật tài liệu RAG thường xuyên để agent luôn có thông tin mới nhất.
Câu hỏi thường gặp (FAQ)
Điểm chính
• Q: Ask AI có thể truy cập dữ liệu nào? A: Ask AI có thể truy cập tất cả dữ liệu mà người dùng hiện tại có quyền xem (theo quyền Odoo).
• Q: Dữ liệu có được gửi đến OpenAI/Google không? A: Có, để xử lý. Kiểm tra chính sách bảo mật của họ và không gửi thông tin nhạy cảm.
• Q: Có thể tắt AI không? A: Có, quản trị viên có thể tắt trong Settings hoặc không cấu hình API key.
• Q: Có giới hạn số lần sử dụng không? A: Tùy thuộc vào gói API của bạn (quota từ OpenAI/Google).
• Q: Agent có thể thực hiện hành động không? A: Có, nếu được cấu hình Tools (ví dụ: tạo đơn hàng, gửi email).
• Q: RAG có hỗ trợ tiếng Việt không? A: Có, hỗ trợ đầy đủ tiếng Việt và nhiều ngôn ngữ khác.
• Q: Làm sao biết agent đang dùng nguồn nào? A: Agent sẽ trích dẫn nguồn trong phản hồi nếu bật Restrict to Sources.
• Q: Có thể dùng nhiều API key không? A: Không, chỉ cấu hình 1 key cho OpenAI và 1 key cho Google.
Tài liệu tham khảo
Điểm chính
• Module AI: ~/odoo/addons/ai/ (core AI, embeddings, LLM service)
• Module AI App: ~/odoo/addons/ai_app/ (giao diện quản lý agents, topics, default prompts)
• Bản dịch tiếng Việt: ~/odoo/addons/ai/i18n/vi.po và ~/odoo/addons/ai_app/i18n/vi.po
• Agent guide (kỹ thuật): ~/agent_guide/ai.md và ~/agent_guide/ai_app.md
• Module liên quan: attachment_indexation (lập chỉ mục file), mail (email AI), discuss (chat)