Skip to content

AI 규칙 작성 지원 ​

AI 규칙 작성 지원은 공통 이상징후 규칙 편집기에서 사용하는 Enterprise 프리뷰 기능입니다. AI는 검토할 제안을 만들며, 저장은 기존의 명시적인 저장 절차를 사용합니다. 이번 구현은 실제 제공자·배포 모델의 호환성이나 작성 품질 개선 효과를 측정하지 않았습니다.

연결 설정 ​

  1. 유효한 Enterprise 라이선스와 로드된 제공자 플러그인을 확인하고 Core Admin으로 설정 → AI 연결을 엽니다.
  2. 승인된 endpoint, 모델 ID, 기본 모델과 전송 구분을 설정합니다. 규칙 작성 지원은 명시적으로 선택한 text, json, native_schema 모드를 사용하며 결과는 JSON과 서버 검증을 통과해야 합니다. text 모드에서는 고정된 서버 지시에 JSON 스키마를 포함하고 모드를 자동 전환하지 않습니다. local은 승인된 내부 배포, external은 외부·호스팅 서비스를 뜻합니다. 이 관리자 선언이 실제 네트워크 위치나 제공자의 보관 정책을 자동 증명하지는 않습니다.
  3. HTTPS를 기본으로 사용하고 필요하면 신뢰할 CA를 설정합니다. 내부망 HTTP는 명시적으로 허용합니다. 주소는 브라우저가 아니라 플러그인 실행 환경에서 접근하므로 컨테이너나 다른 서버의 localhost를 확인해야 합니다.
  4. 제공자 자격 증명을 입력합니다. 암호화하여 보관하며 응답에는 반환하지 않습니다. 편집 시 빈 입력란은 기존 값을 유지하고, 명시적인 지우기 기능을 선택해야 삭제됩니다.
  5. 연결 사용자·상속 그룹 또는 모든 리소스 관리자를 지정하고, 허용 리소스와 시간·동시성·일일 예산을 설정합니다. 모든 리소스 관리자 허용은 operator와 Core Admin을 뜻합니다. viewer는 별도의 연결 사용 허용이 필요합니다.
  6. 저장한 뒤 연결 확인을 실행합니다. 모든 승인 모델의 capability와 메타데이터만 검사하며 텍스트 생성이나 리소스 문맥 전송을 하지 않습니다. 설정을 편집하면 검증이 해제되고, 확인 실패도 이전 승인을 해제합니다.
  7. 샘플 생성은 과금 가능성을 명시적으로 확인한 뒤 실행합니다. 서버의 고정된 비민감 인사말을 사용하고 사용자 프롬프트나 실제 리소스 자료를 받지 않습니다. 일반 생성과 예산을 공유합니다. 사용량 미제공은 알 수 없음이며 제공된 0과 구분됩니다.

리소스의 외부 문맥 전송은 기본적으로 금지됩니다. external 연결을 사용하려면 해당 리소스의 외부 전송 정책을 명시적으로 허용해야 합니다. 일반 규칙 지원에서 Core Admin도 연결·모델·리소스 허용, 전송 정책과 예산을 우회하지 않습니다. 관리자 고정 샘플은 별도의 연결 관리 작업이므로 실제 리소스 전송 정책을 요구하지 않습니다.

제안 검토와 저장 ​

공통 편집기에서 사용할 수 있는 연결·모델을 선택하고 원하는 변경을 입력합니다. 초안, 추가 질문, 미지원 설명 또는 규칙 설명을 확인하고 지표, 단위, 임계값과 시간을 검토합니다. 구조적 차이와 공통 검증 결과를 확인한 뒤 유효한 초안만 수동으로 편집기에 반영하고 기존 규칙 저장 절차로 저장합니다. 반영만으로 저장·활성화·평가·알림 전송·도구 실행이 이루어지지 않습니다.

조회 창은 최신 관측값을 선택하며 추세·집계 계산이 아닙니다. 유지 시간은 과거 조회 구간이 아닙니다. 모호한 요구는 질문으로 확인하고, 미지원 추세, 수식이나 운영 동작을 임의의 임계값으로 조용히 바꾸면 안 됩니다. 검증 성공은 과거 재평가나 탐지 성능 개선의 증거가 아닙니다.

선택한 연결 버전도 요청에 포함하므로 요청 전 local에서 external로 바꾸는 등의 설정 변경은 오래된 선택을 새로 확인하도록 차단합니다. 응답 대기 중 저장·편집 버전, 선택 대상, 권한, 세션·API 키, 계정이나 라이선스가 바뀌면 결과를 버립니다. 취소가 제공자 비용 0을 보장하지는 않습니다. UTC 기준 일일 요청 수와 출력 토큰 상한을 호출 전에 예약하고, 실패나 사용량 미제공에도 보수적으로 유지합니다. 여러 노드는 PostgreSQL의 예산·동시성·만료 lease를 공유합니다. 준비되지 않은 노드나 standby는 과금 호출을 거부하며 자동 전달·재실행·재시도·외부 연결 전환을 하지 않습니다.

JSON 본문은 128 KiB, 연결 시간 제한은 1–60초입니다. 규칙 요청의 전체 상한은 60초이며 설정·capability·SDK 제한으로 더 짧아질 수 있습니다. 감사는 식별자, 판정과 선택적 사용량을 기록하고 프롬프트, 리소스 문맥, 생성 내용, 자격 증명과 endpoint를 보관하지 않습니다.

자세한 정책·예산·API는 운영 계약 문서(ai-rule-assistance.md)를 확인하세요.