AI 에이전트 용어 실용 용어집 (하네스, 스캐폴드, 에이전트 등)

허깅페이스의 새 블로그 게시물이 AI 에이전트 용어의 혼란을 해소하려고 합니다. 이 용어집은 하니스, 스캐폴드, 에이전트 같은 용어를 일반적인 에이전트 프레임워크에서 가져온 간단한 정의와 실제 예시로 설명합니다.
주요 용어 정의
- 에이전트: LLM을 사용해 작업을 결정하고 실행(예: 도구 호출)하는 시스템입니다. 블로그에서는 '원시(raw)' 에이전트와 스캐폴드로 감싼 에이전트를 구분합니다.
- 하니스: 도구 등록 및 실행을 포함한 에이전트 라이프사이클을 관리하는 런타임 환경입니다. 에이전트의 OS라고 생각하면 됩니다.
- 스캐폴드: 에이전트가 도구 및 메모리와 상호작용하는 방식을 구조화하는 템플릿 또는 프레임워크 코드입니다. 에이전트 자체와는 별개로, 에이전트 코어를 변경하지 않고 스캐폴드를 교체할 수 있습니다.
- 도구: 에이전트가 호출할 수 있는 함수입니다(예: 계산기, 웹 검색, 데이터베이스 쿼리).
- 메모리: 턴 또는 세션 간의 지속적 컨텍스트 저장소입니다. 용어집에서는 단기 메모리(대화 기록)와 장기 메모리(벡터 스토어)를 다룹니다.
- 오케스트레이터: 여러 에이전트 또는 하위 에이전트를 조정하며, 보통 계층적 구조로 구성됩니다.
게시물은 또한 이러한 용어가 LangGraph, CrewAI, Autogen 같은 인기 프레임워크에서 어떻게 매핑되는지 설명하여 개발자가 자신의 사용 사례에 맞는 적절한 추상화 계층을 선택하도록 돕습니다.
중요한 이유
에이전트 프레임워크(LangChain, Vercel AI SDK, smolagents)가 급증함에 따라, 같은 개념이 다른 이름으로 불리거나 같은 이름이 다른 뜻을 의미하는 경우가 많습니다. 이 용어집은 다단계 AI 워크플로우를 구축하는 개발자에게 공통 언어를 제공합니다.
📖 원문 보기: r/LocalLLaMA
👀 See Also

로컬 Claude 코드 설정: Qwen3.5 27B를 llama.cpp로 실행하기
한 개발자가 llama.cpp를 사용하여 Qwen3.5 27B로 Claude Code를 로컬에서 실행하기 위한 구성 환경 변수, 서버 매개변수 및 7가지 코딩 작업에 대한 성능 벤치마크를 공유합니다.

비개발자를 위한 Windows 11에서 OpenClaw 설치 장애물
취미로 이것저것 만지는 사람이 200달러짜리 미니 PC에 Windows 11을 설치한 후 OpenClaw를 설치할 때 마주친 세 가지 구체적인 장애물을 설명합니다. 여기에는 PowerShell 실행 정책, Windows Defender 차단, Node.js 및 Git과 같은 필수 구성 요소 누락이 포함됩니다.

700줄 모놀리스 문제를 해결하기 위해 에이전트 컨텍스트를 세 개의 계층으로 분할하기
6개의 에이전트로 구성된 자율 시스템을 구축하는 팀은 에이전트 컨텍스트를 관심사 유형과 변경 빈도에 따라 세 가지 계층으로 분리하여 컨텍스트 파일 비대화 문제를 해결했습니다: 정체성을 위한 CLAUDE.md, 미션을 위한 BRIEFING.md, 운영을 위한 PLAYBOOK.md. 이 접근 방식은 인수 제한으로 인한 침묵 오류를 방지하고 편집을 예측 가능하게 만듭니다.

Windows 11 Home에서 Claude Cowork '작업 공간 시작 실패' 오류 해결하기
사용자가 Microsoft Store에서 Windows Subsystem for Linux(WSL2)를 설치하여 Claude Cowork의 Windows 11 Home 시작 오류를 해결했습니다. 이는 기본 VM 기술에 필요한 구성 요소입니다.