Triển khai EzyVector lên máy chủ
Back to ezyvectorEzyVector được triển khai dưới dạng plugin của EzyPlatform. Sau khi cài đặt trên máy chủ, bạn có thể quản lý các bộ sưu tập vector qua giao diện admin và tích hợp API vào dịch vụ của mình để lưu trữ, tìm kiếm dữ liệu.
Triển khai EzyPlatform lên máy chủ
Trước tiên, bạn cần triển khai EzyPlatform theo hướng dẫn Triển khai EzyPlatform lên máy chủ.
Sau khi hoàn tất, hãy truy cập giao diện admin trên máy chủ và đăng nhập bằng tài khoản quản trị. Đây là nơi bạn sẽ cài đặt plugin và cấu hình EzyVector.
Cài đặt plugin EzyVector
Trên giao diện admin của EzyPlatform, mở mục quản lý plugin, nhấn Add New và tìm kiếm
ezyvector. Tiếp theo, thêm plugin và kích hoạt các thành phần cần sử dụng.Bạn cần kích hoạt thành phần admin để quản lý EzyVector và thành phần web để cung cấp REST API cho dịch vụ bên ngoài. Hoàn tất việc áp dụng plugin và khởi động lại các thành phần liên quan theo hướng dẫn của EzyPlatform.
Nếu chưa quen với quy trình này, hãy xem Hướng dẫn thêm plugin vào EzyPlatform.
Tạo Khóa API bộ sưu tập vector
Sau khi EzyVector được kích hoạt, truy cập trang Cài đặt của EzyVector trên giao diện admin.
Tại trường Khóa API bộ sưu tập vector, bạn có thể nhập khóa của mình hoặc nhấn nút có biểu tượng tạo ngẫu nhiên để sinh khóa mới. Sau đó, nhấn Lưu để áp dụng cấu hình và sao chép khóa để sử dụng trong dịch vụ cần kết nối.
Khóa này dùng để xác thực các yêu cầu gọi API quản lý bộ sưu tập, lưu dữ liệu vector và tìm kiếm. Hãy lưu khóa trong cấu hình phía máy chủ của dịch vụ.
Trang cài đặt cũng cho phép cấu hình danh sách IP được phép truy cập API. Nếu sử dụng giới hạn này, hãy thêm IP của máy chủ chạy dịch vụ tích hợp. Khi danh sách để trống, EzyVector không giới hạn truy cập theo IP.
Tích hợp dịch vụ với API của EzyVector
Sau khi có khóa API, cấu hình dịch vụ của bạn để gửi yêu cầu đến địa chỉ cung cấp REST API của EzyVector trên máy chủ.
Bạn có thể truyền khóa bằng header:
Authorization: Bearer YOUR_API_KEY
Hoặc:
x-api-key: YOUR_API_KEY
Luồng tích hợp cơ bản gồm:
- Tạo bộ sưu tập với số chiều vector và cách tính khoảng cách phù hợp.
- Ghi dữ liệu vector cùng thông tin đi kèm vào bộ sưu tập.
- Gửi vector truy vấn để tìm các dữ liệu tương đồng.
Số chiều vector khi ghi dữ liệu và tìm kiếm cần khớp với cấu hình của bộ sưu tập.
Chi tiết endpoint, phương thức HTTP và cấu trúc dữ liệu được trình bày trong tài liệu Danh sách các REST API của EzyVector.
Sử dụng EzyVector với EzyRAG
Nếu sử dụng plugin EzyRAG, phần gọi API của EzyVector đã được tích hợp sẵn.
Trong EzyRAG, bạn chỉ cần cấu hình kết nối đến EzyVector bằng địa chỉ API và khóa đã tạo, sau đó cấu hình bộ sưu tập sử dụng EzyVector với tên bộ sưu tập, số chiều vector và cách tính khoảng cách phù hợp.
Khi cấu hình hoàn tất, EzyRAG có thể lưu dữ liệu vector và thực hiện tìm kiếm thông qua EzyVector. Bạn có thể tiếp tục xây dựng luồng nạp dữ liệu và truy vấn của mình trên EzyRAG.