Starting November 2, 2026, Firebase App Check enforcement will be required to use Firebase AI Logic. Learn more.

Model updates:

Gemini 4 Argon is now available to use with Firebase AI Logic! Learn more.
Gemini 2.5 models are limited to projects that actively used them in the past. For the Agent Platform Gemini API, these models will shut down for all projects in October 2026. To avoid service disruptions, update to a newer model (like gemini-4-argon, gemini-3.8-flash, or gemini-nano-banana-2.1). Any stable Gemini Live API 2.5 models are not impacted. Learn more.

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

템플릿의 고급 워크플로

Firebase AI Logic의 경우 Firebase 콘솔은 템플릿 콘텐츠를 지정할 수 있는 안내 UI를 제공합니다. 하지만 다음과 같이 템플릿을 설정하는 고급 방법이 필요한 사용 사례가 여러 가지 있습니다.

이 페이지에 설명된 고급 워크플로는 Firebase AI Logic REST API를 사용합니다.

REST API 사용에 관한 중요 정보

템플릿이 잠금 해제된 경우 REST API 호출에서 동일한 템플릿 ID를 사용하여 템플릿을 덮어쓸 수 있습니다. 잠긴 템플릿은 덮어쓸 수 없습니다.
REST API를 통해 서버 프롬프트 템플릿을 만들고 위치를 global로 설정하면 서버 프롬프트 템플릿이 global를 포함한 모든 위치에 자동으로 프로비저닝되며 두 Gemini API 제공업체에서 모두 사용할 수 있습니다. 하지만 REST API를 통해 템플릿을 만들 때 다른 위치를 설정하면 템플릿을 Agent Platform Gemini API (formerly Vertex AI)에서만 사용할 수 있습니다. 이 페이지 뒷부분에서 템플릿의 특정 위치 설정에 대해 자세히 알아보세요.

Firebase 콘솔에서 가이드 UI를 사용하면 템플릿이 global를 포함한 모든 위치에 자동으로 프로비저닝되며 두 Gemini API 제공업체 모두에서 사용할 수 있습니다.
REST API를 통해 templateGenerateContent 또는 templateStreamGenerateContent 요청에서 서버 프롬프트 템플릿에 액세스하려면 Gemini API 제공업체(Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI))에 해당하는 엔드포인트를 사용해야 합니다.

이 섹션은 다음과 같은 상황에 적용됩니다.

이 페이지의 앞부분에서 설명한 것처럼 다음 중 하나를 수행하면 서버 프롬프트 템플릿이 모든 Firebase AI Logic에 지원되는 리전(global 포함)에 자동으로 프로비저닝됩니다.

즉, 앱 요청의 위치를 Firebase AI Logic에 사용 가능한 리전으로 설정하면 템플릿을 사용할 수 있습니다. global에 대한 앱의 요청에 위치를 설정하지 않아도 됩니다.

하지만 특정 위치에서만 템플릿을 사용할 수 있도록 하려면 REST API를 통해 템플릿을 만들고 해당 특정 위치를 명시적으로 설정해야 합니다. 위치를 global로 설정하지 마세요.

projects.locations.templates.create 엔드포인트를 호출하여 템플릿을 만듭니다. PromptTemplate를 만드는 과정에서 템플릿의 location(예: europe-west4)를 지정합니다.
앱 요청에서 모델에 액세스하는 위치가 템플릿 위치 (eu)와 일치하는지 확인합니다.

다음 사항에 유의하세요.

Firebase 콘솔의 템플릿 목록에는 global 위치에 프로비저닝된 템플릿만 표시됩니다.
REST API를 사용하여 특정 위치(global가 아님)에서 템플릿을 프로비저닝하는 경우 앱 요청에서 모델에 액세스하는 위치가 템플릿에 설정된 위치와 일치해야 합니다. 위치가 일치하지 않으면 리전 격리 정책으로 인해 요청이 실패합니다.

projects.locations.templates.create 엔드포인트를 호출하여 서버 프롬프트 템플릿 파일의 콘텐츠를 제공할 수 있습니다.