Quy trình công việc nâng cao cho mẫu


Đố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 nâng cao hơn để thiết lập mẫu, bao gồm:

Các quy trình nâng cao được mô tả trên trang này sử dụng API REST của Firebase AI Logic.

Thông tin quan trọng về việc sử dụng API REST

  • Nếu một mẫu được mở 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 lời nhắc của máy chủ thông qua API REST và đặt vị trí của mẫu đó thành global, thì mẫu lời nhắc của máy chủ sẽ tự động được cung cấp ở tất cả vị trí (bao gồm cả global) và có thể dùng 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 đó sẽ chỉ dùng được với 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 trên 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ả vị trí (bao gồm cả global), và có thể dùng với cả nhà cung cấp Gemini API.

  • Để truy cập vào một mẫu lời nhắc của máy chủ trong yêu cầu templateGenerateContent hoặc templateStreamGenerateContent thô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 | 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 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í.

  • 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ô hình.

Như mô tả ở phần trước trên trang này, một mẫu lời nhắc của máy chủ sẽ tự động được cung cấp cho tất cả khu vực hiện có cho Firebase AI Logic (bao gồm cả global) nếu bạn thực hiện 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 hiện có cho Firebase AI Logicvà mẫu đó sẽ dùng được. 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 bạn muốn mẫu của mình chỉ dùng được ở 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. Đừng đặt vị trí thành global.

  1. Tạo mẫu bằng cách gọi điểm cuối projects.locations.templates.create. Chỉ định location của mẫu (ví dụ: europe-west4) trong quá trình tạo PromptTemplate.

  2. Trong yêu cầu của ứng dụng, hãy đảm bảo rằng 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 mẫu trong bảng điều khiển Firebase chỉ hiển thị các 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 không 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í đã đặ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 tệp mẫu lời nhắc của máy chủ bằng cách gọi điểm cuối projects.locations.templates.create.