Đối với Firebase AI Logic, bảng điều khiển Firebase cung cấp giao diện người dùng có hướng dẫn để bạn chỉ định nội dung của mẫu. Tuy nhiên, có một số trường hợp sử dụng mà bạn có thể cần đến các cách thiết lập mẫu nâng cao hơn, bao gồm:
Quy trình nâng cao được mô tả trên trang này sử dụng API REST Firebase AI Logic.
Thông tin quan trọng về việc sử dụng API REST
Nếu 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. Không thể ghi đè mẫu đã khoá.
Khi bạn tạo mẫu câu lệnh máy chủ thông qua API REST và đặt vị trí của mẫu đó thành
global, thì mẫu câu lệnh máy chủ sẽ được tự động cấp phép ở tất cả vị trí (bao gồm cảglobal) và có thể sử dụng với cả hai 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 đó sẽ chỉ có sẵn cho Agent Platform Gemini API (formerly Vertex AI). 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.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 cấp phép ở tất cả vị trí (bao gồm cả
global) và có thể sử dụng với cả hai 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 (Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI)).
(Chỉ dành cho Agent Platform Gemini API (formerly Vertex AI)) Đặt một vị trí cụ thể cho mẫu
Phần này áp dụng cho các 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 Agent Platform Gemini API (formerly Vertex AI) và bạn chỉ định một vị trí để truy cập vào một mô hình.
Như đã mô tả ở phần trước trên trang này, mẫu câu lệnh của máy chủ sẽ tự động được cung cấp cho tất cả
khu vực được hỗ trợ cho Firebase AI Logic (bao gồm cả global) nếu bạn làm một trong những việ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 cho global.
Tuy nhiên, nếu bạn muốn mẫu của mình chỉ có ở một vị trí cụ thể, thì bạn cần tạo mẫu thông qua API REST và đặt rõ vị trí cụ thể đó. Không đặt vị trí thành 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í bạn truy cập vào mô hình khớp với vị trí của mẫu (
eu).
Hãy lưu ý những điều sau:
Danh sách mẫu trong bảng điều khiển Firebase chỉ cho thấy những mẫu (tối thiểu) được cung cấp ở 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
global), thì vị trí mà bạn truy cập vào mô hình trong yêu cầu 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 tách biệt 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 tệp mẫu câu lệnh máy chủ bằng cách gọi điểm cuối projects.locations.templates.create.