에이전트 루프
에이전트 루프(agent loop)는 AI 에이전트의 중심에서 반복되는 순환입니다. 모델이 도구 호출을 요청하면 애플리케이션이 이를 실행해 결과를 돌려주고, 모델은 다음에 할 일을 정합니다.
다른 이름: agentic loop, tool-use loop
작성 Divya Sharma · 2026년 11월 15일 확인 · 리뷰 방식
언어 모델은 스스로 코드를 실행하거나 API를 호출할 수 없습니다. 텍스트만 만들 수 있으며, 여기에는 도구를 쓰겠다는 구조화된 요청도 포함됩니다. 에이전트 루프는 모델을 둘러싼 코드로, 그 요청을 실제 동작으로 바꿉니다.
작동 방식
1. 모델에게 작업과 도구 목록을 보냅니다. 2. 모델은 하나 이상의 도구 호출이나 최종 답변으로 응답합니다. 3. 도구를 요청했다면 애플리케이션이 이를 실행하고 결과를 대화에 추가합니다. 4. 갱신된 대화를 다시 보내고 2단계부터 반복합니다.
Claude API에서는 응답의 stop reason이 tool_use인 동안 루프가 계속되고, 다른 stop reason이 나오면 끝납니다. 도구 호출 하나가 한 번의 왕복이므로, 도구 호출이 10번 필요한 작업은 요청도 최소 10번이 필요합니다. 각 요청의 세부 내용은 도구 호출에서 다룹니다.
루프를 둘러싼 것
루프 자체는 짧습니다. 엔지니어링의 대부분은 이를 감싸는 부분에 있습니다. 턴 수 제한, 도구가 실패했을 때의 오류 처리, 위험한 동작에 대한 승인 요청, 결과가 쌓여도 대화를 컨텍스트 윈도 안에 유지하는 방법이 그렇습니다. 이 감싸는 계층을 흔히 에이전트 하네스라고 부릅니다.
관련 패턴
ReAct 패턴은 추론 텍스트와 행동을 번갈아 두는 방식으로 루프를 구성하는 한 가지 방법입니다.
관련 용어
- AI 에이전트
- AI 에이전트(AI agent)는 언어 모델이 다음 단계를 스스로 정하는 시스템입니다. 고정된 스크립트를 따르는 대신 도구를 호출하고, 결과를 읽고, 작업이 끝날 때까지 이를 반복합니다.
- 도구 호출
- 도구 호출(tool calling)은 함수 호출(function calling)이라고도 하며, 스키마로 함수를 설명하면 모델이 그중 하나를 호출하겠다는 구조화된 요청으로 답하고, 코드가 이를 실행해 결과를 돌려주는 모델 API 기능입니다.
- 에이전트 하네스
- 에이전트 하네스(agent harness)는 모델을 실제로 동작하는 에이전트로 만드는 주변 소프트웨어입니다. 루프, 도구, 시스템 프롬프트, 권한, 컨텍스트 관리, 그리고 세션 사이에 진행 상황을 이어 주는 파일이 여기에 포함됩니다.
- 컨텍스트 윈도
- 컨텍스트 윈도(context window)는 언어 모 델이 한 번에 고려할 수 있는 텍스트의 최대량으로, 토큰 단위로 셉니다. 시스템 프롬프트, 대화, 문서, 도구 결과, 모델이 쓰는 응답이 모두 포함됩니다.
- ReAct(추론과 행동)
- ReAct(reasoning and acting, 추론과 행동)는 언어 모델이 추론 단계를 쓰고, 검색이나 도구 호출 같은 행동을 하고, 그 결과를 읽은 뒤 다음 단계로 넘어가는 과정을 번갈아 반복하는 프롬프팅 패턴입니다.