Cấu hình Odoo AI
Thiết lập nhà cung cấp AI, tạo AI Agent theo vai trò và bổ sung nguồn kiến thức để triển khai AI đúng cách ngay từ đầu.
Trang này gộp toàn bộ phần cấu hình nền tảng của Odoo AI: API key nhà cung cấp, AI Agent, Topics, Default Prompts và nguồn kiến thức RAG.
Thiết lập đúng ngay từ đầu giúp tránh các lỗi phổ biến như Ask AI không phản hồi, agent trả lời thiếu ngữ cảnh hoặc nguồn tài liệu không được lập chỉ mục. Sau bước nền tảng này, bạn nên đọc tiếp AI Agent và nguồn tài liệu để đi sâu vào system prompt, topics và sources.
Bạn có thể bắt đầu với OpenAI hoặc Google Gemini, sau đó xây agent theo từng vai trò nghiệp vụ như bán hàng, chăm sóc khách hàng hoặc trợ lý nội bộ. Khi đã cấu hình xong, xem sử dụng AI hằng ngày để đưa AI vào vận hành thực tế.
Trước khi bắt đầu
Điểm chính
• Đảm bảo bạn có quyền quản trị viên hệ thống hoặc quyền chỉnh sửa cài đặt.
• Chọn nhà cung cấp phù hợp: OpenAI cho GPT-4o hoặc GPT-4.1 Mini; Google cho Gemini 2.5 Pro hoặc Gemini 2.5 Flash.
• Chuẩn bị API key hợp lệ và lưu trữ an toàn trước khi nhập vào Odoo.
• Xác định rõ các vai trò AI cần triển khai như Sales Assistant, Support Agent hoặc Internal Knowledge Assistant.
Cấu hình nhà cung cấp AI
Để sử dụng AI trong Odoo, hệ thống cần ít nhất một API key hợp lệ từ OpenAI hoặc Google Gemini. API key được nhập ở dạng mật khẩu và chỉ quản trị viên hệ thống mới có thể xem hoặc chỉnh sửa.
Các bước thực hiện
1. Vào Settings → General Settings.
2. Tìm phần AI hoặc Providers.
3. Bật Use your own ChatGPT account nếu dùng OpenAI, hoặc Use your own Google Gemini account nếu dùng Google.
4. Nhập API key tương ứng.
5. Nhấn Save để lưu cấu hình.
6. Kiểm tra lại một tính năng AI như Ask AI để xác nhận cấu hình hoạt động.
Trường cấu hình chính
| Trường dữ liệu | Mô tả |
|---|---|
| OpenAI API Key | Khóa xác thực để dùng các mô hình OpenAI như GPT-4o, GPT-4.1 và GPT-4.1 Mini. |
| Use your own ChatGPT account | Bật tùy chọn này khi muốn dùng tài khoản OpenAI riêng của doanh nghiệp. |
| Google API Key | Khóa xác thực để dùng các mô hình Gemini như Gemini 2.5 Pro hoặc Gemini 2.5 Flash. |
| Use your own Google Gemini account | Bật tùy chọn này khi muốn dùng tài khoản Google Gemini riêng. |
Cách lấy API key
Điểm chính
• OpenAI: vào platform.openai.com/api-keys, tạo secret key mới, sao chép ngay vì key chỉ hiển thị một lần.
• Google: vào console.cloud.google.com, bật Generative Language API, sau đó tạo API Key trong phần Credentials.
• Không chia sẻ API key qua email, chat hoặc lưu trực tiếp trong source code.
• Nên xoay vòng key định kỳ và thu hồi key cũ nếu nghi ngờ bị lộ.
Tạo AI Agent mới
AI Agent định nghĩa vai trò, giọng điệu, giới hạn kiến thức và mô hình AI dùng để trả lời. Mỗi agent nên phục vụ một mục tiêu nghiệp vụ rõ ràng để dễ kiểm soát chất lượng.
Các bước thực hiện
1. Vào AI → Agents → Agents.
2. Nhấn New để tạo agent mới.
3. Điền tên, mô tả ngắn và chọn mô hình LLM.
4. Chọn phong cách trả lời phù hợp.
5. Nhập System Prompt để xác định vai trò và hành vi.
6. Bật Restrict to Sources nếu muốn giới hạn câu trả lời theo tài liệu đã gắn.
7. Nhấn Save để lưu agent.
Các trường AI Agent chính
| Trường dữ liệu | Mô tả |
|---|---|
| Name | Tên hiển thị của agent, ví dụ Sales Assistant hoặc Support Agent. |
| Subtitle | Mô tả ngắn để người dùng hiểu nhanh agent dùng để làm gì. |
| System Prompt | Hướng dẫn cốt lõi định nghĩa vai trò, phạm vi và cách phản hồi của agent. |
| Response Style | Phong cách trả lời như Analytical, Balanced hoặc Creative. |
| LLM Model | Mô hình AI dùng để sinh phản hồi. |
| Restrict to Sources | Giới hạn câu trả lời chỉ dựa trên các nguồn kiến thức đã gắn cho agent. |
| Topics | Danh sách chủ đề bổ sung hướng dẫn và công cụ cho agent. |
Viết System Prompt hiệu quả
System Prompt nên ngắn gọn, rõ vai trò, nêu giới hạn và ưu tiên cách phản hồi. Tránh viết quá dài hoặc gom nhiều vai trò khác nhau vào cùng một agent.
Ví dụ: “Bạn là trợ lý bán hàng chuyên nghiệp. Hãy đề xuất sản phẩm phù hợp, giữ giọng điệu lịch sự, và nói rõ khi dữ liệu chưa đủ để kết luận.”
Kiểm thử AI Agent
Các bước thực hiện
1. Mở agent vừa tạo.
2. Nhấn Test để mở phiên chat thử nghiệm.
3. Đặt câu hỏi mẫu sát với tình huống thực tế.
4. Đánh giá độ chính xác, giọng điệu và tính hữu ích của câu trả lời.
5. Điều chỉnh System Prompt, Response Style hoặc nguồn kiến thức nếu cần.
Tạo Topics để tái sử dụng logic
Topics giúp gom hướng dẫn, bối cảnh nghiệp vụ và công cụ dùng chung để nhiều agent có thể tái sử dụng cùng một logic. Cách này giúp cấu hình nhất quán hơn khi hệ thống có nhiều agent.
Các bước thực hiện
1. Vào AI → Agents → Topics.
2. Nhấn New để tạo topic mới.
3. Điền Name, Description và Instructions.
4. Chọn Tools nếu topic cần cho phép agent dùng công cụ AI cụ thể.
5. Lưu topic rồi quay lại agent để gán topic vào trường Topics.
Các trường Topic chính
| Trường dữ liệu | Mô tả |
|---|---|
| Name | Tên chủ đề như Customer Service, Sales Support hoặc Internal Help. |
| Description | Tóm tắt ngắn gọn mục đích của chủ đề. |
| Instructions | Hướng dẫn chi tiết agent sẽ dùng khi áp dụng topic này. |
| Tools | Danh sách công cụ AI được phép dùng trong chủ đề đó. |
Thêm nguồn kiến thức RAG từ file hoặc URL
Nguồn kiến thức giúp AI Agent tham chiếu tài liệu nội bộ thay vì chỉ dựa vào kiến thức chung của mô hình. Bạn có thể dùng file hoặc URL công khai để hệ thống lập chỉ mục và truy xuất khi trả lời.
Các bước thực hiện
1. Mở AI Agent và chuyển sang tab Sources.
2. Nhấn Add a line để thêm nguồn mới.
3. Chọn Binary nếu muốn tải file lên hoặc URL nếu muốn lấy nội dung từ liên kết web.
4. Lưu để hệ thống bắt đầu indexing.
5. Theo dõi trạng thái nguồn và xử lý nếu có lỗi.
Trạng thái nguồn kiến thức
| Trường dữ liệu | Mô tả |
|---|---|
| Processing | Nguồn đang được xử lý và lập chỉ mục. |
| Indexed | Nguồn đã sẵn sàng để agent tham chiếu. |
| Failed | Nguồn lỗi và cần kiểm tra lại file, URL hoặc thực hiện Retry. |
| Retry / Reprocess | Tùy chọn thử lại hoặc lập chỉ mục lại nguồn khi cần. |
Định dạng nguồn thường dùng
| Trường dữ liệu | Mô tả |
|---|---|
| Phù hợp cho tài liệu quy trình, hướng dẫn và chính sách nội bộ. | |
| Hình ảnh | PNG, JPG, JPEG, WEBP hoặc GIF; hệ thống có thể trích xuất chữ từ ảnh. |
| Bảng tính | Excel, CSV hoặc ODS cho dữ liệu dạng bảng. |
| Văn bản | TXT hoặc Markdown; dễ xử lý và thường ổn định nhất. |
| URL | Dùng cho trang web công khai muốn đưa vào nguồn tri thức của agent. |
Quản lý nguồn kiến thức hiệu quả
Điểm chính
• Chỉ thêm tài liệu còn hiệu lực, liên quan trực tiếp đến vai trò của agent.
• Chia tài liệu dài thành nhiều phần có tiêu đề rõ ràng để AI truy xuất tốt hơn.
• Theo dõi trạng thái nguồn sau mỗi lần thêm mới hoặc cập nhật.
• Không đưa tài liệu nhạy cảm vào nguồn nếu chưa kiểm soát quyền truy cập.
Cấu hình Default Prompts
Default Prompts cho phép hệ thống tự gọi đúng agent theo từng ngữ cảnh như email, chat hoặc mô hình dữ liệu cụ thể. Đây là cách chuẩn hóa hành vi AI cho toàn tổ chức.
Các bước thực hiện
1. Vào AI → Configuration → Default Prompts.
2. Tạo rule mới.
3. Chọn ngữ cảnh kích hoạt như mail composer hoặc model cụ thể.
4. Chọn agent sẽ được gọi.
5. Nhập Default Prompt bổ sung và các nút gợi ý nhanh nếu cần.
6. Lưu rule và thử lại trong giao diện thực tế.
Lỗi thiết lập thường gặp
Điểm chính
• API key không hợp lệ: kiểm tra key có bị thu hồi, hết hạn hoặc sao chép thiếu ký tự không.
• API không phản hồi: kiểm tra tài khoản nhà cung cấp có credits hoặc đã bật API cần thiết chưa.
• Agent trả lời quá chung chung: cần viết lại System Prompt rõ hơn hoặc bổ sung nguồn kiến thức phù hợp.
• Nguồn không được lập chỉ mục: kiểm tra định dạng file, dung lượng hoặc URL có thể truy cập công khai hay không.
• Không thấy menu cấu hình AI: tài khoản hiện tại có thể chưa có quyền quản trị hệ thống.