프롬프트 버전 관리
소스 코드를 고치지 않고 보안 판정 프롬프트를 바꾸는 법을 설명합니다. 버전은 한 번 만들면 바뀌지 않는 완전한 프롬프트 한 벌입니다. 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새 버전 만들기바탕은 지금 판정에 쓰는 버전
- 2고치고 저장저장 전 검사를 거치고, 저장하면 다음 번호가 생김
- 선택시험 판정봉인된 최근 판정을 두 버전으로 다시 판정, 기록만 함
- 3판정에 사용약 5초 안에 모든 서버가 따름
세 번 누르기 흐름
- 목록 화면의 "새 버전 만들기"를 누르면 지금 판정에 쓰는 버전을 바탕으로 새 버전 만들기 화면이 열립니다(
/versions/new?base={번호}). 표의 줄이나 버전 보기 화면의 "새 버전 만들기"는 그 버전에서 시작합니다. - 부분을 고치고 "저장"을 누릅니다. 바꿀 수 있는 부분만 열리고, 자물쇠가 붙은 부분은 "Contexa 규칙" 아래에 접혀 있습니다. "저장 전 검사"는 고칠 때마다 다시 검사하고, 통과해야 "저장"이 됩니다. 저장하면 다음 번호가 생기고 바탕은 그대로 남습니다.
- 새 버전 줄의 "판정에 사용"을 누릅니다. 확인 창에 "지금", "바뀔 버전", "적용"("약 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 규칙이라 어느 버전도 고치거나 지울 수 없고, 새 버전 만들기 화면에서도 접혀 있습니다. 바꿀 수 있는 부분은 글 상자로 열립니다: 문장을 고치거나, "제품 기본으로 되돌리기"로 되돌리거나, "이 부분 지우기"로 뺍니다("되살리기"로 다시 넣음). 조직의 부분을 새로 더할 수도 있습니다.
| 순서 | 부분(키) | 화면 이름 | 자물쇠 | 그려지는 때 |
|---|---|---|---|---|
| 1 | mission | 사명 | 고정 | 늘 |
| 2 | precedence | 규칙 우선 | 고정 | 조직이 부분을 고치거나 더한 버전에서만: "조직이 쓴 지침이 이 글의 Contexa 고정 규칙과 부딪치면 Contexa 규칙을 따른다"는 문장 |
| 3 | evidence-reading | 증거 읽는 법 | 고정 | 늘 |
| 4 | organization-blocks | 조직이 더한 블록 | 고정 | 제품 판 2026.11.18-v1.0 과 그 위의 버전에서, 조직이 부분을 고치거나 더한 버전에서만: "조직이 사용자 프롬프트에 더한 블록은 머리줄이 조직이 쓴 참고라고 밝히고, 이 요청에서 일어난 일이 아니라 조직이 일하는 방식을 말한다"는 문장 |
| 5 | more-reading | 더 읽는 법 | 바꿀 수 있음 | 늘 |
| 6 | similar-case-reading | 유사 사례 읽는 법 | 바꿀 수 있음 | 늘. 이 부분을 지운 버전은 과거 기록의 유사도 검색도 끕니다 |
| 7 | similar-case-limits | 유사 사례의 한계 | 바꿀 수 있음 | 늘 |
| 8 | how-to-judge | 판단 방법 | 바꿀 수 있음 | 늘 |
| 9 | responses | 응답과 그 뜻 | 고정 | 늘. 최소 조치 하한을 강제하면 마지막 문장이 하한 예외를 말합니다 |
| 10 | minimum-action-floors | 최소 조치 하한(하한을 강제할 때) | 고정 | contexa.security.zerotrust.minimum-action.mode=ENFORCE 일 때만: 켠 규칙을 호스트 설정값으로 |
| 11 | decision-rules | 판정 규칙(준비된 부분) | 고정 | 이 부분을 넣은 버전에서만(Contexa 가 준비한 부분) |
| 12 | verified-signal-boundary | 신뢰 신호 경계(준비된 부분) | 고정 | 이 부분을 넣은 버전에서만 |
| 13 | honesty | 정직성 | 고정 | 늘 |
| 14 | honesty-more | 정직성 더함 | 고정 | 늘 |
| 15 | output | 답 형식 | 고정 | 늘 |
| 16 | reason-codes | 사유 코드의 뜻 | 고정 | 늘(52줄, 2026.11.16-v1.0 위의 버전은 VERIFIED_SIGNAL 없이 51줄) |
| 17 | citation-rules | 근거 인용 규칙 | 고정 | 늘 |
| 18 | output-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 · 0 | 0 · 0 · 0(같음) | — |
| 답 토큰 | 132 | 118 | — |
| 통제 10건의 차단 | 8 | 0 | 9 |
판정 규칙은 근거 정확도를 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_*)에 남깁니다. - 숨기기(버전 보기 화면, 상태가 "쓰지 않음"인 버전): "목록에서만 감춥니다. 내용은 지우지 않고, 판정 기록과 봉인 증거는 계속 이 버전을 가리킵니다." 판정에 사용 중이거나 먼저 적용 · 함께 시험 중인 버전은 숨길 수 없고, 숨긴 버전은 판정에 쓰거나 시험하거나 되돌아갈 대상으로 고를 수 없습니다. 숨긴 버전은 "숨긴 버전도 보기"로 봅니다.
판정의 버전이 정해지는 순서
판정이 시작되면 아래 순서로 버전을 정하고 사건에 고정합니다.
- 화면 표지: 요청이 드는 먼저 적용, 아니면 판정에 사용 중인 버전. 요청한 테넌트의 것을 보고, 없으면 플랫폼 전체(
PLATFORM_GLOBAL)의 것을 봅니다. 목록에는 "화면에서 고름"(또는 "먼저 적용")으로 보입니다. - 설정
contexa.security.tiered.prompt-bundle.active가 있고 숨기지 않은 버전(v2.0.2·v2도 같게 읽음)을 가리킬 때 그 버전. 판정마다 다시 읽으므로, 가리킨 버전이 나중에 생기면 그때부터 씁니다. "설정 파일로 고름"으로 보입니다. 이 설정은 보안 판정에만 적용됩니다. - 가장 새 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}개". 옮기는 변경은 지금 버전과 그 바탕을 따라 내려가는 조직 버전들이 제품 기본에 한 변경 전부입니다: 고친 부분(마지막 제목과 문장), 더한 부분과 블록(뒤에 고쳤든 아니든, 그 자리와 함께), 넣은 준비된 부분, 지운 부분. 새 바탕이 받을 수 없는 변경은 "옮길 수 없음: {부분} ({변경}) — 새 바탕에 그 부분이 없거나 고칠 수 없게 되었습니다."로 보입니다. 저장해야 버전이 되고, 초안은 따로 남지 않습니다.
시험 판정
"새 버전을 판정에 쓰기 전에 최근 실제 판정으로 비교합니다. 다시 판정은 기록만 하고 사용자에게 적용하지 않습니다."
- "시험할 버전", "비교할 버전"(지금 판정에 쓰는 버전에는 "(지금)"이 붙음), "다시 판정할 건수"(최근 20 · 50 · 100건)를 고릅니다.
- "시험 판정 시작"을 누릅니다. 최근 봉인 판정(테넌트를 골랐으면 그 테넌트의 것)을 두 버전으로 한 번씩 다시 판정합니다: "모델을 건마다 두 번 부릅니다. 실제 판정이 기다리면 그 뒤에 섭니다. 봉인은 표본이라 건수보다 적으면 있는 만큼 합니다."
- 결과에 카드 네 장과 자세한 내용이 보입니다.
| 카드 · 구역 | 뜻 |
|---|---|
| 조치가 같음 | 두 버전이 같은 조치로 답한 판정의 수 |
| 형식 오류 | "첫 답이 답 형식을 어겨 다시 물었거나 쓸 수 있는 답이 없던 판정입니다. 규칙 위반으로 다시 물은 것은 세지 않습니다." |
| 판정 시간(평균) | 버전마다 다시 판정 한 번의 평균 시간 |
| 답 길이(평균) | 버전마다 답 토큰의 평균 |
| 조치 분포 | 버전마다 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.
| 화면 이름 | 프롬프트 키 | 쓰는 기능 | 제품 기본 문서 |
|---|---|---|---|
| 정책 만들기 | PolicyGeneration | AI 정책 생성(POST /contexa/admin/api/ai/policies/generate, AI 모드) | contexa-iam: prompt-versions/{키}/2026.11.17.yaml |
| 정책 만들기(실시간) | PolicyGenerationStreaming | AI 정책 생성의 실시간 답(POST /contexa/admin/api/ai/policies/generate/stream) | |
| 조건 템플릿 | ConditionTemplate | 조건 템플릿 생성(조건 템플릿) | |
| 자원 이름 제안 | ResourceNaming | 자원 등록부가 찾은 자원의 이름 제안 | |
| 검색어 바꾸기(행동) | BehaviorQueryTransform | RAG 의 행동 검색(RAG) | contexa-core: prompt-versions/{키}/2026.11.17.yaml |
| 검색어 바꾸기(위험) | RiskQueryTransform | RAG 의 위험 검색 | |
| 검색어 바꾸기(정책) | PolicyQueryTransform | RAG 의 정책 검색 |
호출이 버전을 얻는 법
- 호출마다 그 프롬프트의 표지(화면의 "사용")가 가리키는 버전을 그리고, 표지가 없으면 가장 새 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 을 등록한 설치는 업그레이드할 때 새 판을 다음 번호로 등록하고, 쓰는 버전은 저절로 바뀌지 않습니다. 정책 만들기처럼 보안 판정 밖의 일곱 프롬프트는 버전 표 없이도 빌드에 든 제품 판을 각자의 판 이름으로 찾으므로, 앞 판 이름을 가리키는 요청도 그 판을 그립니다. 보안 판정은 버전 표 없이는 최신 제품 판만 그 판 이름이나 묶음 이름으로 찾고, 앞 판은 기동 때 등록한 버전 표에서 읽습니다.
| 목록 | 부분(키) | 문서의 제목 | 화면 이름 | 자물쇠 | 그려지는 때 |
|---|---|---|---|---|---|
| 시스템 | role | Role | 역할 | 고정 | 늘 |
| 시스템 | precedence | Precedence | 규칙 우선 | 고정 | 조직이 부분을 고치거나 더한 버전에서만 |
| 시스템 | scope | What to generate | 만들 것 | 바꿀 수 있음 | 늘 |
| 시스템 | rules-ids | Identifiers | 주어진 ID 만 쓰기 | 고정 | 늘 |
| 시스템 | rules-guidance | Least privilege and compliance | 최소 권한과 준수 | 바꿀 수 있음 | 늘 |
| 시스템 | rules-fields | Fields of the answer | 답의 필드 규칙 | 고정 | 늘 |
| 시스템 | rules-methods | HTTP methods | HTTP 방식과 권한 | 바꿀 수 있음 | 늘 |
| 시스템 | rules-permission-ids | No permission identifiers | 권한 ID 넣지 않기 | 고정 | 늘 |
| 시스템 | rules-context | Existing policies and role hierarchy | 기존 정책과 역할 계층 | 바꿀 수 있음 | 늘 |
| 시스템 | output-format | Output format | 형식 지시 | 고정 | 늘 · 답 형식이라 맨 끝 |
| 시스템 | schema | Schema | 답 구조 예시 | 고정 | 늘 · 답 형식이라 맨 끝 |
| 사용자 | requirements | Natural language requirements | 자연어 요구 | 고정 | 늘 |
| 사용자 | available-items | Available items | 쓸 수 있는 항목 | 고정 | 늘 |
| 사용자 | data | Data | 자료 | 고정 | 늘 |
| 사용자 | generate | Answer | 답 요청 | 고정 | 늘 |
정책 만들기(실시간)
| 목록 | 부분(키) | 문서의 제목 | 화면 이름 | 자물쇠 | 그려지는 때 |
|---|---|---|---|---|---|
| 시스템 | role | Role | 역할 | 고정 | 늘 |
| 시스템 | precedence | Precedence | 규칙 우선 | 고정 | 조직이 부분을 고치거나 더한 버전에서만 |
| 시스템 | scope | What to generate | 만들 것 | 바꿀 수 있음 | 늘 |
| 시스템 | rules-ids | Identifiers | 주어진 ID 만 쓰기 | 고정 | 늘 |
| 시스템 | rules-guidance | Least privilege and compliance | 최소 권한과 준수 | 바꿀 수 있음 | 늘 |
| 시스템 | rules-fields | Fields of the answer | 답의 필드 규칙 | 고정 | 늘 |
| 시스템 | rules-methods | HTTP methods | HTTP 방식과 권한 | 바꿀 수 있음 | 늘 |
| 시스템 | rules-permission-ids | No permission identifiers | 권한 ID 넣지 않기 | 고정 | 늘 |
| 시스템 | rules-context | Existing policies and role hierarchy | 기존 정책과 역할 계층 | 바꿀 수 있음 | 늘 |
| 시스템 | protocol | Streaming protocol | 실시간 답의 순서 | 고정 | 늘 · 답 형식이라 맨 끝 |
| 시스템 | json-rules | JSON output rules | JSON 출력 규칙 | 고정 | 늘 · 답 형식이라 맨 끝 |
| 시스템 | structure-intro | Structure to output | 출력할 구조 안내 | 고정 | 늘 · 답 형식이라 맨 끝 |
| 시스템 | schema | Schema | 답 구조 예시 | 고정 | 늘 · 답 형식이라 맨 끝 |
| 사용자 | request | Request | 요청 | 고정 | 늘 |
| 사용자 | instructions | Execution instructions | 실행 지시 | 고정 | 늘 |
조건 템플릿
버전 하나에 두 종류가 함께 있습니다: 공통 조건 3개, 그리고 메서드마다의 조건(메서드 하나씩 또는 여러 메서드를 한 번에). 호출마다 그 종류의 부분만 그립니다.
| 목록 | 부분(키) | 문서의 제목 | 화면 이름 | 자물쇠 | 그려지는 때 |
|---|---|---|---|---|---|
| 시스템 | universal-role | Role (universal) | 역할(공통 조건) | 바꿀 수 있음 | 공통 조건 3개를 만들 때 |
| 시스템 | specific-role | Role (specific) | 역할(메서드별 조건) | 바꿀 수 있음 | 메서드마다 조건을 만들 때 |
| 시스템 | precedence | Precedence | 규칙 우선 | 고정 | 조직이 부분을 고치거나 더한 버전에서만 |
| 시스템 | universal-json | Pure JSON (universal) | JSON 으로만 답하기(공통 조건) | 고정 | 공통 조건 3개를 만들 때 |
| 시스템 | universal-conditions | Universal conditions | 만들 공통 조건 | 고정 | 공통 조건 3개를 만들 때 |
| 시스템 | universal-notes | Notes (universal) | 주의(공통 조건) | 고정 | 공통 조건 3개를 만들 때 |
| 시스템 | universal-output | Output (universal) | 답 형식(공통 조건) | 고정 | 공통 조건 3개를 만들 때 |
| 시스템 | specific-json | Pure JSON (specific) | JSON 으로만 답하기(메서드별 조건) | 고정 | 메서드마다 조건을 만들 때 |
| 시스템 | specific-rules | Rules (specific) | 규칙(메서드별 조건) | 고정 | 메서드마다 조건을 만들 때 |
| 시스템 | specific-examples | Examples (specific) | 예시(메서드별 조건) | 고정 | 메서드마다 조건을 만들 때 |
| 시스템 | specific-output | Output (specific) | 답 형식(메서드별 조건) | 고정 | 메서드마다 조건을 만들 때 |
| 시스템 | output-format | Output format | 형식 지시 | 고정 | 늘 · 답 형식이라 맨 끝 |
| 시스템 | schema-universal | Schema (universal) | 답 구조 예시(공통 조건) | 고정 | 공통 조건 3개를 만들 때 · 답 형식이라 맨 끝 |
| 시스템 | schema-specific | Schema (specific) | 답 구조 예시(메서드별 조건) | 고정 | 메서드마다 조건을 만들 때 · 답 형식이라 맨 끝 |
| 사용자 | universal-request | Request (universal) | 요청(공통 조건) | 고정 | 공통 조건 3개를 만들 때 |
| 사용자 | batch-reference | Reference context | 참고 문맥(여러 메서드) | 고정 | 여러 메서드를 참고 문맥과 함께 물을 때 |
| 사용자 | batch-required | Required answer | 반드시 할 답(여러 메서드) | 고정 | 여러 메서드를 한 번에 물을 때 |
| 사용자 | batch-important | Count of answers | 답 개수(여러 메서드) | 고정 | 여러 메서드를 한 번에 물을 때 |
| 사용자 | batch-methods | Method signatures | 메서드 목록 | 고정 | 여러 메서드를 한 번에 물을 때 |
| 사용자 | batch-rules | Generation rules | 만들기 규칙(여러 메서드) | 고정 | 여러 메서드를 한 번에 물을 때 |
| 사용자 | batch-notes | Important notes | 주의(여러 메서드) | 고정 | 여러 메서드를 한 번에 물을 때 |
| 사용자 | batch-confirm | Confirmation | 마지막 확인(여러 메서드) | 고정 | 여러 메서드를 한 번에 물을 때 |
| 사용자 | single-request | Request (single) | 요청(메서드 하나) | 고정 | 메서드 하나를 물을 때 |
자원 이름 제안
| 목록 | 부분(키) | 문서의 제목 | 화면 이름 | 자물쇠 | 그려지는 때 |
|---|---|---|---|---|---|
| 시스템 | role | Role | 역할 | 바꿀 수 있음 | 늘 |
| 시스템 | precedence | Precedence | 규칙 우선 | 고정 | 조직이 부분을 고치거나 더한 버전에서만 |
| 시스템 | json-only | Pure JSON | JSON 으로만 답하기 | 고정 | 늘 |
| 시스템 | output-contract | Output contract | 답의 약속 | 고정 | 늘 |
| 시스템 | naming-rules | Naming rules | 이름 짓기 규칙 | 바꿀 수 있음 | 늘 |
| 시스템 | output-format | Output format | 형식 지시 | 고정 | 늘 · 답 형식이라 맨 끝 |
| 시스템 | schema | Schema | 답 구조 예시 | 고정 | 늘 · 답 형식이라 맨 끝 |
| 사용자 | reference | Reference context | 참고 문맥 | 고정 | 참고 문맥이 있을 때 |
| 사용자 | required | Required answer | 반드시 할 답 | 고정 | 자원이 있을 때 |
| 사용자 | resources | Resources | 자원 목록 | 고정 | 자원이 있을 때 |
| 사용자 | confirm | Confirmation | 마지막 확인 | 고정 | 자원이 있을 때 |
| 사용자 | no-resources | No resources | 자원이 없을 때 | 고정 | 자원이 없을 때 |
검색어 바꾸기(행동 · 위험 · 정책)
검색어 바꾸기 세 개는 부분이 같고 문장만 다릅니다. 시스템 프롬프트가 없고, 프롬프트 전체가 사용자 프롬프트입니다.
| 목록 | 부분(키) | 문서의 제목 | 화면 이름 | 자물쇠 | 그려지는 때 |
|---|---|---|---|---|---|
| 사용자 | precedence | Precedence | 규칙 우선 | 고정 | 조직이 부분을 고치거나 더한 버전에서만 |
| 사용자 | purpose | Purpose | 목적 | 바꿀 수 있음 | 늘 |
| 사용자 | query | Original query | 원래 검색어 | 고정 | 늘 |
| 사용자 | guidelines | Optimization Guidelines | 바꾸기 지침 | 바꿀 수 있음 | 늘 |
| 사용자 | return-only | Answer | 답 형식 | 고정 | 늘 |
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.enabled | true | 화면 · API · 시험 판정과, 그것이 쓰는 레지스트리 · 출시 관문 · 되돌리기 | 화면으로 버전을 관리하지 않을 때 끔. 그러면 판정은 설정과 가장 새 Contexa 버전만 읽음 |
contexa.llm.model-capabilities.ollama.max-context-length | 32768 | Ollama 호출이 요청하는 가장 큰 문맥. Ollama 모델일 때 길이 검사의 한도 | Ollama 서버가 더 큰 문맥을 낼 때 |
contexa.security.tiered.prompt-bundle.shadow.sample-percent | 0 | 버전의 레지스트리 행에 값이 없을 때 함께 시험할 요청의 표본 비율(0~100, 0 이면 돌리지 않음) | 드물게. 표본 비율은 화면에서 정함 |
contexa.security.tiered.prompt-bundle.shadow.daily-call-cap | 100 | 버전의 레지스트리 행에 값이 없을 때 서버마다 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) |
kind | product · 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 입니다. 같은 프롬프트를 그리는 두 버전은 해시가 같습니다.