로드 중
로드 중

이제 도구 하나가 제대로 작동하게 되었으니, 프로젝트를 완성하기 위해 나머지 두 개의 도구인 add_duration_to_datetime과 set_reminder를 추가할 차례입니다. 좋은 소식은 기본 토대가 갖춰지면 새로운 도구를 추가하는 작업이 매우 간단하다는 점입니다.

필요한 세 가지 도구: 현재 날짜와 시간을 가져오는 것, 날짜와 시간에 기간을 더하는 것(Claude가 완벽하게 처리하지 못하는 부분), 그리고 알림을 설정하는 것.

미리 작성된 함수와 스키마

시간을 절약할 수 있도록 추가되는 두 함수의 구현이 JSON 스키마 명세와 함께 이미 제공되어 있습니다. 앞서 나온 코드 셀에서 이를 확인할 수 있습니다:

  • add_duration_to_datetime - 다양한 시간 단위에 대한 날짜 연산을 처리합니다
  • set_reminder - 알림을 생성합니다(현재는 단순히 결과를 출력하지만, 실제 알림 시스템과 통합하도록 확장할 수 있습니다)

"seconds", "days", "months" 등의 단위에 대한 분기를 포함해 add_duration_to_datetime을 정의하는 노트북 셀.

각 함수에는 예상되는 매개변수와 그 타입을 정의하는 해당 JSON 스키마가 함께 제공됩니다.

대화에 도구 추가하기

첫 번째 단계는 새로운 도구 스키마를 대화 함수에 포함시키는 것입니다. run_conversation 함수에서 tools 배열에 추가 스키마를 넣으세요:

python
tools=[
    get_current_datetime_schema,
    add_duration_to_datetime_schema,
    set_reminder_schema
]

위의 세 스키마를 chat에 전달한 후 정지 이유가 "tool_use"가 아닐 때까지 반복하는 run_conversation 셀.

도구 함수 연결하기

다음으로, 새로운 도구 이름을 처리하도록 run_tool 함수를 업데이트해야 합니다. 두 개의 조건 분기를 추가로 넣으세요:

python
def run_tool(tool_name, tool_input):
    if tool_name == "get_current_datetime":
        return get_current_datetime(**tool_input)
    elif tool_name == "set_reminder":
        return set_reminder(**tool_input)
    elif tool_name == "add_duration_to_datetime":
        return add_duration_to_datetime(**tool_input)
    else:
        raise Exception(f"Unknown tool name: {tool_name}")

위에 표시된 run_tool 함수와, 이어서 toolUse 부분들을 수집하는 run_tools 함수가 있는 노트북 셀.

전체 시스템 테스트하기

모든 도구가 연결되면 이제 여러 도구 호출이 필요한 복잡한 워크플로우를 테스트할 수 있습니다. 예를 들어 Claude에게 "병원에 가야 한다는 알림을 설정해 줘. 진료 예약은 100일 후야"라고 요청하면 다음과 같은 일련의 작업이 실행됩니다:

  1. get_current_datetime을 사용해 오늘 날짜를 가져옵니다
  2. add_duration_to_datetime을 사용해 해당 날짜에 100일을 더합니다
  3. set_reminder를 사용해 알림을 생성합니다

노트북 출력: Claude가 단계를 계획한 후, 2025-07-12T00:00:00에 대한 "Go to the doctor appointment" 알림을 출력합니다.

Claude는 요청을 자동으로 논리적인 단계로 나누고, 각 도구 호출을 실행하기 전에 그 계획을 설명합니다. 출력 결과에는 계산된 미래 날짜와 알림이 설정되었다는 확인을 포함한 전체 워크플로우가 표시됩니다.

핵심 요점

도구 사용의 기본 인프라가 갖추어지면, 새로운 도구를 추가하는 데 필요한 것은 단 두 가지 간단한 단계뿐입니다: tools 배열에 스키마를 포함시키는 것과, 라우팅 함수에서 해당 도구 이름을 처리하는 case를 추가하는 것입니다. 초기 설정은 복잡하게 느껴질 수 있지만, 여러 도구로 확장하는 작업은 매우 수월하게 관리할 수 있습니다.