Thiết lập nhà cung cấp AI và mẫu tài liệu giao nhận¶
Thông tin hướng dẫn
Cảnh báo
Ảnh chụp màn hình trên trang này sử dụng dữ liệu giả định. Các chứng từ, giá trị trích xuất và kết quả AI hiển thị chỉ mang tính minh họa, không đến từ một lần phân tích AI thật hay một doanh nghiệp có thật nào.
Điều kiện cần có
Hướng dẫn này yêu cầu cài các ứng dụng/mô-đun sau:
Document Parsing (Phân tích tài liệu) - tiện ích bổ sung cài riêng (khi cài mô-đun này và Freight Forwarder Management đã hoạt động, Freight Document Parsing được kích hoạt tự động - đây là mô-đun nạp 5 mẫu tài liệu giao nhận được xác nhận trong hướng dẫn này)
Mỗi lần trích xuất bằng AI trong Điền booking hoặc lô hàng từ tài liệu bằng AI đều cần ít nhất một nhà cung cấp thực sự phản hồi. Nếu bỏ qua bước thiết lập này, người đầu tiên bấm Import from Document (Nhập từ tài liệu) sẽ gặp lỗi kết nối hoặc API key thay vì nhận được lô hàng đã điền thông tin, và có thể nhầm lỗi cấu hình với tính năng bị hỏng. Đây là bước thiết lập một lần cho mỗi công ty, không phải bước làm cho từng lô hàng.
Tình huống minh họa: công ty bắt đầu với sáu nhà cung cấp có sẵn trong mô-đun. Google Gemini được đánh dấu mặc định sau khi cài; trong hướng dẫn này, quản trị viên đặt nhà cung cấp OpenAI đã được phê duyệt làm mặc định và kiểm tra kết nối trước khi nhóm Chứng từ dùng. Các bản ghi là dữ liệu demo của Viindoo nên dữ liệu của bạn sẽ khác.
Mở màn hình Nhà cung cấp AI¶
Vào .
Ghi chú
Màn hình này nằm trực tiếp dưới ứng dụng Thiết lập - không cần Chế độ nhà phát triển và không nằm dưới Technical. Chỉ người dùng có mức quyền Settings (trong , tab Quyền truy cập, mục Quản trị) mới tạo hoặc sửa được nhà cung cấp tại đây, và chỉ mức quyền đó thấy được trường API key. Mọi người dùng nội bộ khác chỉ đọc được danh sách. Đây là mức quyền kỹ thuật hơn mức quyền Administrator của Freight, nên với nhóm nhỏ thường cùng một người giữ cả hai.
Danh sách có sáu nhà cung cấp, được tạo sẵn với tên và mô hình mặc định nhưng chưa có API key: Google Gemini, Groq, OpenRouter, OpenAI, Anthropic Claude và Ollama (Local). Cột Provider mặc định được đánh dấu ở Google Gemini - nhà cung cấp mà trình hướng dẫn Import from Document (Nhập từ tài liệu) chọn sẵn cho đến khi bạn đổi.
Mẹo
Thiết lập đúng khi: danh sách có đủ 6 nhà cung cấp tạo sẵn, và dòng Google Gemini là dòng được đánh dấu mặc định.
Chọn nhà cung cấp AI cần thiết lập¶
Lựa chọn |
Sử dụng khi |
Điều gì thay đổi |
|---|---|---|
Dùng nhà cung cấp tạo sẵn (OpenAI trong hướng dẫn này) |
Công ty đã phê duyệt nhà cung cấp và mô hình để xử lý các tài liệu này |
Không cần tạo bản ghi mới; thêm API key của nhà cung cấp và chỉ đặt làm mặc định nếu nhóm muốn chọn sẵn nhà cung cấp đó |
Tạo nhà cung cấp Custom (OpenAI-compatible) |
Công ty vận hành điểm truy cập LLM riêng hoặc dùng nhà cung cấp chưa có trong danh sách tạo sẵn |
Bạn phải tự tạo bản ghi và điền API Base URL (URL gốc của API); Custom không có dữ liệu mẫu để bắt đầu |
Đổi mô hình của nhà cung cấp Ollama sang |
Bạn chạy AI cục bộ bằng Ollama và cần đọc ảnh quét hoặc PDF |
Mô hình mặc định tạo sẵn của Ollama ( |
Dùng nhà cung cấp và mô hình đã được phê duyệt theo yêu cầu về dữ liệu, bảo mật và chi phí của công ty; xác nhận mô hình có thể đọc những loại tệp nhóm bạn xử lý. Nếu chưa rõ tình trạng phê duyệt hoặc khả năng của mô hình, hãy hỏi quản trị viên AI/CNTT trước khi thêm khóa hoặc đổi nhà cung cấp mặc định.
Nhập API key cho nhà cung cấp¶
Nhà cung cấp tạo sẵn đã có mô hình và điểm truy cập được cấu hình. Trước khi dùng, hãy xác nhận mô hình được phép xử lý tài liệu của bạn và có thể đọc loại tệp tương ứng; cũng cần API key để kiểm tra kết nối thành công.
Mở dòng OpenAI, bật Provider mặc định cho ví dụ này, và điền API Key bằng thông tin xác thực được cấp qua quy trình quản lý bí mật đã được công ty phê duyệt. Trường chỉ hiện dấu chấm che ký tự sau khi lưu; Viindoo không hiển thị lại khóa đã lưu. Bật Provider mặc định ở một nhà cung cấp sẽ tắt nó ở các nhà cung cấp khác, nên mỗi lúc chỉ có một nhà cung cấp mặc định.
Ghi chú
API Base URL không hiển thị với OpenAI vì nhà cung cấp này dùng điểm truy cập riêng của mình. Trường có ở Ollama (Local) và Custom (OpenAI-compatible), nơi điểm truy cập phụ thuộc môi trường của bạn.
Mẹo
Hoàn thành bước này khi: trường API Key hiển thị dấu chấm che ký tự thay vì để trống và biểu mẫu đã được lưu.
Kiểm tra kết nối¶
Khóa đã lưu vẫn có thể sai vì thừa khoảng trắng, sao chép từ dự án khác hoặc đã bị thu hồi. Kiểm tra ngay giúp phát hiện vấn đề trước khi bộ phận Vận hành hoặc Kinh doanh gặp lỗi giữa lúc xử lý một Shipping Instruction thực tế.
Bấm Test Connection (Kiểm tra kết nối) ở đầu biểu mẫu nhà cung cấp.
Sau khi bấm, Viindoo gửi một yêu cầu tối thiểu tới nhà cung cấp và đọc câu trả lời. Khi nhà cung cấp trả lời đúng, một thông báo màu xanh hiện Kết nối thành công - "Provider 'OpenAI' đã kết nối và phản hồi đúng." Khóa sai hoặc điểm truy cập không khả dụng sẽ hiện thông báo lỗi.
Mẹo
Hoàn thành bước này khi: xuất hiện thông báo màu xanh "Provider 'OpenAI' đã kết nối và phản hồi đúng.", không phải thông báo lỗi.
Xác nhận các mẫu tài liệu giao nhận đã sẵn sàng¶
Các mẫu tài liệu giao nhận là dữ liệu do mô-đun tải khi cài, không cần tạo ở đây. Bước này chỉ xác nhận chúng đã được tải đầy đủ, vì nếu thiếu mẫu, bộ phận Vận hành không thể chọn đúng loại tài liệu khi dùng Điền booking hoặc lô hàng từ tài liệu bằng AI.
Vào .
Danh sách có năm dòng: Booking Confirmation, Shipping Instruction (FCL), Shipping Instruction (LCL), Bill of Lading (Ocean) và Arrival Notice. Kiểm tra cột Model đích: dòng đầu là Booking, bốn dòng còn lại là Logistics Shipment.
Xem thêm
Điền booking hoặc lô hàng từ tài liệu bằng AI - trình hướng dẫn đọc tài liệu bằng các mẫu này và nhà cung cấp bạn vừa cấu hình.
Mẹo
Thiết lập đúng khi: có đủ năm dòng, không dòng nào bị lưu trữ, và cột Model đích hiển thị Booking hoặc Logistics Shipment đúng như trên.
Giới hạn hiện tại¶
Bước |
Viindoo hiện xử lý thế nào |
Cách bạn thực hiện |
|---|---|---|
Kiểm tra kết nối |
Kiểm tra kết nối nằm ở đầu biểu mẫu nhà cung cấp thay vì ở thanh nút thông thường; nút vẫn hoạt động bình thường |
Tìm Kiểm tra kết nối ở đầu biểu mẫu, không phải ở thanh trạng thái |
Tạo nhà cung cấp Custom |
Không có bản ghi mẫu để sao chép; khác với sáu nhà cung cấp còn lại, Custom không được điền sẵn |
Tự điền tất cả trường, bắt đầu bằng API Base URL (URL gốc của API), trường bắt buộc đối với nhà cung cấp này |
Xử lý vướng mắc¶
"Unsupported provider" khi phân tích tài liệu¶
Hiện tượng: trình hướng dẫn Import from Document (Nhập từ tài liệu) hiển thị "Unsupported provider: ...".
Nguyên nhân: bản ghi nhà cung cấp được ghi với giá trị nằm ngoài 7 giá trị được hỗ trợ (OpenAI, Anthropic Claude, Google Gemini, Groq, OpenRouter, Ollama (Local), Custom (OpenAI-compatible)) - thường chỉ xảy ra khi giá trị được ghi qua đường khác ngoài màn hình này, như nhập dữ liệu hoặc gọi API.
Cách xử lý:
Mở nhà cung cấp tại .
Chọn lại giá trị hợp lệ cho Provider (Nhà cung cấp) rồi lưu.
Hệ thống yêu cầu API Base URL¶
Hiện tượng: Kiểm tra kết nối hoặc Phân tích tài liệu lỗi với "Ollama requires an API Base URL..." hoặc "Provider '...' has no default endpoint. Set an API Base URL ... before using this provider."
Nguyên nhân: Provider là Ollama (Local) hoặc Custom (OpenAI-compatible) và API Base URL bị để trống - cả hai đều không có một địa chỉ phổ biến duy nhất như nhà cung cấp đám mây.
Cách xử lý:
Nhập địa chỉ máy chủ của bạn vào API Base URL (ví dụ
http://192.168.1.100:11434với Ollama).Bấm lại Test Connection (Kiểm tra kết nối).
"Model '...' cannot read images or PDF pages"¶
Hiện tượng: phân tích PDF quét hoặc ảnh thất bại với thông báo này dù Test Connection đã thành công.
Nguyên nhân: mô hình gán cho nhà cung cấp có Khả năng đọc ảnh là No. Test Connection chỉ kiểm tra nhà cung cấp có phản hồi, không kiểm tra khả năng đọc ảnh của mô hình.
Cách xử lý:
Vào và kiểm tra giá trị Khả năng đọc ảnh của mô hình.
Thay bằng mô hình có Khả năng đọc ảnh là Yes (với Ollama là
llavahoặcllama3.2-vision).