anti-patterns

안티패턴 — 도구 사용과 에이전트

1. “에이전트” 남용

한 번의 LLM 호출은 에이전트가 아니다. Anthropic의 정의 — 도구 사용 + 환경 루프 + 정지 조건 — 에 모두 해당해야 한다.

2. 단순 워크플로우로 충분한 자리에 에이전트 적용

“열린 문제·예측 불가능한 단계 수”가 아니면 단순 워크플로우가 더 빠르고 싸고 안전하다. (sources/14-research-notes/2026-04-07-anthropic-building-effective-agents.md)

3. 도구 100개 한꺼번에 등록

도구 정의 자체가 컨텍스트를 잡아먹고, 모델의 선택 부담을 키운다. 작업별로 도구 셋 분리.

4. 도구 호출 결과를 검증 없이 신뢰

도구도 틀린다(검색 결과 오염, 코드 실행 환경 차이 등). 결과 자체에 검증 패스가 필요할 수 있다.

5. 정지 조건 없는 에이전트

무한 루프·토큰 폭주·비용 폭주의 가장 흔한 원인. 작업 시작 전 명시적 한도(스텝 수, 토큰, 시간)를 정해야 한다.

6. ACI 무시

도구 이름·설명·인자 타입이 모호하면 모델은 잘못된 도구를 부른다. 도구는 모델의 UI 다.