도구 사용: 에이전트에게 역량 부여하기

🔄 Quick Recall: 지난 레슨에서 시스템 프롬프트와 추론 루프로 첫 번째 리서치 에이전트를 구축했어요. 하지만 그 에이전트는 AI 모델이 이미 아는 것에 한정됐어요. 이제 에이전트에게 실질적 역량을 부여해요 — 세상과 상호작용하는 도구.

도구가 에이전트를 변환해요

도구 없이 에이전트는 정교한 챗봇에 불과 — 훈련 데이터에 대해 추론할 수 있지만 새 정보에 접근하거나 계산을 실행하거나 시스템과 상호작용할 수 없어요.

도구가 있으면 에이전트가 웹을 검색하고, 코드를 실행해 데이터를 분석하고, 파일을 읽고 쓰고, API를 호출하고, 데이터베이스를 쿼리할 수 있어요.

도구가 “답이 이럴 것 같아요…“를 “찾아봤고 여기 결과가 있어요.“로 바꿔요.

도구의 해부학

모든 도구에는 네 가지 구성요소가 있어요:

이름 — 명확한 식별자 (예: web_search, run_code, read_file)

설명 — 에이전트가 이 도구를 언제 왜 사용해야 하는지. 에이전트가 이것을 읽고 도구 사용 여부를 결정해요.

파라미터 — 도구가 필요한 입력 (검색 쿼리, 실행할 코드, 파일 경로)

반환 값 — 도구가 돌려주는 것 (검색 결과, 코드 출력, 파일 내용)

✅ Quick Check: 도구 설명이 에이전트 성능에 왜 중요한가요? 에이전트가 설명을 읽고 도구 사용 여부를 결정해요. 모호한 설명은 남용이나 오용으로 이어져요. 정확한 설명이 적절한 사용을 안내해요.

필수 도구 카테고리

정보 검색 도구 — 외부 소스에서 데이터 가져오기

• 웹 검색, 문서 리더, 데이터베이스 쿼리, API 호출

처리 도구 — 데이터 변환과 분석

• 코드 실행기, 텍스트 분석기, 데이터 포맷터

행동 도구 — 실제 세계에서 일을 발생시키기

• 이메일 발신, 파일 작성기, 시스템 업데이터, 브라우저 제어기

평가 도구 — 품질과 정확성 확인

• 사실 확인기, 계산기, 검증기

도구 체인: 도구 결합

실제 에이전트 작업은 여러 도구를 순서대로 필요로 해요:

조사 및 보고서 작업:

1. web_search → 관련 기사 찾기
2. read_document → 찾은 기사에서 핵심 데이터 추출
3. run_code → 데이터 분석 및 비교
4. write_file → 최종 보고서 생산

에이전트가 각 단계에서 발견한 것에 따라 체인을 동적으로 결정해요. 웹 검색이 PDF를 반환하면 문서 읽기 단계를 추가하고, 데이터에 오류가 있으면 정제 단계를 추가해요.

도구 실패 처리

도구는 실패해요. API가 다운되고, 검색이 쓸모없는 결과를 반환하고, 파일이 잘못된 형식일 수 있어요. 에이전트에게 폴백 전략이 필요해요:

1. 일반적 실패 모드 — 타임아웃, 빈 결과, 형식 오류
2. 1차 폴백 — 수정된 파라미터로 재시도, 대체 도구 시도
3. 2차 폴백 — 캐시된 결과 사용, 가용 데이터로 근사
4. 에스컬레이션 — 모든 대안이 소진되면 사용자에게 도움 요청

견고한 에이전트는 포기하기 전에 대안을 시도해요.

도구 사용 모범 사례

• 도구 선택 기준을 명시적으로. 도구를 나열만 하지 말고 언제 사용하고 언제 사용하지 않을지 알려주세요.
• 단계당 도구 제한. 한 추론 사이클에서 하나 또는 둘로 관리 가능하게.
• 도구 출력 검증. 결과가 합리적인지 사용 전에 확인.
• 모든 것을 로그. 모든 도구 호출과 결과를 기록. 문제 시 정확히 어디서 잘못됐는지 파악.

핵심 정리

• 도구가 에이전트를 정교한 챗봇에서 유능한 자율 시스템으로 변환해요
• 모든 도구에 네 가지 구성요소: 이름, 설명, 파라미터, 반환 값
• 도구 설명이 가장 중요 — 에이전트가 도구를 언제, 어떻게 사용할지 안내해요
• 최소 실행 가능 도구 세트를 사용 — 도구가 적으면 잘못된 선택이 줄어요
• 도구 체인이 여러 도구를 순서대로 결합하고, 에이전트가 체인을 동적으로 결정해요
• 모든 도구에 오류 처리를 구축: 폴백 전략, 대안 접근, 에스컬레이션 트리거

Up Next: 다음 레슨에서 다단계 추론과 계획 수립을 다뤄요 — 에이전트가 복잡한 작업을 실행 가능한 단계로 나누고 계획이 변할 때 적응하는 방법.