---
{"id":"ai-patterns","title":"AI 제안·승인·설명 가능성","category":"업무 패턴","order":78,"summary":"AI의 존재를 밝히고, 추천과 실행의 책임을 구분합니다.","status":"문서 기준 · UI 미검증","references":["guidelines/carbon-for-ai/index","components/ai-label/usage"]}
---

# AI 제안·승인·설명 가능성

## 조건부 적용

AI가 있는 화면에만 적용합니다. Carbon for AI의 존재 표시·설명 가능성 원칙을 참고하지만 파란/보라 그라데이션·발광·IBM AI 로고를 가져오지 않습니다. 비AI 기능을 AI처럼 꾸미지 않습니다.

- AIP-01 MUST: 생성된 내용·추천·분석의 범위를 표시합니다.
- AIP-02 MUST: 실제 근거가 있으면 사용자가 확인할 수 있게 연결하고, 추정·근거 부족을 구분합니다.
- AIP-03 MUST: 생성·대기·중단·실패·완료와 도구의 실제 실행 상태를 분리합니다.
- AIP-04 MUST: 비용·파괴적 작업·권한 변경 전에는 대상을 명시한 사용자 검토가 필요합니다.
- AIP-05 MUST: 거절·수정·다시 생성·중단 경로를 제공하고 사용자의 입력을 불필요하게 잃지 않습니다.
- AIP-06 MUST: 비밀값·계정 정보·로그의 개인정보를 예제나 외부 생성 요청에 포함하지 않습니다.

## 설명 패널

무엇이 AI 생성인지 → 어떤 입력/근거를 사용했는지 → 알려진 한계 → 아직 적용하지 않은 변경 → 검토·거절 경로를 제공합니다. 시스템 프롬프트나 비밀키를 노출하라는 뜻은 아닙니다.

## 제품 예시

Mimir가 설정 변경을 제안하면 “제안됨” 상태와 변경 대상·영향을 먼저 보여 줍니다. 실제 실행은 기존 서버 권한·확인 절차가 소유합니다. 이번 문서에서 AI 기능 구현·모델 연동은 하지 않았습니다.