Agenta 하네스와 모델 — 실행과 모델을 분리해 고르기

Agenta 하네스와 모델 — 실행과 모델을 분리해 고르기

LLM은 메시지를 받아 메시지를 돌려주는 일 하나만 해요. 파일을 읽거나, 웹 검색을 하거나, 이메일을 보내는 일은 못하고, "도구를 불러 달라"고 답할 수만 있어요. 그 요청을 실제로 수행하는 프로그램이 바로 하네스(harness)예요.

출처: https://agenta.ai/docs/concepts/harnesses-and-models

하네스가 하는 일

하네스는 모델을 루프로 돌려요.

  1. 대화를 지시·도구 목록·스킬 이름과 함께 모델에 전송
  2. 모델이 도구 호출을 요청하면 하네스가 그 도구 실행
  3. 도구 결과를 대화에 추가해 다시 모델에 전송
  4. 모델이 도구 호출 대신 답변을 낼 때까지 반복

하네스는 세션 시작 시 지시를 로드하고, 에이전트가 작업하는 폴더의 AGENTS.md를 읽으며, 대화가 모델 한계를 넘어서면 앞부분을 요약하는 컴팩션도 담당해요.

Agenta가 제공하는 세 하네스

하네스 받아들이는 모델
Claude Code Anthropic Claude(직접, Bedrock, Vertex AI, 게이트웨이)
Pi OpenAI·Anthropic·Gemini·Mistral·Groq·MiniMax·Together AI·OpenRouter 및 OpenAI 호환 엔드포인트
Codex GPT-5.6(Sol/Terra/Luna), GPT-5.5, GPT-5.2

세 가지 별개 결정

  • 하네스: Claude Code, Pi, Codex
  • 모델: 하네스가 대화를 보낼 모델
  • 자격증명: 모델이 어디서 도는지(직접, 프록시, AWS Bedrock 등)

이 셋이 분리돼 있어 하나를 바꿔도 다른 구성은 그대로 유지돼요. 지시·스킬·도구·파일·권한은 변하지 않으므로, 같은 에이전트를 다른 모델로 옮겨도 같은 행동을 유지해요.

더 알아보기