Firebase AI Logic의 경우 Firebase 콘솔은 템플릿의 콘텐츠를 지정할 수 있는 안내 UI를 제공합니다. 그러나 다음과 같은 템플릿을 설정하는 더 고급 방법이 필요한 사용 사례가 여러 가지 있습니다.
이 페이지에 설명된 고급 워크플로는 Firebase AI Logic REST API를 사용합니다.
REST API 사용에 관한 중요 정보
템플릿이 잠금 해제된 경우 REST API 호출에서 동일한 템플릿 ID를 사용하여 템플릿을 덮어쓸 수 있습니다. 잠긴 템플릿은 덮어쓸 수 없습니다.
REST API를 통해 서버 프롬프트 템플릿을 만들고 위치를
global로 설정하면 서버 프롬프트 템플릿이 모든 위치 (global포함)에 자동으로 프로비저닝되며 두 Gemini API 제공업체와 함께 사용할 수 있습니다. 그러나 REST API를 통해 템플릿을 만들 때 다른 위치를 설정하면 템플릿은 에서만 사용할 수 있습니다.Vertex AI Gemini API 이 페이지의 뒷부분에서 템플릿의 특정 위치를 설정하는 방법 을 자세히 알아보세요.Firebase 콘솔에서 안내 UI를 사용하면 템플릿 이 모든 위치 (
global포함)에 자동으로 프로비저닝되며 두 Gemini API 제공업체와 함께 사용할 수 있습니다.REST API를 통해
templateGenerateContent또는templateStreamGenerateContent요청에서 서버 프롬프트 템플릿에 액세스하려면 Gemini API 제공업체 (Gemini Developer API | Vertex AI Gemini API)와 관련된 엔드포인트를 사용해야 합니다.
(Vertex AI Gemini API만 해당) 템플릿의 특정 위치 설정
이 섹션은 다음과 같은 상황에 적용됩니다.
앱의 사용 사례에 위치 기반 요구사항이 있습니다.
앱의 요청에서 Vertex AI Gemini API을 사용하고 모델에 액세스할 위치를 지정합니다.
이 페이지의 앞부분에서 설명한 대로 다음 중 하나를 실행하면 서버 프롬프트 템플릿이 Firebase AI 로직에 사용 가능한 모든
리전(global 포함)에 자동으로
프로비저닝됩니다.Firebase AI Logic
- Firebase 콘솔에서 안내 UI를 사용하여 템플릿을 만듭니다.
- REST API를 통해 템플릿을 만들고 위치를
global로 설정합니다.
즉, 앱의 요청에서
에 사용 가능한 리전 중 하나로 위치를 설정하면 템플릿을 사용할 수 있습니다.Firebase AI Logic
앱의 요청에서 위치를 global로 설정할 필요는 없습니다.
그러나 템플릿을
특정 위치에서만 사용할 수 있도록 하려면 REST API를 통해
템플릿을 만들고 해당 특정 위치를 명시적으로 설정해야 합니다. 위치를 global로 설정하지 마세요.
projects.locations.templates.create엔드포인트를 호출하여 템플릿을 만듭니다. 템플릿의location(예:europe-west4) 을 만드는 과정에서PromptTemplate을 지정합니다.앱의 요청에서 모델에 액세스하는 위치가 템플릿의 위치 (
europe-west4)와 일치하는지 확인합니다.
다음 사항에 유의하세요.
Firebase 콘솔의 템플릿 목록에는
global위치에 프로비저닝된 템플릿만 표시됩니다 (최소).REST API를 사용하여 특정 위치(
global이 아닌)에 템플릿을 프로비저닝하는 경우 앱의 요청에서 모델에 액세스하는 위치가 템플릿에 설정된 위치와 일치해야 합니다. 위치가 일치하지 않으면 리전 격리 정책으로 인해 요청이 실패합니다.
템플릿을 파일로 제공
projects.locations.templates.create 엔드포인트를 호출하여 서버 프롬프트 템플릿 파일의 콘텐츠를 제공할 수 있습니다.