템플릿 관리


이 페이지에서는 수정, 잠금, 삭제, 버전 제어를 비롯한 템플릿 관리 방법을 설명합니다.

프로그래매틱 방식으로 템플릿을 사용하거나 (예: REST API 사용) 특정 위치에 템플릿을 배포하려면 고급 워크플로를 참고하세요.

템플릿 수정 및 반복

잠금 해제된 템플릿은 수정할 수 있습니다.

다음 사항을 적극 권장합니다.

  • 프로덕션에서 사용되는 템플릿은 수정하지 마세요.
    템플릿에 대한 변경사항은 앱의 요청에서 거의 즉시 사용되므로 앱을 중단하거나 예상치 못한 동작 변경을 일으킬 수 있는 변경사항을 적용할 때는 주의해야 합니다.

  • 템플릿을 반복하는 데 버전 관리 시스템을 사용해 보세요.

기존 템플릿을 수정하는 방법은 다음과 같습니다.

  1. Firebase 콘솔에서 AI 서비스 > AI 로직 > 프롬프트 템플릿 탭으로 이동합니다.

  2. 템플릿 목록에서 수정할 템플릿을 찾아 클릭합니다.

  3. 템플릿이 잠겨 있으면 템플릿의 오른쪽 상단에 있는 잠금 아이콘을 클릭하여 잠금 해제합니다.

  4. 템플릿을 수정한 후 저장 을 클릭합니다.

  5. 템플릿이 이전에 잠겨 있었다면 잠금 아이콘을 다시 클릭해야 합니다.

  6. 닫기 를 클릭하여 템플릿을 종료합니다.

템플릿 잠그기

다음 사항을 적극 권장합니다.

  • 템플릿을 잠그면 의도치 않은 수정을 방지할 수 있지만 잠그더라도 수정을 완전히 차단하지는 않습니다. 적절한 권한이 있는 프로젝트 구성원은 언제든지 템플릿을 잠금 해제하여 수정할 수 있습니다.

  • 코드, 특히 프로덕션 코드에서 활발하게 사용되는 템플릿을 잠급니다.

템플릿을 잠그는 방법은 다음과 같습니다.

  1. Firebase 콘솔에서 AI 서비스 > AI 로직 > 프롬프트 템플릿 탭으로 이동합니다.

  2. 템플릿 목록에서 잠글 템플릿을 찾아 클릭합니다.

  3. 템플릿의 오른쪽 상단에 있는 잠금 아이콘을 클릭하여 템플릿을 잠급니다.

  4. 닫기 를 클릭하여 템플릿을 종료합니다.

템플릿 삭제

템플릿이 삭제되면 동일한 템플릿 ID로 새 템플릿을 만들 수 있습니다.

기존 템플릿을 삭제하는 방법은 다음과 같습니다.

  1. Firebase 콘솔에서 AI 서비스 > AI 로직 > 프롬프트 템플릿 탭으로 이동합니다.

  2. 템플릿 목록에서 삭제할 템플릿을 찾습니다.

  3. 템플릿 행의 끝에서 > 삭제를 클릭합니다.

  4. 삭제를 확인한 후 삭제 를 클릭합니다.

템플릿 버전 관리

서버 프롬프트 템플릿에 버전 관리 시스템을 사용하는 것이 좋습니다. 다음은 몇 가지 일반적인 권장사항입니다.

  • 시맨틱 버전 관리 (semver)를 사용하는 버전이 추가된 템플릿 ID를 만듭니다 (예: my-first-template-v1-0-0).

  • Firebase Remote Config 를 사용하면 요청에서 템플릿과 기타 값을 쉽게 변경할 수 있습니다.

  • 표준 버전 관리 인프라를 사용하려면 REST API를 사용하여 템플릿을 파일로 제공 하면 됩니다.

기존 템플릿을 복제하여 다음 버전의 기반으로 사용할 수 있습니다.

  1. Firebase 콘솔에서 AI 서비스 > AI 로직 > 프롬프트 템플릿 탭으로 이동합니다.

  2. 템플릿 목록에서 복제할 템플릿을 찾습니다.

  3. 템플릿 행의 끝에서 > 복제를 클릭합니다.

  4. 새 템플릿에서 템플릿 ID를 늘려 다음 버전을 반영합니다.