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 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ột mẫu, bao gồm:

Các quy trình nâng cao được mô tả trong 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 đượ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ột mẫu đã khoá.

  • Khi bạn tạo một mẫu lời nhắc 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 máy chủ sẽ tự động được cung cấp ở tất cả các vị trí (bao gồm cả global) và có thể 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 Vertex AI Gemini API. Tìm hiểu thêm về cách đặt một vị trí cụ thể cho một 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 Firebase console, mẫu cũng sẽ tự động được cung cấp ở tất cả các vị trí (bao gồm cả global), và có thể dùng với cả các nhà cung cấp Gemini API.

  • Để truy cập vào một mẫu lời nhắc 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ột 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ột mô hình.

Như mô tả trước đó trên trang này, một mẫu lời nhắc máy chủ sẽ tự động được cung cấp cho tất cả cá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 thao tác sau:

  • Tạo mẫu bằng giao diện người dùng có hướng dẫn trong Firebase console.
  • 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 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 bạn muốn mẫu của mình chỉ có sẵ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.

  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 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 Firebase console chỉ hiển thị các mẫu được cung cấp (tối thiểu) ở vị trí global location.

  • 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à 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í đượ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 máy chủ bằng cách gọi điểm cuối projects.locations.templates.create.