피드로 돌아가기
Humanizing Artificial Intelligence in DevOps Documentation: Making Runbooks Easier to Create and Use
Dev.toDev.to
DevOps

Human-in-the-loop 검증 기반 AI Runbook 생성 파이프라인 구축

Humanizing Artificial Intelligence in DevOps Documentation: Making Runbooks Easier to Create and Use

James Joyner2026년 6월 19일11intermediate

Context

인프라 변경 및 서비스 명칭 변경으로 인한 Runbook의 정보 부패(Rotting) 발생. 신뢰할 수 없는 문서로 인해 장애 대응 시 불필요한 시간 소모 및 소스 코드 분석 강제라는 병목 지점 노출.

Technical Solution

  • Shell History 및 Incident Timeline을 LLM에 주입하여 구조화된 Skeleton 자동 생성
  • [ASSUMPTION] 태그 강제 부여를 통한 LLM의 Confident Gap-filling 리스크 시각화
  • 'AI Draft → Human Verify → Human Edit'으로 이어지는 3단계 검증 파이프라인 설계
  • 실제 실행 명령어를 History에서 그대로 추출하여 Hallucination 원천 차단
  • 기계적 톤 제거 및 실무 맥락(Context) 추가를 통한 문서 가독성 및 신뢰도 확보

1. LLM 프롬프트에 [ASSUMPTION] 태그 삽입을 강제하여 불확실한 정보 식별하기

2. Shell History와 같은 실제 아티팩트를 입력값으로 사용하여 명령어 정확성 확보하기

3. AI 생성물을 그대로 배포하지 않고 Human-in-the-loop 검증 단계 필수 배치하기

4. 기계적 문체를 제거하고 실제 장애 경험 기반의 Critical Context 추가하기

원문 읽기