Đối với Firebase AI Logic, bảng điều khiển Firebase cung cấp một giao diện người dùng có hướng dẫn để bạn chỉ định nội dung của một mẫu. Tuy nhiên, có một số trường hợp sử dụng mà bạn có thể cần các cách thiết lập mẫu nâng cao hơn, bao gồm:
Các quy trình nâng cao được mô tả trên trang này sử dụng Firebase AI Logic API REST.
Thông tin quan trọng về việc sử dụng API REST
Nếu một mẫu không bị khoá, thì bạn có thể ghi đè mẫu đó bằng cách sử dụng cùng một mã mẫu trong lệnh gọi API REST. Bạn không thể ghi đè mẫu đã khoá.
Khi bạn tạo một mẫu câu lệnh trên máy chủ thông qua API REST và bạn đặt vị trí của mẫu đó thành
global, thì mẫu câu lệnh trên máy chủ sẽ tự động được cung cấp ở tất cả các vị trí (kể cảglobal) và có thể dùng được với cả nhà cung cấp Gemini API. Tuy nhiên, nếu bạn đặt bất kỳ vị trí nào khác khi tạo mẫu thông qua API REST, thì mẫu đó chỉ có sẵn cho Vertex AI Gemini API. Tìm hiểu thêm về cách đặt một vị trí cụ thể cho mẫu ở phần sau của trang này.Xin lưu ý rằng khi bạn sử dụng giao diện người dùng có hướng dẫn trong bảng điều khiển Firebase, mẫu cũng sẽ tự động được cung cấp ở tất cả các vị trí (kể cả
global) và có thể dùng với cả nhà cung cấp Gemini API.Để truy cập vào mẫu câu lệnh của máy chủ trong yêu cầu
templateGenerateContenthoặctemplateStreamGenerateContentthông qua API REST, bạn phải sử dụng điểm cuối dành riêng cho nhà cung cấp Gemini API của mình (Gemini Developer API | Vertex AI Gemini API).
(Chỉ Vertex AI Gemini API) Đặt một vị trí cụ thể cho mẫu
Phần này áp dụng cho những trường hợp sau:
Trường hợp sử dụng của ứng dụng có các yêu cầu dựa trên vị trí.
Các yêu cầu của ứng dụng sử dụng Vertex AI Gemini API và bạn chỉ định một vị trí để truy cập vào một mô hình.
Như mô tả trước đó trên trang này, một mẫu câu lệnh của máy chủ sẽ được tự động cung cấp cho tất cả
các khu vực có sẵn cho Firebase AI Logic (bao gồm cả global) nếu bạn thực hiện một trong những thao tác sau:
- Tạo mẫu bằng giao diện người dùng có hướng dẫn trong bảng điều khiển Firebase.
- Tạo mẫu thông qua API REST và đặt vị trí của mẫu thành
global.
Điều này có nghĩa là bạn có thể đặt vị trí trong yêu cầu của ứng dụng thành bất kỳ khu vực nào có sẵn cho Firebase AI Logic và mẫu sẽ có sẵn.
Bạn không bắt buộc phải đặt vị trí trong yêu cầu của ứng dụng thành global.
Tuy nhiên, nếu chỉ muốn mẫu của mình xuất hiện ở một vị trí cụ thể, thì bạn cần tạo mẫu thông qua API REST và đặt vị trí cụ thể đó một cách rõ ràng. Không đặt vị trí là global.
Tạo mẫu bằng cách gọi điểm cuối
projects.locations.templates.create. Chỉ địnhlocationcủa mẫu (ví dụ:europe-west4) trong quá trình tạoPromptTemplate.Trong yêu cầu của ứng dụng, hãy đảm bảo vị trí mà bạn truy cập vào mô hình khớp với vị trí của mẫu (
europe-west4).
Hãy lưu ý những điều sau:
Danh sách các mẫu trong bảng điều khiển Firebase chỉ cho thấy những mẫu được cung cấp (tối thiểu) ở vị trí
global.Nếu bạn sử dụng API REST để cung cấp một mẫu ở một vị trí cụ thể (không phải là
global), thì vị trí mà bạn truy cập vào mô hình trong yêu cầu phải của ứng dụng phải khớp với vị trí được đặt cho mẫu. Nếu các vị trí không khớp, thì yêu cầu sẽ không thành công (do chính sách cách ly theo khu vực).
Cung cấp mẫu dưới dạng tệp
Bạn có thể cung cấp nội dung của một tệp mẫu lời nhắc trên máy chủ bằng cách gọi điểm cuối projects.locations.templates.create.