contexa-core contexa-iam contexa-autoconfigure

프롬프트 버전 관리

소스 코드를 고치지 않고 보안 판정 프롬프트를 바꾸는 법을 설명합니다. 버전은 한 번 만들면 바뀌지 않는 완전한 프롬프트 한 벌입니다. Contexa 규칙은 자물쇠로 고정되고, 나머지는 화면이나 문서에서 고치거나 지우거나 더할 수 있습니다. 세 번 누르기 흐름, 고정 부분과 바꿀 수 있는 부분, 판정에 사용과 되돌리기, 시험 판정, 먼저 적용, 함께 시험, 문서, 길이 검사, 판정의 버전이 정해지는 순서, 같은 방식으로 관리하는 판정 외 AI 프롬프트 7개를 다룹니다.

한눈에 보기

판정에 쓰는 프롬프트는 버전으로 관리합니다. 번호는 테넌트와 프롬프트마다 하나씩 늘어나는 v1.0, v2.0… 입니다. 버전마다 프롬프트 전체가 한 벌입니다. Contexa 가 낸 버전(Contexa 제공)은 모든 부분을 가지고, 우리 조직의 버전은 바탕 버전과 거기서 바꾸거나 지우거나 더한 것만 가집니다. 한 번 만든 버전은 고칠 수 없고, 바꾸면 늘 다음 번호가 생깁니다.

  • 어디서: 메뉴 "프롬프트 품질검사 → 프롬프트 버전"(/contexa/admin/prompt-quality/versions). 모든 화면과 API 에 관리자 역할이 필요합니다.
  • 무엇이 도나: 판정은 화면에서 고른 버전을 쓰고, 고르지 않았으면 설정 파일의 버전, 그것도 없으면 가장 새 Contexa 버전을 씁니다(판정의 버전이 정해지는 순서). 판정이 시작될 때 버전이 사건에 고정되므로, 한 판정의 1차 분석 · 2차 분석 · 다시 묻기는 모두 같은 버전을 씁니다. 다른 프롬프트 7개는 표지, 없으면 가장 새 Contexa 버전을 씁니다(판정 외 프롬프트 7개).
  • Contexa 몫으로 남는 것: 사용자 프롬프트의 표준 블록과 엔진이 채우는 값, 답 형식, 사유 코드, 자물쇠가 붙은 규칙. 프롬프트의 문장은 버전에서 오고, 코드에는 프롬프트 문장이 하나도 없습니다.
  • 프롬프트 고르기: 목록 화면의 "프롬프트" 고르기에 프롬프트 8개가 있습니다: 맨 앞의 "보안 판정"(cortex.security-decision)과 판정 외 프롬프트 7개(아래). 이 쪽은 다른 프롬프트를 밝히지 않으면 보안 판정을 말합니다.
세 번 눌러 새 프롬프트로쓰기 전에 시험 판정을 권하지만 꼭 해야 하는 것은 아닙니다.
  1. 1새 버전 만들기바탕은 지금 판정에 쓰는 버전
  2. 2고치고 저장저장 전 검사를 거치고, 저장하면 다음 번호가 생김
  3. 선택시험 판정봉인된 최근 판정을 두 버전으로 다시 판정, 기록만 함
  4. 3판정에 사용약 5초 안에 모든 서버가 따름

세 번 누르기 흐름

  1. 목록 화면의 "새 버전 만들기"를 누르면 지금 판정에 쓰는 버전을 바탕으로 새 버전 만들기 화면이 열립니다(/versions/new?base={번호}). 표의 줄이나 버전 보기 화면의 "새 버전 만들기"는 그 버전에서 시작합니다.
  2. 부분을 고치고 "저장"을 누릅니다. 바꿀 수 있는 부분만 열리고, 자물쇠가 붙은 부분은 "Contexa 규칙" 아래에 접혀 있습니다. "저장 전 검사"는 고칠 때마다 다시 검사하고, 통과해야 "저장"이 됩니다. 저장하면 다음 번호가 생기고 바탕은 그대로 남습니다.
  3. 새 버전 줄의 "판정에 사용"을 누릅니다. 확인 창에 "지금", "바뀔 버전", "적용"("약 5초 안에 모든 서버가 따릅니다. 이미 시작한 판정은 원래 버전으로 끝납니다."), 시험 판정을 했는지, 적을 수 있는 사유("사유(선택)", 기록에 남음)가 보입니다.

새 버전 만들기 화면의 "저장하고 바로 판정에 사용"은 2와 3을 한 번에 합니다. "저장하고 시험 판정"은 저장한 뒤 새 버전을 고른 채로 시험 판정 화면을 엽니다.

화면 다섯 개

화면주소보이는 것과 하는 일
버전 목록/contexa/admin/prompt-quality/versions카드 세 장: "지금 판정에 사용 중"(버전, 어떻게 골랐는지, 바탕, 바꾼 곳, 만든 사람), "버전"(Contexa 제공 · 우리 조직, 숨김), "시험 중"(먼저 적용 · 함께 시험 · 시험 판정). "새 제품 기본" 알림. 버전 표(번호 · 설명 · 만든 곳 · 바탕 · 만든 때 · 상태 · 작업), 쪽마다 20줄, "숨긴 버전도 보기". 줄마다 작업: 보기, 시험 판정, 판정에 사용, 새 버전 만들기. "버전 목록" 탭 옆에 버전 수가 보입니다.
버전 보기/versions/{번호}바탕보다 바꾼 곳, "시스템 프롬프트와 더한 블록"(둘을 합친 크기, 아래 줄에 더한 블록 몫), 이 버전으로 한 판정의 판정 시간(중앙값, 보안 판정은 크기 차이로 바탕과 비교한 어림도), 형식 오류 카드. 탭 세 개의 프롬프트: "시스템 프롬프트"(부분마다 표시, 바꾼 부분은 바탕 문장과 나란히), "사용자 프롬프트"(표준 블록과 이 버전이 더한 블록), "완성본 미리보기"(그린 시스템 프롬프트, 답 형식 지시, 가장 최근의 봉인된 실제 판정 한 건의 사용자 프롬프트, 아래). 최근 90일의 "이 버전으로 한 판정". 작업: 시험 판정, 문서로 내려받기, 새 버전 만들기, 판정에 사용, 숨기기.
새 버전 만들기/versions/new?base={번호}이 버전의 설명, 바탕(바꿀 수 있고, 바꾸면 지금까지 고친 내용은 사라짐), 시스템 프롬프트 부분(바탕이 넣은 준비된 부분은 "이 버전에서 빼기"로 뺄 수 있음), "부분 더하기", Contexa 가 준비한 부분, 사용자 프롬프트 블록, "조직 참고 블록 더하기", "저장 전 검사", "저장하고 바로 판정에 사용", 단추 저장 · 저장하고 시험 판정 · 취소.
시험 판정/versions/trials, 시험 하나는 /versions/trials/{id}시험 판정 시작, 진행과 결과, 최근 시험 판정, "함께 시험 결과". 보안 판정에만 있음
고급/versions/advanced문서 폴더, 가져오기와 내려받기, 일부 사용자에게 먼저 적용, 함께 시험으로 돌리기, 기록, 급히 되돌리기. "운영 담당자용 기능입니다. 버전 만들기와 판정에 사용하기에는 필요 없습니다." 보안 판정 밖의 프롬프트는 문서 폴더 · 가져오기와 내려받기 · 기록만 있음
  • 화면 주소는 ?prompt= 와 ?scope= 를 받습니다. 없으면 플랫폼 전체(PLATFORM_GLOBAL)의 보안 판정을 보입니다. 버전이 있는 테넌트가 둘 이상이면 "테넌트" 고르기가 나옵니다.
  • 완성본 미리보기의 사용자 프롬프트(보안 판정): 가장 최근의 봉인된 판정을 이 버전이 그렸으면 봉인된 그대로 보입니다("{시각} 의 실제 판정 한 건을 이 버전으로 그린 것입니다."). 아니면 그 판정의 봉인된 입력으로 이 버전에 맞게, 더한 블록까지 넣어, 지금 저장된 기준선으로 다시 그립니다: "{시각} 의 실제 판정 한 건을 봉인된 입력으로 이 버전에 맞게 다시 그린 것입니다. 모델은 부르지 않았습니다." 모델을 부르지 않으므로 감사 기록도 남지 않습니다. 다시 그릴 수 없으면 그때 그린 그대로 보이고, 옆에 이 버전이 더한 블록 목록과 이유가 나옵니다: "이 애플리케이션에는 판정 파이프라인이 없어, 판정을 그때 그린 그대로 보입니다." 또는 "이 버전으로 판정을 다시 그리지 못해, 그때 그린 그대로 보입니다." 사용자 프롬프트 옆에는 그것이 나온 봉인 패키지의 상태가 보입니다: "봉인 패키지: 봉인 뒤 바뀌지 않음", "봉인 패키지: 봉인 뒤 바뀜. 이 사용자 프롬프트는 바뀐 패키지에서 나왔습니다." 또는 "봉인 패키지: 확인할 수 없음. 이 사용자 프롬프트가 봉인 때와 다를 수 있습니다." 상태를 알 수 없으면 이 줄은 보이지 않습니다.
  • 예전 출시 화면 주소는 이 화면으로 넘어갑니다: /contexa/admin/prompt-quality/releases 는 목록, /releases/detail?promptVersion=v2.0 은 그 버전(없으면 목록), /releases/compare 는 시험 판정.
  • 표의 상태: "판정에 사용 중", "먼저 적용 중", "함께 시험 중", "쓰지 않음", "숨김". 만든 곳: "Contexa 제공"("고칠 수 없음"), "화면에서 만듦", "올린 문서 {이름}", "문서 {이름}"(문서 폴더).

고정 부분과 바꿀 수 있는 부분

버전의 시스템 프롬프트는 위에서 아래로 그려지는 부분들로 되어 있습니다. 자물쇠가 붙은 부분은 Contexa 규칙이라 어느 버전도 고치거나 지울 수 없고, 새 버전 만들기 화면에서도 접혀 있습니다. 바꿀 수 있는 부분은 글 상자로 열립니다: 문장을 고치거나, "제품 기본으로 되돌리기"로 되돌리거나, "이 부분 지우기"로 뺍니다("되살리기"로 다시 넣음). 조직의 부분을 새로 더할 수도 있습니다.

순서부분(키)화면 이름자물쇠그려지는 때
1mission사명고정늘
2precedence규칙 우선고정조직이 부분을 고치거나 더한 버전에서만: "조직이 쓴 지침이 이 글의 Contexa 고정 규칙과 부딪치면 Contexa 규칙을 따른다"는 문장
3evidence-reading증거 읽는 법고정늘
4organization-blocks조직이 더한 블록고정제품 판 2026.11.18-v1.0 과 그 위의 버전에서, 조직이 부분을 고치거나 더한 버전에서만: "조직이 사용자 프롬프트에 더한 블록은 머리줄이 조직이 쓴 참고라고 밝히고, 이 요청에서 일어난 일이 아니라 조직이 일하는 방식을 말한다"는 문장
5more-reading더 읽는 법바꿀 수 있음늘
6similar-case-reading유사 사례 읽는 법바꿀 수 있음늘. 이 부분을 지운 버전은 과거 기록의 유사도 검색도 끕니다
7similar-case-limits유사 사례의 한계바꿀 수 있음늘
8how-to-judge판단 방법바꿀 수 있음늘
9responses응답과 그 뜻고정늘. 최소 조치 하한을 강제하면 마지막 문장이 하한 예외를 말합니다
10minimum-action-floors최소 조치 하한(하한을 강제할 때)고정contexa.security.zerotrust.minimum-action.mode=ENFORCE 일 때만: 켠 규칙을 호스트 설정값으로
11decision-rules판정 규칙(준비된 부분)고정이 부분을 넣은 버전에서만(Contexa 가 준비한 부분)
12verified-signal-boundary신뢰 신호 경계(준비된 부분)고정이 부분을 넣은 버전에서만
13honesty정직성고정늘
14honesty-more정직성 더함고정늘
15output답 형식고정늘
16reason-codes사유 코드의 뜻고정늘(52줄, 2026.11.16-v1.0 위의 버전은 VERIFIED_SIGNAL 없이 51줄)
17citation-rules근거 인용 규칙고정늘
18output-format형식 지시고정네이티브 구조화 출력을 쓰지 않는 모델 호출에서만
  • 더한 부분의 자리: 사명부터 정직성 더함까지 가운데 고른 부분 뒤에 들어갑니다("더한 부분은 정직성 더함 뒤까지의 자리에 들어갑니다. 답 형식은 늘 맨 끝입니다."). 15~18은 늘 맨 끝에 둡니다. 모델은 끝에 가까운 형식 지시를 잘 따르기 때문입니다. 더한 부분은 목록을 가르지 않고, 고른 부분에 이어지는 부분들 뒤에 놓입니다.
  • 규칙 우선: 조직이 고치거나 더한 부분이 있는 버전에는 사명 바로 뒤에 규칙 우선 문장이 들어갑니다. 부분을 지우기만 하거나 준비된 부분만 넣은 버전에는 들어가지 않으므로, 제품 기본 그대로인 프롬프트는 바뀌지 않습니다. 제품 판 2026.11.18-v1.0 과 그 위의 버전에는 같은 때 증거 읽는 법 바로 뒤에 "조직이 더한 블록" 문장도 들어갑니다.
  • 사용자 프롬프트: 표준 블록 8개(사용자 기준선, 세션, 요청, 기록과 비교, 과거 기록(RAG), 모르는 것, 믿을 수 없는 글, 2차 판단)는 모두 고정입니다. 블록 제목 · 줄 이름 · 순서 · 사실 ID · 값은 엔진의 몫이고, 판정마다 엔진이 채웁니다. "조직 참고 블록 더하기"는 고른 표준 블록 뒤에 조직의 블록(제목과 내용)을 넣습니다. 더한 블록은 다음 버전에서 고치거나 지울 수 있습니다. 고친 블록도 조직이 더한 블록으로 남아, 그 뒤의 모든 버전에서 더한 자리에 같은 머리줄로 그려지고 길이 · 크기 · 판정 시간 어림에 셉니다. 지운 블록은 빠집니다. 버전의 내용 해시는 그대로입니다.
  • 더한 블록이 그려지는 모양: 보안 판정 프롬프트(1차 분석 · 2차 분석 · 다시 묻기 · 재생)에서 그 블록이 뒤따르는 표준 블록 바로 뒤에, 빈 줄 다음 머리줄 === 제목 (reference written by your organization) === 아래 그립니다. 사실 ID 가 붙지 않아 모델이 사실로 인용할 수 없습니다. 표준 블록의 머리줄처럼 읽힐 수 있는 제목이나 줄은 따옴표로 감싸 그립니다.
  • 버전 보기 화면의 표시: "자물쇠 · 고정", "기본 그대로", "바탕 그대로", "바꿈"(바탕 문장과 나란히 보임), "지움", "더함", "준비된 부분 넣음", "조건부".

Contexa 가 준비한 부분

두 부분은 제품 기본 문서에 있지만, 버전이 넣기 전에는 어느 버전에도 들어가지 않습니다. 새 버전 만들기 화면의 "Contexa 가 준비한 부분 {n}개" 아래에 측정 결과와 "넣기" 단추와 함께 있습니다. 넣은 뒤에는 고정 부분이라 문장을 고칠 수 없습니다. 그 버전을 바탕으로 만드는 버전에는 "바탕 버전이 넣은 준비된 부분입니다. 다음 버전에서 뺄 수 있습니다."와 "이 버전에서 빼기" 단추가 보입니다("다시 넣기"로 되돌림).

부분더해지는 것화면 표시
판정 규칙(준비된 부분) decision-rules판단보다 먼저 보는 규칙: 필수 차단(BLOCK) 경계, 필수 저위험 경계, 필수 업무 충족 경계, 높은 위험 경계. 사용자 프롬프트에 엔진의 결론 줄 두 개 DeviationsExplained · PolicySatisfied 도 들어갑니다. 필수 차단 경계는 DataConflicts 가 테넌트 · 조직 충돌을 말할 때와 TenantMatch 가 테넌트가 다르다고 말할 때 모두 서고, 이 부분을 넣은 버전에서는 사유 코드 TENANT_CONFLICT 가 TenantMatch 줄도 인용할 수 있습니다. 한 번 고쳐 물은 뒤에도 경계를 어긴 답은 그 경계가 정한 조치로 바뀝니다. 에이전트 요청에는 자동화 범주를 뺀 문장이 들어갑니다."권장하지 않음", 함께 보이는 문장: "60사례 측정(기준 v1.0): 근거 정확도 77.2% → 52.2%(25점 낮음), 놓침 40.0% → 42.2%, 허용 조치 적중 70.0% → 68.3%, 유력 가설 25.0% → 38.3%, 답 토큰 132 → 118. 확인된 악성 신호 통제 10건에서 차단 8건 → 0건."
신뢰 신호 경계(준비된 부분) verified-signal-boundary"VerifiedSignal 이 확인된 해롭거나 악의적인 활동을 알리면, 더 강한 사실이 그 관찰을 뒤집지 않는 한 BLOCK 을 고른다"는 경계. VerifiedSignal 줄 자체는 모든 버전의 사용자 프롬프트에 들어가고, 이 부분은 경계만 더합니다. 응답 검사는 이 부분이 없는 버전에서도 그 줄이 있는 BLOCK 을 결정적 증거가 있는 차단으로 봅니다. 그 줄은 사유 코드 VERIFIED_SIGNAL(화면 이름 "서버가 확인한 신호")이 인용하고, 줄이 서버 자신의 검증 출처의 신호를 말할 때만 맞는 인용입니다(2026.11.18-v1.0 과 그 위의 버전)."주의: 낮은 지표 1개", 함께 보이는 문장: "60사례 측정(기준 v1.0): 놓침 40.0% → 35.6%, 허용 조치 적중 70.0% → 73.3%, 근거 정확도 77.2% → 76.7%(인용 1개 차이), 유력 가설 같음. 확인된 악성 신호 통제 10건에서 차단 8건 → 9건."

측정 결과

2026-11-16 에 기본 설정의 제품 기본 v1.0 을 기준으로 쟀습니다. 같은 60사례(외부인 · 내부자 · 정상 업무 · 자동화 각 15)를 한 번씩 다시 판정하고, 서버가 확인한 악성 신호를 넣은 통제 사례 10건을 더했습니다(60사례에는 확인된 신호가 없습니다). 어느 지표도 기준보다 낮지 않은 부분만 "권장"으로 보이고, 낮은 지표가 있는 부분은 그 숫자와 경고를 함께 보입니다.

지표v1.0 기본판정 규칙을 넣은 버전신뢰 신호 경계를 넣은 버전
놓침40.0%42.2%35.6%
근거 정확도77.2%52.2%76.7%
허용 조치 적중70.0%68.3%73.3%
유력 가설 = 정답25.0%38.3%25.0%(같음)
오탐 · 모델 없이 정함 · 다시 묻기0 · 0 · 00 · 0 · 0(같음)—
답 토큰132118—
통제 10건의 차단809

판정 규칙은 근거 정확도를 25점 낮추고 확인된 악성 신호를 하나도 차단하지 않아 "권장하지 않음"입니다. 신뢰 신호 경계는 지표 하나가 0.5점(인용 1개, 잡음 범위) 낮아 숫자와 경고를 함께 보입니다. "—"는 그 부분에 보고된 값이 없는 지표입니다.

저장 전 검사

화면에서 저장하는 버전, 올린 문서, 문서 폴더의 문서에 같은 검사가 걸립니다. 하나라도 걸리면 저장하지 않고 고칠 곳을 모두 보입니다.

화면의 검사거부하는 것
고정 부분을 건드리지 않았습니다고정 부분이나 준비된 부분을 고침, 고정 부분을 지움("Contexa 규칙이라 고치거나 지울 수 없습니다")
모든 부분과 자리가 바탕에 있습니다바탕에 없는 부분, 놓을 수 없는 자리, Contexa 가 준비하지 않은 부분 넣기
모든 부분에 제목과 내용이 있고, 표준 블록과 같은 제목이 없습니다제목 없는 더한 부분, 내용 없는 더한 · 고친 부분, 같은 이름의 부분 둘. 보안 판정에서는 사용자 프롬프트에 더하거나 제목을 새로 단 블록의 제목이 표준 블록의 제목(REQUEST 등, 대소문자와 상관없이, 뒤에 괄호 말이 붙어도 같음)과 같은 것: "{블록}: 제목 "{제목}" 은 표준 블록의 제목과 같아 쓸 수 없습니다. 다른 제목을 쓰십시오."
모델 문맥 길이({n}토큰) 안에 들어갑니다가장 긴 최근 입력과 답을 더한 완성 프롬프트가 들어가지 않음(길이). 보안 판정에만
  • 문서는 YAML 로 읽을 수 없을 때, 문서 형식에 없는 칸이 있을 때, 꼭 있어야 하는 칸이 없을 때, 다른 프롬프트의 문서일 때, 완성본 문서(kind: rendered)일 때, 이 서버에 없는 바탕을 가리킬 때("바탕 버전이 이 서버에 없습니다")에도 거부됩니다.
  • 문서에서 온 버전(올린 문서 · 문서 폴더)은 화면에서 만드는 버전의 바탕이 될 수 없습니다: "{버전} 은 문서에서 온 버전이라 화면에서 바탕으로 쓸 수 없습니다. 원본 문서를 고치면 다음 번호로 다시 등록됩니다." 두 편집 길이 부딪치지 않게 하기 위해서입니다.
  • 표준 블록과 같은 제목을 거부하는 검사는 저장만 막습니다. 이 검사가 생기기 전에 저장된 버전은 그대로 조립되고, 그런 제목은 따옴표로 감싸 그립니다.
  • 검사 옆에 거부하지 않는 정보도 보입니다: 바탕보다 늘거나 준 시스템 프롬프트와 더한 블록의 토큰, 판정 시간이 대략 얼마나 늘거나 주는지, "저장한 뒤 판정에 쓰기 전에 시험 판정으로 최근 판정과 비교하기를 권합니다."

길이가 판정 시간과 문맥 길이에 주는 영향

프롬프트가 길수록 판정 시간이 늘고 모델의 문맥 길이를 더 씁니다. 저장 전 검사는 시스템 프롬프트를 어림해 들어가지 않는 보안 판정 버전을 거부합니다.

  • 토큰: 버전이 그리는 모든 부분의 글자 수의 4분의 1입니다. 부분마다 가장 긴 문장(어느 조건이든), 제목 줄, 줄 항목까지 셉니다. 넣지 않은 준비된 부분은 세지 않습니다. 제품 기본 v1.0 은 약 4,100 토큰입니다. 버전이 사용자 프롬프트에 더한 블록도 프롬프트가 그리는 대로 셉니다: 보안 판정은 머리줄까지, 다른 프롬프트는 제목까지. 판정마다 엔진이 채우는 값은 세지 않습니다.
  • 한도: 버전의 시스템 토큰 + 입력 + 답 토큰(contexa.security.tiered.layer1.max-output-tokens, 기본 4096 과 layer2.max-output-tokens, 기본 2560 가운데 큰 값)이 1차 분석 모델의 문맥 길이를 넘으면 안 됩니다. 입력은 최근 판정 500건 가운데 가장 긴 사용자 프롬프트에 새 버전의 더한 블록을 모두 더한 것입니다. 판정마다 그 판정이 실제로 쓴 버전으로 잽니다: 프롬프트 토큰에서 그 버전의 시스템 토큰과 그 버전이 그린 더한 블록을 빼고, 그렇게 남은 것이 가장 긴 판정을 고릅니다. 새 버전의 더한 블록은 바탕과 상관없이 모두 셉니다. 기록된 버전을 찾지 못한 판정은 제품 기본으로 잽니다. 최근 판정이 없으면 새 버전의 더한 블록 전체입니다. 화면 · 문서 폴더 · 올리기 모두 같게 셉니다.
  • 모델의 문맥 길이: Ollama 모델이면 contexa.llm.model-capabilities.ollama.max-context-length(기본 32768, 4096 보다 작으면 기본값)입니다. 1차 분석 모델을 알 수 없으면 Ollama 값을 씁니다. 다른 공급자의 모델은 문맥 창을 밝히는 설정이 있어야 문맥 길이가 생기는데, 지금은 그런 설정이 없어 문맥 길이를 모르는 것으로 보고 길이를 검사하지 않습니다("모델 문맥 길이를 알 수 없어 길이는 검사하지 않았습니다").
  • 판정 시간: 바탕과의 토큰 차이(시스템 프롬프트와 더한 블록)에 최근 판정 200건의 입력 토큰당 판정 시간 중앙값을 곱합니다. 저장 전 검사와 버전 보기의 판정 시간 카드(보안 판정)에 보입니다. 판정이 없으면 보이지 않습니다.

판정에 사용, 되돌리기, 숨기기

  • 판정에 사용은 화면의 표지를 출시 관문을 거쳐 그 버전으로 옮기고, 앞서 쓰던 버전은 "쓰지 않음"이 됩니다. 시험 판정을 하지 않은 버전도 막지 않습니다: 확인 창에 "시험 안 함"과 "이 버전으로 시험 판정을 하지 않았습니다. 판정에 쓰기 전에 시험 판정을 권합니다."가 보입니다(관문의 경고 TRIAL_RECOMMENDED). 관문이 막는 것은 숨긴 버전, 판정에 쓰는 버전이 하나도 남지 않게 되는 이동, 제품의 프롬프트 주입 방어를 지키지 않는 버전, 제품이 모델 · 예산 · 토큰 계산 · 캐시 · 압축 정책을 밝히지 않은 프롬프트입니다. 그때 확인 창에 "막힘"과 이유가 보이고 아무것도 바뀌지 않습니다. 표지는 60초 동안 캐시하고 무효화를 5초마다 확인하므로 약 5초 안에 모든 서버가 따릅니다. 이미 시작한 판정은 원래 버전을 지킵니다.
  • 되돌리기는 예전 버전의 "판정에 사용"입니다: "되돌리기: 예전 버전의 "판정에 사용"을 누르면 약 5초 안에 모든 서버에 적용됩니다. 한 번 만든 버전은 고칠 수 없고, 바꾸려면 "새 버전 만들기"로 다음 번호를 만듭니다."
  • 옮길 때마다 누가 · 언제 · 무엇을 · 왜를 기록과 감사 로그(범주 PROMPT_VERSION_CHANGED, 동작 PROMPT_VERSION_*)에 남깁니다.
  • 숨기기(버전 보기 화면, 상태가 "쓰지 않음"인 버전): "목록에서만 감춥니다. 내용은 지우지 않고, 판정 기록과 봉인 증거는 계속 이 버전을 가리킵니다." 판정에 사용 중이거나 먼저 적용 · 함께 시험 중인 버전은 숨길 수 없고, 숨긴 버전은 판정에 쓰거나 시험하거나 되돌아갈 대상으로 고를 수 없습니다. 숨긴 버전은 "숨긴 버전도 보기"로 봅니다.

판정의 버전이 정해지는 순서

판정이 시작되면 아래 순서로 버전을 정하고 사건에 고정합니다.

  1. 화면 표지: 요청이 드는 먼저 적용, 아니면 판정에 사용 중인 버전. 요청한 테넌트의 것을 보고, 없으면 플랫폼 전체(PLATFORM_GLOBAL)의 것을 봅니다. 목록에는 "화면에서 고름"(또는 "먼저 적용")으로 보입니다.
  2. 설정 contexa.security.tiered.prompt-bundle.active 가 있고 숨기지 않은 버전(v2.0. 2 · v2 도 같게 읽음)을 가리킬 때 그 버전. 판정마다 다시 읽으므로, 가리킨 버전이 나중에 생기면 그때부터 씁니다. "설정 파일로 고름"으로 보입니다. 이 설정은 보안 판정에만 적용됩니다.
  3. 가장 새 Contexa 제공 버전. "Contexa 기본"으로 보입니다.
  • 설정이 없는 버전이나 숨긴 버전을 가리키면 경고 로그를 한 번 남기고, 그 버전이 생길 때까지 건너뜁니다. 옛 판 이름(2026.10.24-v19.21 등)을 가리키면 경고 로그를 한 번 남기고("옛 판은 없어졌다"), 설정이 비어 있는 것처럼 위 순서를 따릅니다.
  • 제품 기본을 등록해도 표지는 생기지 않습니다. 표지는 관리자가 "판정에 사용"을 눌렀을 때만 생기므로 설정과 기본이 뜻대로 돕니다.
  • 버전이 있는지와 가장 새 Contexa 버전은 1분에 한 번까지만 읽습니다. DB 를 읽지 못하면 마지막으로 읽은 값을, 그것도 없으면 빌드의 제품 기본 문서(2026.11.18-v1.0)를 씁니다.
  • 사건 메타데이터에 promptBundleSelection.version · .source · .contentHash 가 남습니다. 1차 분석 · 2차 분석 · 다시 묻기 · 함께 시험의 판정 쪽이 모두 여기서 버전을 읽으므로, 표지를 옮겨도 이미 시작한 판정은 바뀌지 않습니다.

새 제품 기본

  • 처음 설치해 처음 뜰 때 빌드의 가장 새 제품 기본이 v1.0 으로 등록됩니다. 업그레이드하면 더 새 제품 기본을 차례로 다음 번호로 등록합니다. 판정에 쓰는 버전은 저절로 바뀌지 않습니다.
  • 지금 쓰는 버전이 우리 조직의 것이고 더 오래된 제품 기본 위에 있으면, 목록에 "새 제품 기본" 알림이 보입니다: "Contexa 가 새 제품 기본 {새 버전} 을 냈습니다. 지금 쓰는 {쓰는 버전} 은 그대로 돌아갑니다. 새 규칙을 쓰려면 내 변경을 새 바탕으로 옮기십시오."
  • 지금 쓰는 버전이 예전 Contexa 제공 버전이면 옮길 변경이 없습니다: 알림은 "Contexa 가 새 제품 기본 {새 버전} 을 냈습니다. 지금 쓰는 {쓰는 버전} 은 그대로 돌아갑니다. 새 규칙을 쓰려면 {새 버전} 을 판정에 사용하십시오."이고, "바뀐 점 보기" 옆에 "판정에 사용" 단추가 있습니다.
  • 이 빌드의 보안 판정 제품 기본은 2026.11.18-v1.0 입니다. 2026.11.16-v1.0 에 고정 부분 "조직이 더한 블록"(고정 부분과 바꿀 수 있는 부분)을 더한 것이고, 이 부분은 조직이 고치거나 더한 버전에서만 그려집니다. 사유 코드 VERIFIED_SIGNAL(서버가 확인한 신호)도 THREAT_MATCH 다음에 더해, 제품 기본 그대로의 프롬프트는 그 코드 줄과 VerifiedSignal 줄의 쓰임 설명만 다릅니다. 2026.11.16-v1.0 도 그대로 들어 있고, 그것을 등록한 설치는 업그레이드할 때 2026.11.18-v1.0 을 다음 번호로 등록합니다.
  • "새 바탕으로 옮기기"를 누르면 새 제품 기본을 바탕으로, 내 변경을 얹은 새 버전 만들기 화면이 열립니다: "옮긴 변경 {n}개, 옮길 수 없는 변경 {m}개". 옮기는 변경은 지금 버전과 그 바탕을 따라 내려가는 조직 버전들이 제품 기본에 한 변경 전부입니다: 고친 부분(마지막 제목과 문장), 더한 부분과 블록(뒤에 고쳤든 아니든, 그 자리와 함께), 넣은 준비된 부분, 지운 부분. 새 바탕이 받을 수 없는 변경은 "옮길 수 없음: {부분} ({변경}) — 새 바탕에 그 부분이 없거나 고칠 수 없게 되었습니다."로 보입니다. 저장해야 버전이 되고, 초안은 따로 남지 않습니다.

시험 판정

"새 버전을 판정에 쓰기 전에 최근 실제 판정으로 비교합니다. 다시 판정은 기록만 하고 사용자에게 적용하지 않습니다."

  1. "시험할 버전", "비교할 버전"(지금 판정에 쓰는 버전에는 "(지금)"이 붙음), "다시 판정할 건수"(최근 20 · 50 · 100건)를 고릅니다.
  2. "시험 판정 시작"을 누릅니다. 최근 봉인 판정(테넌트를 골랐으면 그 테넌트의 것)을 두 버전으로 한 번씩 다시 판정합니다: "모델을 건마다 두 번 부릅니다. 실제 판정이 기다리면 그 뒤에 섭니다. 봉인은 표본이라 건수보다 적으면 있는 만큼 합니다."
  3. 결과에 카드 네 장과 자세한 내용이 보입니다.
카드 · 구역뜻
조치가 같음두 버전이 같은 조치로 답한 판정의 수
형식 오류"첫 답이 답 형식을 어겨 다시 물었거나 쓸 수 있는 답이 없던 판정입니다. 규칙 위반으로 다시 물은 것은 세지 않습니다."
판정 시간(평균)버전마다 다시 판정 한 번의 평균 시간
답 길이(평균)버전마다 답 토큰의 평균
조치 분포버전마다 ALLOW · CHALLENGE · ESCALATE · BLOCK 과 "답 없음"
달라진 판정두 버전의 조치가 달랐던 판정 최대 100건(시각 · 사용자, 대상, 두 조치, 시험한 버전의 이유). 누르면 판정 상세가 열림
  • 적용 · 학습 · 봉인은 하지 않고, 답은 시험 판정의 표에만 남습니다. 모델을 부르므로 판정 건수의 두 배만큼 비용이 듭니다.
  • 시험 판정은 프롬프트마다 한 번에 하나씩, 전용 스레드에서 돌고, 모델 호출은 모델 관문에서 실제 판정 뒤에 섭니다. "취소"로 멈출 수 있고, 서버가 멈춰 끝나지 못한 시험은 서버가 다시 뜰 때 실패로 표시됩니다.
  • 결과에서 "일부 사용자에게 먼저 적용"과 "{버전} 을 판정에 사용"으로 이어집니다. "판정에 사용" 확인 창은 그 버전의 마지막 시험 판정을 보이거나, 시험 판정을 권합니다.
  • 시험 판정은 보안 판정에만 있습니다. 다시 판정할 입력이 보안 판정의 봉인 판정이기 때문입니다.

일부 사용자에게 먼저 적용

고급 화면에서 버전, "사용자 비율"(10 · 25 · 50%), "대상 테넌트"(비우면 전체 · 쉼표로 여럿), "대상 주소 시작 또는 자원 ID"(예: /api/payments, 비우면 전체)를 고르고 "먼저 적용 시작"을 누릅니다.

  • "같은 사용자는 늘 같은 쪽에 듭니다. 나머지 사용자는 판정에 사용 중인 버전으로 판정합니다." 어느 쪽인지는 사용자(없으면 세션, 그것도 없으면 사건)의 해시로 정합니다.
  • 요청의 테넌트가 적은 테넌트 가운데 하나이고, 자원 주소가 적은 값 가운데 하나로 시작하거나 자원 ID 가 같을 때 요청이 먼저 적용에 듭니다. 비운 칸은 전체입니다. 그 판정에는 출처 CANARY 가 남습니다.
  • 먼저 적용은 한 번에 한 버전만 하고, "그만두기"로 끝냅니다. 시작과 그만은 기록에 남습니다.

함께 시험으로 돌리기

고급 화면에서 시험 버전, "표본 비율"(5 · 10%), "하루 한도"(1~10,000)를 고르고 "시험 시작"을 누릅니다. "모델을 한 번 더 부릅니다. 결과는 기록만 하고 사용자에게 적용하지 않습니다. 판정 버전과 같은 버전은 돌리지 않습니다."

  • 표본에 든 요청은 판정 전에 복사해 두고, 판정이 끝난 뒤 함께 시험 버전으로 따로 분석합니다. 복사본은 SHADOW 단계로 봉인되고, 집행하거나 학습하지 않습니다.
  • 그림자 실행기는 판정을 봉인하는 설치면 늘 있고, 함께 시험 버전이 생기기 전에는 아무것도 돌리지 않습니다. 화면에서 고른 표본 비율과 하루 한도는 그 버전의 레지스트리 행에 남고 화면의 "지금:" 줄에 보입니다. 행에 값이 없으면 설정 contexa.security.tiered.prompt-bundle.shadow.sample-percent · .daily-call-cap 을 씁니다(설정). 하루 한도는 서버마다 UTC 하루의 그 버전 실행 횟수입니다. 판정이 같은 버전으로 도는 요청은 다시 돌리지 않습니다.
  • 시험 판정 화면의 "함께 시험 결과"는 "기간"(1 · 7 · 30 · 90일, 기본 7일) 안의 함께 시험을 그 요청의 판정과 짝지어 보입니다: "함께 시험한 요청", "판정과 짝지은 요청", "조치가 달랐던 요청", 바뀐 조치, "봉인 판정의 점검 결과(버전 · 단계 · 조치별)"(봉인 · 실패 · 통과 · 미점검), 짝지은 요청 최대 50건(조치가 달랐던 것 먼저). 요청마다 "판정 봉인" · "함께 시험 봉인"을 누르면 봉인 프롬프트 화면이 열립니다. 함께 시험을 그만둔 버전의 결과도 기간 안에서는 남습니다.
  • 함께 시험은 한 번에 한 버전만 하고, "그만두기"로 끝냅니다.

급히 되돌리기와 기록

  • 급히 되돌리기(고급 화면): "되돌아갈 버전"을 고르고 사유를 씁니다. "급히 되돌리기는 바로 적용되고, 다른 관리자가 승인해야 끝납니다." 되돌린 사람은 승인할 수 없습니다.
  • 되돌리기 표에는 시각 · 버전 · 누가 · 상태("적용됨", "승인 대기", "승인됨", "거절됨", "요청 부족") · 승인이 보이고, 승인을 기다리는 되돌리기에는 "승인" 단추가 있습니다.
  • 기록은 그 프롬프트의 버전에 한 일을 새것부터 최대 50건 보입니다: 만듦, 숨김, 올림, 문서 폴더에서 등록, 판정에 사용, 먼저 적용 시작 · 그만, 함께 시험 시작 · 그만, 급히 되돌림, 되돌리기 승인, 시험 판정 시작 · 취소, 그리고 누가와 사유. "감사 기록에도 같은 내용이 남습니다".

가져오기와 내려받기

버전을 다른 서버로 옮기거나 형상 관리에 둘 때 문서를 씁니다.

  • 내려받기(버전 보기의 "문서로 내려받기", 또는 고급 화면): "바꾼 것만(다시 올릴 수 있음)"은 바탕을 번호와 내용 해시(basedOn · basedOnHash)로 적은 조직 문서를 씁니다. "완성본(확인용)"은 버전이 그리는 모든 부분을 kind: rendered 표시와 함께 쓰고, 올릴 수 없습니다. 파일 이름은 cortex.security-decision-v2.0.yaml(완성본은 -full.yaml)입니다.
  • 올리기("버전 문서 올리기"): 문서는 저장 전 검사를 거쳐 다음 번호가 됩니다. "바탕은 내용 해시로 찾으므로 서버마다 번호가 달라도 됩니다." 바탕은 basedOnHash 의 내용 해시를 가진 버전이고, 없으면 basedOn 번호의 버전입니다. 같은 파일 이름에 같은 내용을 다시 올리면 이미 있는 그 버전입니다.
  • 문서 형식은 부록에 있습니다.

문서 폴더

설정 contexa.prompt.versions.directory 에 폴더를 지정하면 서버마다 뜰 때와 그 뒤 1분마다 폴더를 읽습니다.

  • 폴더 바로 아래의 .yaml · .yml 파일(최대 1,000,000바이트)마다 플랫폼 전체의 버전 문서입니다. 아직 등록되지 않은 문서나 내용이 바뀐 문서는 다음 번호로 저장되고, 같은 문서를 다시 읽거나 다른 서버가 읽어도 이미 있는 그 버전입니다.
  • 저장할 수 없는 문서는 등록하지 않고, 이유를 읽은 기록과 경고 로그에 남깁니다.
  • 고급 화면에 폴더, 설정, "마지막으로 읽음"(언제 · 문서 몇 개), "마지막 등록", 등록하지 못한 문서와 이유, "지금 다시 읽기"가 보입니다. 설정이 없으면: "설정 contexa.prompt.versions.directory 에 폴더를 지정하면 켜집니다."
  • 폴더에서 온 버전을 바꾸려면 그 파일을 고칩니다. 다음 번호로 다시 등록됩니다.

판정 외 프롬프트 7개

AI 프롬프트 7개도 같은 장치(문서 · 표 · 해석기 · 조립기 · 화면)로, 프롬프트 키만 달리해 버전으로 관리합니다. 목록 화면의 "프롬프트"에서 고릅니다(?prompt= 에 그 키). 프롬프트마다 고정 부분과 바꿀 수 있는 부분을 가진 제품 기본 문서가 있고, 처음 뜰 때 가장 새 제품 판이 v1.0 으로 등록됩니다: 정책 만들기는 2026.11.18-v1.0, 나머지는 2026.11.17-v1.0.

화면 이름프롬프트 키쓰는 기능제품 기본 문서
정책 만들기PolicyGenerationAI 정책 생성(POST /contexa/admin/api/ai/policies/generate, AI 모드)contexa-iam: prompt-versions/{키}/2026.11.17.yaml
정책 만들기(실시간)PolicyGenerationStreamingAI 정책 생성의 실시간 답(POST /contexa/admin/api/ai/policies/generate/stream)
조건 템플릿ConditionTemplate조건 템플릿 생성(조건 템플릿)
자원 이름 제안ResourceNaming자원 등록부가 찾은 자원의 이름 제안
검색어 바꾸기(행동)BehaviorQueryTransformRAG 의 행동 검색(RAG)contexa-core: prompt-versions/{키}/2026.11.17.yaml
검색어 바꾸기(위험)RiskQueryTransformRAG 의 위험 검색
검색어 바꾸기(정책)PolicyQueryTransformRAG 의 정책 검색

호출이 버전을 얻는 법

  • 호출마다 그 프롬프트의 표지(화면의 "사용")가 가리키는 버전을 그리고, 표지가 없으면 가장 새 Contexa 제공 버전을 그립니다(PromptVersionInUse). 설정 contexa.security.tiered.prompt-bundle.active 는 보안 판정에만 적용됩니다.
  • 한 요청 안의 시스템 프롬프트 · 사용자 프롬프트 · 실행 기록은 같은 버전으로 그립니다(PromptVersionPin). 그사이 표지를 옮겨도 한 호출에 두 버전이 섞이지 않습니다. 실행 기록에는 버전 이름과 내용 해시가 남습니다.
  • 콘솔의 DB 가 없거나 읽지 못하면 빌드의 제품 기본 문서를 그립니다.

화면에서 다른 점

  • "판정에 사용" 대신 "사용", "판정에 사용 중" 대신 "사용 중", 목록 카드는 "지금 사용 중"입니다: "되돌리기: 예전 버전의 "사용"을 누르면 약 5초 안에 모든 서버에 적용됩니다. 한 번 만든 버전은 고칠 수 없고, 바꾸려면 "새 버전 만들기"로 다음 번호를 만듭니다."
  • "시험 판정" 탭은 보안 판정에만 보입니다. 다시 판정할 입력이 보안 판정의 봉인 판정이기 때문입니다. 고급 화면에서 다른 프롬프트는 문서 폴더 · 가져오기와 내려받기 · 기록을 쓰고, 일부 사용자에게 먼저 적용 · 함께 시험으로 돌리기 · 급히 되돌리기는 보안 판정에만 있습니다.
  • 버전 보기의 완성본 미리보기는 정해진 예시 입력으로 그립니다: "이 프롬프트는 실제 호출 기록을 남기지 않으므로, 정해진 예시 입력으로 이 버전을 그린 완성본입니다."
  • 저장 전 검사에 길이 검사가 없습니다. 길이 한도는 판정 모델의 문맥과 가장 긴 최근 판정 입력으로 정하기 때문입니다.
  • "사용"도 "판정에 사용"과 같은 출시 관문을 거칩니다. 기동할 때 여덟 프롬프트 모두의 제품 문서가 모델 · 예산 · 토큰 계산 · 캐시 · 압축 정책을 밝혔는지 확인하고, 하나라도 없으면 관문이 시작되지 않습니다. 이 프롬프트들의 버전은 그 정책을 물려받으므로 그 이유로는 막히지 않습니다. 프롬프트 주입 방어는 보안 판정만 확인합니다. 빌드에 제품이 없는 프롬프트는 여전히 막힙니다.

정책 만들기

정책 만들기에는 제품 판이 둘 있습니다: 2026.11.17-v1.0 과 2026.11.18-v1.0(contexa-iam: prompt-versions/PolicyGeneration/2026.11.18.yaml). 새 판은 자료가 없는 요청의 "자료" 부분에 null 이라는 낱말 대신 "No IAM data or similar query patterns were provided." 를 그립니다. 2026.11.17-v1.0 과 그 위에 만든 버전은 전처럼 null 을 그립니다. 2026.11.17-v1.0 을 등록한 설치는 업그레이드할 때 새 판을 다음 번호로 등록하고, 쓰는 버전은 저절로 바뀌지 않습니다. 정책 만들기처럼 보안 판정 밖의 일곱 프롬프트는 버전 표 없이도 빌드에 든 제품 판을 각자의 판 이름으로 찾으므로, 앞 판 이름을 가리키는 요청도 그 판을 그립니다. 보안 판정은 버전 표 없이는 최신 제품 판만 그 판 이름이나 묶음 이름으로 찾고, 앞 판은 기동 때 등록한 버전 표에서 읽습니다.

목록부분(키)문서의 제목화면 이름자물쇠그려지는 때
시스템roleRole역할고정늘
시스템precedencePrecedence규칙 우선고정조직이 부분을 고치거나 더한 버전에서만
시스템scopeWhat to generate만들 것바꿀 수 있음늘
시스템rules-idsIdentifiers주어진 ID 만 쓰기고정늘
시스템rules-guidanceLeast privilege and compliance최소 권한과 준수바꿀 수 있음늘
시스템rules-fieldsFields of the answer답의 필드 규칙고정늘
시스템rules-methodsHTTP methodsHTTP 방식과 권한바꿀 수 있음늘
시스템rules-permission-idsNo permission identifiers권한 ID 넣지 않기고정늘
시스템rules-contextExisting policies and role hierarchy기존 정책과 역할 계층바꿀 수 있음늘
시스템output-formatOutput format형식 지시고정늘 · 답 형식이라 맨 끝
시스템schemaSchema답 구조 예시고정늘 · 답 형식이라 맨 끝
사용자requirementsNatural language requirements자연어 요구고정늘
사용자available-itemsAvailable items쓸 수 있는 항목고정늘
사용자dataData자료고정늘
사용자generateAnswer답 요청고정늘

정책 만들기(실시간)

목록부분(키)문서의 제목화면 이름자물쇠그려지는 때
시스템roleRole역할고정늘
시스템precedencePrecedence규칙 우선고정조직이 부분을 고치거나 더한 버전에서만
시스템scopeWhat to generate만들 것바꿀 수 있음늘
시스템rules-idsIdentifiers주어진 ID 만 쓰기고정늘
시스템rules-guidanceLeast privilege and compliance최소 권한과 준수바꿀 수 있음늘
시스템rules-fieldsFields of the answer답의 필드 규칙고정늘
시스템rules-methodsHTTP methodsHTTP 방식과 권한바꿀 수 있음늘
시스템rules-permission-idsNo permission identifiers권한 ID 넣지 않기고정늘
시스템rules-contextExisting policies and role hierarchy기존 정책과 역할 계층바꿀 수 있음늘
시스템protocolStreaming protocol실시간 답의 순서고정늘 · 답 형식이라 맨 끝
시스템json-rulesJSON output rulesJSON 출력 규칙고정늘 · 답 형식이라 맨 끝
시스템structure-introStructure to output출력할 구조 안내고정늘 · 답 형식이라 맨 끝
시스템schemaSchema답 구조 예시고정늘 · 답 형식이라 맨 끝
사용자requestRequest요청고정늘
사용자instructionsExecution instructions실행 지시고정늘

조건 템플릿

버전 하나에 두 종류가 함께 있습니다: 공통 조건 3개, 그리고 메서드마다의 조건(메서드 하나씩 또는 여러 메서드를 한 번에). 호출마다 그 종류의 부분만 그립니다.

목록부분(키)문서의 제목화면 이름자물쇠그려지는 때
시스템universal-roleRole (universal)역할(공통 조건)바꿀 수 있음공통 조건 3개를 만들 때
시스템specific-roleRole (specific)역할(메서드별 조건)바꿀 수 있음메서드마다 조건을 만들 때
시스템precedencePrecedence규칙 우선고정조직이 부분을 고치거나 더한 버전에서만
시스템universal-jsonPure JSON (universal)JSON 으로만 답하기(공통 조건)고정공통 조건 3개를 만들 때
시스템universal-conditionsUniversal conditions만들 공통 조건고정공통 조건 3개를 만들 때
시스템universal-notesNotes (universal)주의(공통 조건)고정공통 조건 3개를 만들 때
시스템universal-outputOutput (universal)답 형식(공통 조건)고정공통 조건 3개를 만들 때
시스템specific-jsonPure JSON (specific)JSON 으로만 답하기(메서드별 조건)고정메서드마다 조건을 만들 때
시스템specific-rulesRules (specific)규칙(메서드별 조건)고정메서드마다 조건을 만들 때
시스템specific-examplesExamples (specific)예시(메서드별 조건)고정메서드마다 조건을 만들 때
시스템specific-outputOutput (specific)답 형식(메서드별 조건)고정메서드마다 조건을 만들 때
시스템output-formatOutput format형식 지시고정늘 · 답 형식이라 맨 끝
시스템schema-universalSchema (universal)답 구조 예시(공통 조건)고정공통 조건 3개를 만들 때 · 답 형식이라 맨 끝
시스템schema-specificSchema (specific)답 구조 예시(메서드별 조건)고정메서드마다 조건을 만들 때 · 답 형식이라 맨 끝
사용자universal-requestRequest (universal)요청(공통 조건)고정공통 조건 3개를 만들 때
사용자batch-referenceReference context참고 문맥(여러 메서드)고정여러 메서드를 참고 문맥과 함께 물을 때
사용자batch-requiredRequired answer반드시 할 답(여러 메서드)고정여러 메서드를 한 번에 물을 때
사용자batch-importantCount of answers답 개수(여러 메서드)고정여러 메서드를 한 번에 물을 때
사용자batch-methodsMethod signatures메서드 목록고정여러 메서드를 한 번에 물을 때
사용자batch-rulesGeneration rules만들기 규칙(여러 메서드)고정여러 메서드를 한 번에 물을 때
사용자batch-notesImportant notes주의(여러 메서드)고정여러 메서드를 한 번에 물을 때
사용자batch-confirmConfirmation마지막 확인(여러 메서드)고정여러 메서드를 한 번에 물을 때
사용자single-requestRequest (single)요청(메서드 하나)고정메서드 하나를 물을 때

자원 이름 제안

목록부분(키)문서의 제목화면 이름자물쇠그려지는 때
시스템roleRole역할바꿀 수 있음늘
시스템precedencePrecedence규칙 우선고정조직이 부분을 고치거나 더한 버전에서만
시스템json-onlyPure JSONJSON 으로만 답하기고정늘
시스템output-contractOutput contract답의 약속고정늘
시스템naming-rulesNaming rules이름 짓기 규칙바꿀 수 있음늘
시스템output-formatOutput format형식 지시고정늘 · 답 형식이라 맨 끝
시스템schemaSchema답 구조 예시고정늘 · 답 형식이라 맨 끝
사용자referenceReference context참고 문맥고정참고 문맥이 있을 때
사용자requiredRequired answer반드시 할 답고정자원이 있을 때
사용자resourcesResources자원 목록고정자원이 있을 때
사용자confirmConfirmation마지막 확인고정자원이 있을 때
사용자no-resourcesNo resources자원이 없을 때고정자원이 없을 때

검색어 바꾸기(행동 · 위험 · 정책)

검색어 바꾸기 세 개는 부분이 같고 문장만 다릅니다. 시스템 프롬프트가 없고, 프롬프트 전체가 사용자 프롬프트입니다.

목록부분(키)문서의 제목화면 이름자물쇠그려지는 때
사용자precedencePrecedence규칙 우선고정조직이 부분을 고치거나 더한 버전에서만
사용자purposePurpose목적바꿀 수 있음늘
사용자queryOriginal query원래 검색어고정늘
사용자guidelinesOptimization Guidelines바꾸기 지침바꿀 수 있음늘
사용자return-onlyAnswer답 형식고정늘

API

모두 /contexa/admin/api/prompt-quality/versions 아래에 있고 hasAuthority('ROLE_ADMIN') 이 필요합니다. 바꾸는 요청은 모두 POST 이고 콘솔의 CSRF 보호를 받습니다. ?scope= 와 ?prompt= 로 테넌트와 프롬프트를 고릅니다(기본: 플랫폼 전체, 보안 판정).

메서드와 경로하는 일
GET(기본 경로), ?hidden=true목록: 쓰는 버전, 개수, 시험 중인 것, 새 제품 기본, 버전들
GET /{number}버전 하나: 바탕과 비교한 부분, 미리보기, 크기, 이 버전으로 한 판정
GET /{number}/export?form=diff|full버전을 문서로(기본 diff)
GET /draft?base=&carry=새 버전 만들기 화면의 시작점(바탕 기본값은 쓰는 버전, carry 는 그 버전의 변경을 옮김)
POST /check초안의 저장 전 검사
POST(기본 경로)초안을 다음 버전으로 저장(useNow 면 판정에도 사용)
GET /{number}/use-check"판정에 사용" 확인 창에 보일 것: 관문의 답과 마지막 시험 판정
POST /{number}/use판정에 사용, 본문 {"reason"}(선택). 200 적용, 422 막힘
POST /{number}/hide숨기기
POST /import문서 올리기, 본문 {"fileName", "text"}
GET /advanced · /folder · /history고급 화면, 폴더 상태, 기록
POST /folder/rescan폴더를 지금 다시 읽기
POST /canary/start · /canary/stop먼저 적용, 본문 {"number", "percent", "tenants", "paths", "reason"}
POST /shadow/start · /shadow/stop함께 시험, 본문 {"number", "samplePercent", "dailyLimit", "reason"}
GET /shadow/results?days=7함께 시험 결과(1~90일)
GET /trials · POST /trials시험 판정을 시작할 수 있는 것과 시작, 본문 {"candidate", "reference", "count"}
GET /trials/{id} · POST /trials/{id}/cancel시험 판정 결과, 취소
POST /rollback · /rollback/{executionKey}/approve급히 되돌리기, 본문 {"number", "reason"}, 그 승인

거절된 요청은 422 와 코드(예: VERSION_HIDDEN, CANARY_PERCENT, TRIAL_RUNNING)로, 문서에 고칠 곳이 있으면 PROBLEMS 와 모든 문제로 답합니다.

설정

설정기본값뜻언제 바꾸나
contexa.security.tiered.prompt-bundle.active없음화면에서 고른 버전이 없을 때 판정에 쓸 버전(v2.0 꼴). 판정마다 다시 읽음설정 파일로 버전을 고정할 때
contexa.prompt.versions.directory없음서버마다 뜰 때와 1분마다 읽는 문서 폴더버전을 파일로 관리할 때
contexa.prompt.governance.enabledtrue화면 · API · 시험 판정과, 그것이 쓰는 레지스트리 · 출시 관문 · 되돌리기화면으로 버전을 관리하지 않을 때 끔. 그러면 판정은 설정과 가장 새 Contexa 버전만 읽음
contexa.llm.model-capabilities.ollama.max-context-length32768Ollama 호출이 요청하는 가장 큰 문맥. Ollama 모델일 때 길이 검사의 한도Ollama 서버가 더 큰 문맥을 낼 때
contexa.security.tiered.prompt-bundle.shadow.sample-percent0버전의 레지스트리 행에 값이 없을 때 함께 시험할 요청의 표본 비율(0~100, 0 이면 돌리지 않음)드물게. 표본 비율은 화면에서 정함
contexa.security.tiered.prompt-bundle.shadow.daily-call-cap100버전의 레지스트리 행에 값이 없을 때 서버마다 UTC 하루의 그 버전 함께 시험 횟수드물게. 하루 한도는 화면에서 정함

부록: 버전 문서

버전 문서는 YAML 파일 하나이고, 문서 하나가 버전 한 벌입니다. 조직 문서에는 바꾼 것만 적습니다. SnakeYAML 의 안전한 생성기로 읽으므로 문서는 맵 · 목록 · 일반 값만 만들고, 같은 키와 별칭은 거부되며, 문서는 최대 1,000,000자입니다.

prompt: cortex.security-decision
kind: organization
basedOn: v1.0
basedOnHash: sha256:9c1f…              # 내려받기가 적음. 다른 서버는 이것으로 바탕을 찾음
title: 우리 회사 판정 지침
description: 우리 조직의 맥락을 더하고 유사 사례의 한계를 뺌
system:
  - key: org-context                   # 부분 더하기
    add-after: honesty-more
    title: 우리 조직
    text: |
      재무 담당자는 매달 마지막 영업일 사흘 동안 원장을 내보냅니다.
  - key: how-to-judge                  # 부분 고치기
    text: |
      1. Build one story of this request: ...
  - key: similar-case-limits           # 부분 지우기
    delete: true
  - key: verified-signal-boundary      # 준비된 부분 넣기
    include: true
user:
  - key: org-reference                 # 조직 참고 블록 더하기
    add-after: REQUEST
    title: 조직 참고
    text: |
      월말 결산은 26일부터 그달 마지막 날까지입니다.
칸뜻
prompt꼭 있어야 함. 문서가 대상으로 하는 프롬프트(cortex.security-decision)
kindproduct · organization · rendered. 없으면 release 가 있는 문서는 제품 문서, 아니면 조직 문서
basedOn · basedOnHash바탕의 번호와 내용 해시(sha256: 와 16진수). 해시를 먼저 찾고, 둘 가운데 하나는 꼭 있어야 함
title · description버전의 이름과 쓰임새. 제목이 없으면 번호로 부름
system · user시스템 프롬프트의 부분과 사용자 프롬프트의 블록
부분의 key꼭 있어야 함. 바탕에 있는 키면 그 부분을 고치고, 새 키에 add-after 가 있으면 더함
부분의 title · text제목(더한 부분에는 꼭 있어야 함, 고칠 때 없으면 바탕의 제목을 지킴)과 문장(고치거나 더할 때 꼭 있어야 함)
부분의 add-after · delete: true · include: true고른 부분 · 블록 뒤에 더하기, 부분 지우기, 준비된 부분 넣기. 셋 가운데 하나만 쓰고, 지우거나 넣는 부분에는 제목 · 문장을 쓰지 않음
  • 제품 기본 문서는 같은 형식에 모든 부분을 담은 완성본입니다: contexa-core 의 prompt-versions/cortex.security-decision/2026.11.18.yaml(제품 판 2026.11.18-v1.0). 앞 판 2026.11.16.yaml(2026.11.16-v1.0)도 바뀌지 않고 함께 들어 있습니다. 부분마다 key · title · locked 와 문장이 있고, join · heading · group · when(minimum-action-enforce 같은 조건) · prepared · whenText · items(사유 코드, 블록의 줄과 쓰임) · effects 가 있을 수 있습니다. 답 형식이나 규칙을 어긴 답에 다시 묻는 문장 corrections 도 담습니다. 조직 문서는 이 칸들을 쓸 수 없습니다.
  • 제품 기본 문서의 사유 코드가 엔진의 사유 코드와 다르면 기동이 실패합니다. 빌드에 든 다른 제품 판이 엔진에 없는 사유 코드를 쓰거나 순서가 다르면 그때도 기동이 실패합니다. 되돌리기는 사유 코드가 엔진의 것도, 빌드에 든 제품 판의 것도 아닌 버전을 거절합니다.
  • 내용 해시: 조립한 버전의 부분들을 정해진 순서로 이은 문자열의 SHA-256 입니다. 같은 프롬프트를 그리는 두 버전은 해시가 같습니다.