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 Logic 사용 가능 리전(global 포함)에 자동으로 프로비저닝됩니다.
- Firebase 콘솔의 안내 UI를 사용하여 템플릿을 만듭니다.
- REST API를 통해 템플릿을 만들고 위치를
global로 설정합니다.
즉, 앱의 요청에서 Firebase AI Logic에 사용할 수 있는 리전 중 하나로 위치를 설정하면 템플릿을 사용할 수 있습니다.
앱의 global 요청에서 위치를 설정하지 않아도 됩니다.
하지만 템플릿이 특정 위치에서만 사용 가능하도록 하려면 REST API를 통해 템플릿을 만들고 해당 특정 위치를 명시적으로 설정해야 합니다. 위치를 global로 설정하면 안 됩니다.
projects.locations.templates.create엔드포인트를 호출하여 템플릿을 만듭니다.PromptTemplate을 만드는 과정에서 템플릿의location(예:europe-west4)를 지정합니다.앱의 요청에서 모델에 액세스하는 위치가 템플릿의 위치 (
europe-west4)와 일치하는지 확인합니다.
다음 사항에 유의하세요.
Firebase 콘솔의 템플릿 목록에는
global위치에 프로비저닝된 템플릿만 표시됩니다(최소한).REST API를 사용하여 특정 위치(
global이 아닌)에 템플릿을 프로비저닝하는 경우 앱의 요청에서 모델에 액세스하는 위치가 템플릿에 설정된 위치와 일치해야 합니다. 위치가 일치하지 않으면 리전 격리 정책으로 인해 요청이 실패합니다.
템플릿을 파일로 제공
projects.locations.templates.create 엔드포인트를 호출하여 서버 프롬프트 템플릿 파일의 콘텐츠를 제공할 수 있습니다.