이 페이지에서는 아직 지원되지 않는 기능을 비롯한 서버 프롬프트 템플릿의 몇 가지 권장사항과 고려사항을 설명합니다. 이러한 기능 중 다수는 서버 프롬프트 템플릿의 초기 출시 시에만 사용할 수 없으므로 출시 노트에서 업데이트를 확인하세요.
권장사항
이러한 권장사항 중 상당수는 템플릿 관리에도 자세히 설명되어 있습니다.
템플릿 버전 관리
시맨틱 버전 관리 (semver)를 사용하는 버전이 추가된 템플릿 ID를 만듭니다.
요청에서 템플릿과 기타 값을 쉽게 변경할 수 있도록 Firebase Remote Config을 사용하세요.
템플릿 보호
프로덕션으로 이동하기 전에 템플릿을 잠급니다. 프로덕션에서 사용되는 템플릿은 수정하지 마세요.
템플릿을 잠그면 의도치 않은 수정으로부터 보호할 수 있지만 수정을 완전히 차단하지는 않습니다. 적절한 권한이 있는 프로젝트 구성원은 언제든지 템플릿을 잠금 해제하여 수정할 수 있습니다.
코드, 특히 프로덕션 코드에서 활발하게 사용되는 템플릿은 잠그는 것이 좋습니다.
입력 변수에 대한 강력한 입력 유효성 검사를 작성하세요. 이는 다음을 지원합니다.
- 프롬프트 삽입을 방지하는 데 도움이 될 수 있습니다.
- 요청이 성공하고 응답이 예상대로 되도록 하는 데 도움이 됩니다.
아직 지원되지 않는 기능
아직 지원되지 않는 기능 중 상당수는 초기 출시에서만 사용할 수 없으므로 출시 노트에서 업데이트를 확인하세요.
아직 지원되지 않는 Firebase AI Logic 기능
서버 프롬프트 템플릿은 아직 Firebase AI Logic의 다음 기능을 지원하지 않습니다. 이러한 기능 중 일부는 곧 제공될 예정입니다.
- 채팅
- 도구 사용 (함수 호출 및 Google 검색을 사용한 그라운딩 포함)
- Gemini 모델을 사용한 이미지의 반복 편집 (채팅)(채팅 필요)
- Imagen 모델로 이미지 수정
- 양방향 스트리밍 (Gemini Live API)
- 하이브리드 온디바이스
- 출력을 enum 목록으로 제한
- 생각 관련 설정 구성
- 안전 설정 구성
Firebase 콘솔에서 AI 모니터링을 사용하는 경우 템플릿 ID가 아직 레코드에 입력되지 않습니다.
아직 지원되지 않는 Dotprompt의 일반적인 요소
서버 프롬프트 템플릿은 조만간 Dotprompt의 다음과 같은 일반적인 요소를 지원할 예정입니다.
프런트매터에서 입력 및 출력 스키마에 JSON 스키마 사양을 사용합니다.
- 이 사양은 서버가 아닌 템플릿 요청에서도 지원되지 않습니다. 현재 OpenAPI 스키마 사양만 지원됩니다.
*를 사용하여 와일드 카드 필드 정의를 선언합니다.@key를 사용하거나 일반적으로 객체 입력의 필드를 반복하는 경우(@key가 관련이 있는 경우)현재
this와 관계없이 루트 변수 컨텍스트를 참조할 수 있는@root사용
서버 프롬프트 템플릿은 다음과 같은 Dotprompt의 일반적인 요소를 지원하지 않을 수 있습니다.
- 다른 템플릿에 포함할 수 있는 재사용 가능한 템플릿 스니펫인 부분을 사용합니다.
기타 고려사항
기본적으로 Firebase 콘솔에서 안내 UI를 사용하면 Firebase AI Logic에 사용 가능한 모든 리전에 템플릿이 프로비저닝됩니다. Vertex AI Gemini API를 사용하고 사용 사례에 위치 기반 제한이 필요한 경우 REST API를 사용하여 템플릿의 위치를 지정할 수 있습니다.
Firebase 콘솔의 안내 UI를 사용하는 대신 서버 프롬프트 템플릿을 파일로 제공하려면 REST API를 사용하면 됩니다. 서버 프롬프트 템플릿은 앱 코드에 정의되고 템플릿에 전달되는 스키마를 지원하지 않습니다.
템플릿이 서버에 있지만 직접 Firebase 프로젝트의 다른 서버 측 리소스 (예: 데이터베이스)와 상호작용할 수는 없습니다. Cloud Storage for Firebase URL을 제외하고 (입력 변수로 제공될 수 있음)