로드 중
로드 중

핵심 도구 처리 인프라가 갖춰지면 Claude 구현에 여러 도구를 추가하는 것이 간단해집니다. 이 튜토리얼에서는 간단한 패턴을 따라 추가 도구를 통합하는 방법을 보여줍니다.

우리가 필요로 하는 세 가지 도구: 현재 날짜와 시간 가져오기, 날짜 시간에 기간 추가하기, 알림 설정하기가 아래에 설명되어 있습니다.

추가할 도구들

알림 시스템을 위해 세 가지 주요 기능이 필요합니다:

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

좋은 소식은 구현 작업의 대부분이 이미 완료되어 있다는 것입니다. add_duration_to_datetime 함수와 set_reminder 함수가 해당 스키마와 함께 제공됩니다.

대화에 도구 추가하기

먼저, run_conversation 함수를 업데이트하여 새로운 도구 스키마를 도구 목록에 포함시킵니다:

python
response = chat(messages, tools=[
    get_current_datetime_schema,
    add_duration_to_datetime_schema,
    set_reminder_schema
])

이를 통해 Claude는 대화 중 사용할 수 있는 세 가지 도구에 대해 모두 알게 됩니다.

도구 라우터 업데이트하기

다음으로, run_tool 함수를 수정하여 새로운 도구 호출을 처리합니다. 각 새 도구에 대한 elif 케이스를 추가하세요:

python
def run_tool(tool_name, tool_input):
    if tool_name == "get_current_datetime":
        return get_current_datetime(**tool_input)
    elif tool_name == "add_duration_to_datetime":
        return add_duration_to_datetime(**tool_input)
    elif tool_name == "set_reminder":
        return set_reminder(**tool_input)

패턴은 간단합니다: 도구 이름을 확인하고, 제공된 입력으로 해당 함수를 호출한 다음, 결과를 반환합니다.

여러 도구 사용 테스트하기

시스템을 테스트하려면 여러 도구가 필요한 요청을 시도해 보세요: "병원 예약에 대한 알림을 설정해줘. 2050년 1월 1일로부터 177일 후야."

이 요청은 Claude가 다음을 수행하도록 만듭니다:

  1. 날짜 계산하기 (add_duration_to_datetime 사용)
  2. 알림 설정하기 (set_reminder 사용)

노트북 출력에서 set_reminder가 "Setting the following reminder for 2050-06-27T00:00:00: Doctor's appointment"를 출력합니다.

Claude는 먼저 무엇을 해야 하는지 설명한 다음, 적절한 도구 호출을 순서대로 수행함으로써 이를 처리합니다. 대화에서는 Claude가 목표 날짜로 2050년 6월 27일을 계산한 다음 해당 날짜로 알림을 설정하는 모습을 보여줍니다.

메시지 흐름 이해하기

대화 기록을 살펴보면 전체 메시지 구조를 볼 수 있습니다:

  • 요청이 담긴 사용자 메시지
  • 텍스트와 도구 사용 블록을 모두 포함한 어시스턴트 메시지
  • 도구 결과 메시지
  • 후속 어시스턴트 메시지

각 어시스턴트 메시지는 TextBlock과 ToolUseBlock을 쌍으로 가지며, 도구 결과는 "Monday, June 27, 2050 12:00:00 AM"입니다.

이는 Claude가 단일 메시지에 여러 블록을 포함할 수 있음을 보여줍니다 - 설명 텍스트와 도구 사용 요청을 결합하는 것입니다.

도구 추가를 위한 간단한 패턴

핵심 도구 인프라가 갖춰지면, 새로운 도구를 추가하는 것은 다음 패턴을 따릅니다:

  1. 도구 함수 구현을 만듭니다
  2. 도구 스키마를 정의합니다
  3. run_conversation의 도구 목록에 스키마를 추가합니다
  4. run_tool에 해당 도구에 대한 케이스를 추가합니다

이 모듈식 접근 방식을 사용하면 기존 코드를 재구성하지 않고도 AI 어시스턴트의 기능을 쉽게 확장할 수 있습니다. 각각의 새로운 도구는 기존 대화 흐름 및 도구 처리 로직과 매끄럽게 통합됩니다.