’하네스(Harness)’에서 결정됩니다.

생성형 AI를 이야기할 때 우리는 종종 GPT, Claude, Gemini 같은 모델에만 집중합니다.

하지만 실제 AI 서비스를 개발해 보면

중요한 사실 하나를 깨닫게 됩니다.

좋은 AI는 좋은 모델만으로 만들어지지 않습니다.

AI가 어떤 순서로 생각하고,

어떤 도구를 호출하며,

상태를 어떻게 관리하고,

언제 종료할지를 결정하는 하네스(Harness)가 AI 시스템의 성능을 좌우합니다.

최근 Tencent 연구진은 이러한 문제를 해결하기 위해

Harness Handbook이라는 새로운 접근법을 제안했습니다.

Harness Handbook이란?

Harness Handbook은 복잡한 AI 에이전트 시스템을

‘행동(Behavior) 중심’ 으로 문서화하고 탐색할 수 있도록 자동 생성되는 가이드입니다.

쉽게 말하면,

“AI 에이전트의 설계도이자 사용설명서”

라고 이해하면 됩니다.

코드만 보는 것이 아니라,

AI가 왜 그렇게 동작하는지, 어디를 수정해야 하는지를 한눈에 이해할 수 있도록 만들어 줍니다.

왜 필요한가?

AI 에이전트가 커질수록 다음과 같은 문제가 발생합니다.

프롬프트가 여러 파일에 흩어져 있다.

Tool 호출 로직이 복잡하다.

Memory와 State가 여러 모듈에 분산된다.

하나의 기능을 수정하려면 수십 개 파일을 찾아야 한다.

즉,

“무엇을 수정해야 하는지 찾는 시간” 이

“실제로 수정하는 시간” 보다 더 길어집니다.

Harness Handbook의 3단계 구조

Level 1 : 시스템 개요 (System Overview)

전체 AI 시스템을 조망하는 단계입니다.

1.시스템 아키텍처

2.실행 흐름

3.주요 단계

4.데이터 흐름

5.설계 원칙

전체 구조를 빠르게 이해할 수 있습니다.

Level 2 : 구성 요소 개요 (Component Overview)

각 구성 요소를 분석합니다.

1.Prompt

2.Memory

3.Tools

4.State

5.Component

6.외부 인터페이스

각 요소가 어떤 역할을 하는지 명확하게 보여줍니다.

Level 3 : 단위 심층 분석 (Unit Deep Dive)

실제 코드 수준으로 들어갑니다.

1.내부 로직

2.상태 전이(State Transition)

3.예외 처리

4.코드 스니펫

5.실행 로그

6.구현 세부 사항

필요한 부분만 깊게 분석할 수 있습니다.

Progressive Disclosure

Harness Handbook의 가장 큰 특징은

필요한 만큼만 점진적으로 정보를 보여주는 방식입니다.

처음에는 전체 구조만 보고,

필요하면 컴포넌트 수준으로,

마지막에는 코드 수준까지 들어갑니다.

복잡한 시스템도 인지 부담(Cognitive Load) 을 줄이면서 이해할 수 있습니다.

Harness Handbook이 제공하는 가치

인지 부담 감소

필요한 정보만 단계적으로 확인하여 이해가 쉬워집니다.

개발 효율 향상

수정해야 할 위치를 빠르게 찾을 수 있습니다.

협업 강화

개발자, AI 에이전트, 운영자가 동일한 구조를 이해할 수 있습니다.

유지보수 용이

기능 변경 시 영향 범위를 쉽게 파악할 수 있습니다.

학습과 온보딩 가속

새로운 개발자도 시스템 구조를 빠르게 이해할 수 있습니다.

ISO 인증심사 AI Agent에도 꼭 필요한 이유

제가 개발하고 있는 ISO/IEC 27001, ISO/IEC 27701, ISO/IEC 42001 인증심사에도 Harness Handbook 개념은 매우 유용합니다.

예를 들어 다음과 같은 기능을

하나의 행동 단위(Behavior)로 관리할 수 있습니다.

심사 계획 수립

증적 수집

Annex A 통제 평가

위험 분석

부적합 판정

심사보고서 생성

각 기능이 어떤 프롬프트를 사용하고,

어떤 Tool을 호출하며,

어떤 데이터를 참조하는지 연결해 두면

새로운 심사 기준이 추가되더라도 수정 위치를 빠르게 찾고 안정적으로 유지보수할 수 있습니다.

AI의 미래는 ‘코드 생성’보다 ‘시스템 이해’에 있습니다.

지금까지 AI는 코드를 얼마나 잘 작성하는가에 초점이 맞춰져 있었습니다.

하지만 앞으로는

“어디를 수정해야 하는가”

를 이해하는 능력이 더욱 중요해질 것입니다.

Harness Handbook은 복잡한 AI 시스템을 읽기 쉽고(Readability), 탐색하기 쉽고(Navigability), 수정하기 쉬운(Editability) 형태로 바꾸는 새로운 접근입니다.

AI 에이전트가 점점 더 복잡해지는 시대에, 이러한 행동 중심 문서화는 개발 생산성과 유지보수성을 높이는 핵심 기술이 될 것입니다.

기억해야 할 한 문장

“좋은 AI는 좋은 모델에서 시작하지만, 위대한 AI는 잘 설계된 하네스(Harness)에서 완성됩니다.”

AI 에이전트의 미래는 더 큰 모델이 아니라 더 이해하기 쉬운 시스템에서 시작됩니다.

#Harness #HarnessHandbook #AgenticAI #ClaudeCode #LLM #AIAgent #SoftwareArchitecture #PromptEngineering #MultiAgent #RAG #MCP #DevOps #AIResearch #Tencent #ISO27001 #ISO27701 #ISO42001 #AI자동화 #생성형AI #ByMark

— 이춘곤(Mark) · ISC.studio · ISC출판 도서 안내

이 글은 저자의 Facebook에 처음 게시한 글입니다. Facebook 원문 보기