Hành động máy chủ AI¶
AI hành động máy chủ mở rộng khung tự động hoá của Odoo bằng cách cho phép trí tuệ nhân tạo đưa ra quyết định trong quy trình làm việc.
Chúng được thiết kế cho các trường hợp mà logic không thể được biểu đạt hoàn toàn bằng các điều kiện cố định, nhưng vẫn cần thực hiện có kiểm soát thông qua các hành động máy chủ tiêu chuẩn.
Cách hoạt động của hành động máy chủ AI¶
Các quy trình làm việc dựa trên AI trong Odoo được xây dựng dựa trên việc phân tách rõ ràng trách nhiệm giữa hành động máy chủ AI, hoặc the Manager, và công cụ, hoặc the Worker
Hành động máy chủ AI: quản lý¶
Một hành động máy chủ AI hoạt động như người quyết định, hoặc người quản lý. Nó đọc bản ghi và ngữ cảnh của nó. Nó diễn giải lời nhắc AI. Và nó quyết định công cụ nào sẽ được gọi, và các đối số nào sẽ được sử dụng.
Hành động máy chủ không thi hành các quy tắc nghiệp vụ, không sửa đổi bản ghi trực tiếp, và không bảo đảm tính đúng đắn của hoạt động. Vai trò của nó chỉ giới hạn ở việc ra quyết định.
Công cụ AI: người lao động¶
Một công cụ là một hành động máy chủ tiêu chuẩn với tùy chọn Use in AI được bật trong tab Usage của nó. Công cụ chứa toàn bộ logic thực thi và thực hiện cập nhật bản ghi, di chuyển hoặc ghi. Công cụ phải thực thi các quy tắc nghiệp vụ một cách rõ ràng trong mã Python.
Nếu một công cụ được gọi bởi hành động máy chủ AI, nó sẽ thực thi vô điều kiện, trừ khi mã nguồn tự nó ngăn cản.
Luồng công việc hành động máy chủ AI¶
Quy trình hành động máy chủ AI tuân theo chuỗi sau:
Một bản ghi kích hoạt một hành động máy chủ AI.
Lời nhắc AI được đánh giá, sử dụng bản ghi làm ngữ cảnh.
AI chọn một trong các công cụ có sẵn.
AI cung cấp các đối số mà công cụ mong đợi.
Công cụ đã chọn thực thi mã Python của nó.
Quan trọng
AI các hành động máy chủ hoạt động mà không cần logic tùy chỉnh chỉ khi hành vi nền đã tồn tại trong Odoo, chẳng hạn di chuyển tài liệu vào thư mục. Trong những trường hợp này, AI lựa chọn các tham số và Odoo thực thi hành động.
Hướng dẫn chi tiết trường hợp sử dụng¶
Ví dụ Auto-sort documents in Inbox trình bày mẫu Server Action AI đầy đủ. Điều hướng tới menu Server Actions bằng cách vào
Ghi chú
Hành động máy chủ này được thiết kế để rà soát tài liệu dựa trên nội dung và thêm thẻ. Hành động này không di chuyển tài liệu hay thêm thẻ, mà chỉ quyết định công cụ nào sẽ được sử dụng, dựa trên nội dung của tài liệu.
Model cho hành động được liệt kê là Document, và Type là AI
Lời nhắc cho thao tác này cung cấp ngữ cảnh về tài liệu, cũng như mục đích của thao tác.
Trường Tool bao gồm một số hành động có thể thực hiện dựa trên lời nhắc này, bao gồm di chuyển tài liệu, thêm thẻ, hoặc tạo hóa đơn bán hàng hoặc hóa đơn mua hàng.
Ghi chú
AI: Thêm thẻ, AI: Di chuyển tới thư mục, và AI: Đổi tên tài liệu đều là các hành động máy chủ Thực thi mã, có nghĩa là chúng kích hoạt mã python.
Ví dụ, nếu hành động xác định, dựa trên nội dung của tài liệu, rằng công cụ phù hợp nhất là AI: Move to Folder, mã Python sẽ thực hiện thao tác sau:
ai['result'] = record._ai_action_move_in_folder(folder_id)
Mã này, thực thi không có điều kiện khi được gọi và thực hiện việc di chuyển bằng một phương pháp hiện có.
Ghi chú
Trình AI không suy ra các đối số từ mã Python hoặc chữ ký phương thức. Thay vào đó, các đối số được truyền cho công cụ được xác định hoàn toàn bởi cấu hình của công cụ.
Đối với công cụ AI: Move to Folder, mã Python yêu cầu một biến có tên folder_id. Trình AI biết cung cấp folder_id vì nó được khai báo rõ ràng như một đối số trong cấu hình. Bạn có thể tìm thấy điều này ở tab Usage của hành động máy chủ, trong trường AI Schema. Cột Name dưới AI Schema phải khớp chính xác với tên biến được sử dụng trong mã Python.
Trình AI sử dụng mô tả đối số để hiểu tham số đại diện cho gì, loại giá trị nào được mong đợi, và khi nào phù hợp để cung cấp nó.
Nếu một tham số không được định nghĩa trong tab Sử dụng, AI sẽ không thể cung cấp nó, ngay cả khi mã Python tham chiếu tới nó.
Tạo công cụ AI tùy chỉnh¶
Mẫu tương tự trong ví dụ Auto-sort documents in Inbox ở trên có thể được thực hiện bằng logic tiêu chuẩn của Odoo. Ví dụ, để tạo một hành động có thể cập nhật mô tả công việc, một hành động Execute Code có thể được tạo với đoạn mã sau:
record.write({'description': content})
Để hoạt động đúng, content phải được định nghĩa làm đối số trong tab Usage của công cụ.
Xem thêm
Vấn đề thường gặp¶
Tại sao trường Công cụ trống?¶
Xác nhận rằng có ít nhất một hành động máy chủ có Use in AI được bật.
Xác nhận rằng ít nhất một công cụ được gán cho cùng mô hình Model với hành động máy chủ.
Tại sao công cụ đã chạy nhưng không có gì xảy ra?¶
Mã Python đã thoát mà không có thay đổi.
Các đối số bắt buộc bị thiếu hoặc rỗng.
Các điều kiện kinh doanh chưa được thực hiện trong logic công cụ.
Tại sao AI lại chọn một công cụ không mong đợi?¶
Lời nhắc không đủ ngữ cảnh
Nhiều công cụ đã khớp với cùng một ý định.
Không có ràng buộc nào được thực thi ở mức công cụ.