로드 중
로드 중

Claude를 위한 도구를 만들려면 처음에는 바로 드러나지 않는 여러 가지 과제를 해결해야 합니다. Claude가 미래 날짜에 대한 알림을 설정하도록 하고 싶을 때, Claude가 현재 날짜는 알고 있지만 정확한 시간은 항상 알지 못하고, 복잡한 날짜 계산에 어려움을 겪으며, 실제로 알림을 설정할 내장 방법이 없다는 것을 곧 알게 됩니다.

채팅에서 사용자가 목요일로부터 일주일 후의 병원 예약 알림을 요청하는데, 이 목표를 달성하려면 3~4개의 커스텀 도구가 필요합니다.

해결책은 이러한 특정 작업을 처리하는 커스텀 도구를 만드는 것입니다. 알림 시스템의 경우, 현재 날짜와 시간을 가져오는 도구, 날짜에 기간을 더하는 도구, 그리고 실제로 알림을 설정하는 도구까지 세 개의 별도 도구가 필요합니다.

왜 이것이 어려운가

Claude는 시간 기반 작업에 있어 몇 가지 한계가 있습니다:

  • Claude는 현재 날짜는 알 수 있지만 정확한 시간은 모를 수 있습니다
  • Claude는 시간 기반 덧셈을 항상 잘 처리하지는 못하며, 특히 미래의 여러 날을 내다볼 때 그렇습니다
  • Claude는 알림을 설정하는 방법을 모릅니다

사용자가 "병원 예약 알림을 설정해줘. 목요일로부터 일주일 후야."라고 묻고 AI가 "네, 알림을 설정해드리겠습니다"라고 답합니다.

필요한 도구들

이러한 문제를 해결하기 위해 세 가지 전용 도구를 만들게 됩니다:

  • 현재 날짜 시간 가져오기 - Claude는 현재 날짜와 시간을 알아야 합니다
  • 날짜 시간에 기간 더하기 - Claude는 날짜 시간 덧셈을 완벽하게 처리하지 못합니다
  • 알림 설정 - 알림을 설정할 방법이 필요합니다

알림 시스템에 필요한 세 가지 도구와 위에 나열된 각각의 이유입니다.

도구 함수의 작동 방식

도구 시스템은 서버와 Claude 사이의 특정 흐름을 따릅니다. 여러분은 Claude가 추가 정보가 필요할 때 호출할 수 있는 함수를 작성하며, Claude는 그 결과를 받아 응답을 구성하는 데 활용합니다.

각 단계의 코드가 표시된 도구 사용 흐름으로, 순서대로 JSON 스키마, ToolUse 부분, 도구 함수, ToolResult 부분입니다.

이 과정에는 도구 함수 작성, JSON 스키마 사양 작성, 해당 스키마로 Claude 호출, Claude가 요청할 때 도구 실행, 결과를 다시 Claude에 제공하는 등 여러 단계가 포함됩니다.

예시 get_weather 도구 함수: location이 비어 있으면 ValueError를 발생시키고, 그렇지 않으면 날씨 API 응답을 JSON으로 반환합니다.

도구 함수 작성하기

도구 함수는 Claude가 사용자를 돕기 위해 추가 정보가 필요하다고 판단했을 때 실행되는 일반적인 Python 함수입니다. 효과적으로 작성하는 방법은 다음과 같습니다:

모범 사례

  • 이름이 잘 지어진 설명적인 인자를 사용하세요 (이는 나중에 중요해집니다)
  • 입력값을 검증하고, 검증에 실패하면 오류를 발생시키세요
  • 의미 있는 오류를 반환하세요 - Claude는 오류가 발생하면 함수를 다시 호출하려고 시도합니다

bedrock-runtime용 boto3 클라이언트를 생성한 후 add_user_message, add_assistant_message, chat을 정의하는 노트북 셀입니다.

첫 번째 도구 만들기

가장 간단한 도구인 현재 날짜와 시간 가져오기부터 시작해봅시다. 이 함수는 날짜 형식 매개변수를 받아 현재 타임스탬프를 반환합니다:

python
from datetime import datetime, timedelta

def get_current_datetime(date_format="%Y-%m-%d %H:%M:%S"):
    return datetime.now().strftime(date_format)

이 함수는 간단하지만 핵심 원칙을 따릅니다: 설명적인 이름을 가지고 있고, 합리적인 기본값을 가진 이름이 잘 지어진 매개변수를 받으며, 약속한 것을 정확히 반환합니다.

JSON 스키마 사양

함수를 작성했다면, 이를 Claude에게 설명하는 JSON 스키마를 작성해야 합니다. 이 스키마는 함수가 어떤 인자를 필요로 하는지 Claude에게 알려주고, 언제 어떻게 도구를 사용해야 하는지 이해하는 데 도움을 줍니다.

날짜 형식 "lkajsflkajsfd"로 get_current_datetime을 호출하는 노트북 셀로, 출력 결과는 "lkajsflkajsfd"입니다.

JSON 스키마는 두 가지 목적을 가집니다: Claude가 함수에 필요한 인자를 이해하도록 도와주며, 단지 LLM 개념인 것만은 아닙니다 - JSON 스키마는 다양한 프로그래밍 환경에서 데이터 검증을 위해 흔히 사용됩니다. 스키마 생성을 도와주는 온라인 도구도 많이 있습니다.

스키마 모범 사례

  • 도구가 무엇을 하는지, 언제 사용해야 하는지, 무엇을 반환하는지 설명하세요
  • 설명은 3~4문장을 목표로 하세요
  • 매개변수에 대한 상세한 설명을 제공하세요

도구 함수를 작성하고 스키마를 정의했다면, 이제 Claude와 통합하여 알림 설정과 같은 실제 작업을 처리할 수 있는 더 정교한 AI 상호작용을 구축할 준비가 된 것입니다.