AI Engineering Tools

Generative AI Engineering

AI 프롬프트 관리·운영 용어

운영 AI 시스템의 프롬프트를 등록·버전 관리·설정·승인·배포·추적·롤백·폐기하는 용어를 설명합니다.

16 개 용어

자산·레지스트리

프롬프트 자산

Prompt asset

뜻

프롬프트와 관련 메타데이터, 변수, 예시, 설정, 테스트, 소유권 정보를 묶은 관리 대상입니다.

언제 쓰나

운영 프롬프트를 출처 없는 복사 문구가 아니라 관리되는 애플리케이션 자산으로 다룹니다.

활용 예시

Asset includes template, schema, owner, model binding, test suite, risk level, and release notes.

자산·레지스트리

프롬프트 레지스트리·저장소

Prompt registry or store

뜻

프롬프트 자산을 검색하고 버전 관리하며 비교하고 가져오는 통제된 목록입니다.

언제 쓰나

운영 프롬프트가 소스 파일, 문서, 개인 메모에 흩어지는 것을 막을 때 사용합니다.

활용 예시

Search the registry by use case, owner, status, model family, and environment.

자산·레지스트리

프롬프트 ID

Prompt ID

뜻

여러 개정판에 걸쳐 하나의 논리적 프롬프트를 가리키는 안정적인 식별자입니다.

언제 쓰나

코드, 관측 정보, 승인에서는 ID를 사용하고 정확한 내용은 버전으로 구분합니다.

활용 예시

prompt_id: support.case_summary

버전 수명주기

프롬프트 버전

Prompt version

뜻

프롬프트 내용과 관련 설정의 식별 가능한 개정판입니다.

언제 쓰나

재현 가능한 평가, 배포, 사고 분석, 롤백을 위해 변경 불가능한 버전을 사용합니다.

활용 예시

support.case_summary@17 with content digest sha256:...

버전 수명주기

초안·게시 버전

Draft and published version

뜻

수정 가능한 작업 개정판과 애플리케이션에서 사용할 수 있도록 승인된 변경 불가 개정판의 구분입니다.

언제 쓰나

초안에서 반복 개선하고 필수 테스트와 승인을 통과한 뒤에만 게시합니다.

활용 예시

Draft 18 remains editable; production continues to reference published version 17.

설정

프롬프트 변수

Prompt variable

뜻

실행 시 요청별 데이터로 채우는 이름 있는 자리표시자입니다.

언제 쓰나

각 변수의 자료형, 필수 여부, 이스케이프, 길이 제한, 신뢰 수준을 정의합니다.

주의

승인된 설계에서 명시적으로 요구하고 보호하지 않는 한 프롬프트 변수에 비밀정보를 넣지 마세요.

활용 예시

Summarize {{case_notes}} for {{audience}} using {{output_schema}}.

설정

프롬프트 설정

Prompt configuration

뜻

프롬프트와 연결된 모델, 추론 파라미터, 도구 정의, 출력 스키마 등의 설정입니다.

언제 쓰나

동작을 크게 바꿀 수 있는 설정은 프롬프트 문구와 함께 버전 관리합니다.

활용 예시

Config: model family, temperature, max output, schema version, enabled tools, timeout.

설정

모델 연결

Model binding

뜻

프롬프트 버전을 설계하고 테스트한 대상 모델 또는 모델군의 명시적 연결입니다.

언제 쓰나

검증하지 않은 모델 이전으로 동작이 조용히 바뀌는 일을 막을 때 사용합니다.

활용 예시

Prompt v17 is approved for model family A version 2026-05 only.

배포

환경 승격

Environment promotion

뜻

승인된 프롬프트 버전을 개발, 스테이징, 운영 환경으로 이동하는 절차입니다.

언제 쓰나

환경마다 텍스트를 수동 복사하지 말고 동일한 변경 불가 버전을 승격합니다.

활용 예시

dev -> evaluation passed -> staging approval -> production

배포

프롬프트 배포

Prompt deployment

뜻

선택한 프롬프트 버전과 설정을 애플리케이션이나 워크플로에서 사용할 수 있게 하는 작업입니다.

언제 쓰나

식별자를 기준으로 배포하고 상태 검사, 관측, 복구 경로를 함께 준비합니다.

활용 예시

Deploy support.case_summary@17 to 10% of eligible traffic, then monitor release metrics.

배포

프롬프트 롤백

Prompt rollback

뜻

문제가 발견됐을 때 트래픽을 이전에 승인된 프롬프트 버전으로 되돌리는 절차입니다.

언제 쓰나

운영 배포 전에 롤백 절차를 준비하고 연습합니다.

활용 예시

If required-field accuracy falls below the threshold, restore version 16 without editing it.

거버넌스

프롬프트 변경 승인

Prompt change approval

뜻

정해진 용도와 환경에서 프롬프트 버전 사용을 허가하는 문서화된 검토 결정입니다.

언제 쓰나

외부 공개, 규제, 금전, 안전 관련 동작에는 위험에 비례한 승인을 요구합니다.

활용 예시

Approval records reviewer, scope, evidence, limitations, version, and expiration date.

거버넌스

프롬프트 소유 책임

Prompt ownership

뜻

프롬프트의 품질, 접근, 검토, 사고, 갱신, 폐기에 대해 지정된 책임입니다.

언제 쓰나

프롬프트를 운영에 사용하기 전에 서비스 책임자와 대체 담당자를 지정합니다.

활용 예시

Owner: Support Platform; reviewer: Compliance; next review: 2026-10-01.

거버넌스

프롬프트 감사 로그

Prompt audit log

뜻

프롬프트 변경, 승인, 배포, 접근, 롤백 이력을 변조하기 어렵게 기록한 로그입니다.

언제 쓰나

사고를 조사하고 누가 언제 무엇을 왜 바꿨는지 입증할 때 사용합니다.

활용 예시

Log actor, timestamp, prompt ID, before and after versions, action, ticket, and environment.

관측

프롬프트 실행 추적

Prompt trace

뜻

요청별 프롬프트 버전, 입력, 모델 설정, 도구 활동, 출력, 평가 신호를 연결한 기록입니다.

언제 쓰나

적절한 최소화와 접근 통제를 적용해 디버깅과 성능 분석에 사용합니다.

주의

추적 정보에는 개인정보, 기밀정보, 저작권 자료가 포함될 수 있으므로 최소화·마스킹·접근 제한·만료 정책을 적용해야 합니다.

활용 예시

trace_id links prompt v17, redacted inputs, model version, latency, token use, and validator result.

버전 수명주기

프롬프트 지원 종료

Prompt deprecation

뜻

프롬프트 버전이나 자산을 종료 예정으로 표시해 새 사용을 권장하지 않는 상태입니다.

언제 쓰나

제거 전에 이전 안내, 사용처, 종료일, 롤백 근거를 준비합니다.

활용 예시

Deprecate v12 on August 1, migrate remaining callers to v17, and archive its evaluation record.

운영 프롬프트의 최소 관리 기록

기록 항목필요한 이유
프롬프트 ID, 변경 불가 버전, 콘텐츠 해시평가나 요청에 사용된 정확한 자산 식별
모델, 파라미터, 스키마, 도구, 변수 규약동작을 재현하고 호환 요구사항 확인
담당자, 승인, 테스트 근거, 환경, 배포 시각권한, 준비 상태, 운영 책임 확인
추적 정책, 모니터링 기준, 롤백 대상사고 탐지, 진단, 복구 지원

자주 묻는 질문

프롬프트를 애플리케이션 소스 코드에만 보관하면 안 되나요?

소스 관리는 유용하지만 운영에는 프롬프트별 메타데이터, 평가 근거, 승인, 환경 승격, 요청 추적, 담당자, 지원 종료, 롤백 연결도 필요합니다. 이를 코드 주변에 구축하거나 프롬프트 레지스트리로 제공할 수 있습니다.

프롬프트 버전에 모델 설정도 포함해야 하나요?

최소한 모델 버전, 지원 파라미터, 출력 스키마, 도구 정의, 변수 규약처럼 동작을 바꿀 수 있는 설정과 의존성을 기록해야 합니다. 하나의 버전 번호로 묶을지는 구현 선택이지만 정확한 조합을 재현할 수 있어야 합니다.

프롬프트 실행 추적에 저장하지 말아야 할 정보는 무엇인가요?

불필요한 개인정보, 자격 증명, 비밀정보, 기밀 원본, 제한 없이 복제한 저작권 콘텐츠를 보관하지 않아야 합니다. 목적 제한, 마스킹, 접근 통제, 보관 기간, 삭제, 법률·계약 요건을 적용합니다.

공식 참고 자료

관련 용어 페이지