로드 중
로드 중

Claude가 도구 호출을 요청한 후에는 해당 함수를 실행하고 결과를 다시 전송해야 합니다. 이렇게 하면 Claude에게 요청한 정보를 제공함으로써 도구 사용 워크플로우가 완성됩니다.

도구 함수 실행하기

Claude가 도구 사용 블록으로 응답하면, 입력 매개변수를 추출하여 함수를 호출합니다. 도구 매개변수에 접근하는 방법은 다음과 같습니다:

python
# 도구 사용 블록에 접근
tool_use_block = response.content[1]

# 입력 매개변수 가져오기
input_params = tool_use_block.input

# 매개변수로 함수 호출
result = get_current_datetime(**input_params)

이중 별표(**)는 딕셔너리를 함수가 기대하는 키워드 인자로 풀어줍니다.

도구 결과 블록

도구를 실행한 후에는 도구 결과 블록을 사용하여 결과를 Claude에게 다시 전송합니다. 이 블록에는 몇 가지 중요한 속성이 있습니다:

타입 "tool_result", 콘텐츠 "12:47:13", is_error False, 그리고 일치하는 tool_use_id를 가진 도구 결과 JSON 예시.

  • tool_use_id - 원래 도구 사용 블록의 ID와 일치해야 합니다
  • content - 도구 함수의 출력으로, 문자열로 변환됩니다
  • is_error - 실행 중 오류가 발생한 경우 true로 설정합니다

여러 도구 호출 처리하기

Claude는 한 번의 응답에서 여러 도구 호출을 요청할 수 있습니다. 예를 들어, 사용자가 "10 + 10은 얼마이고 30 + 30은 얼마인가요?"라고 물으면, Claude는 두 개의 별도 도구 사용 블록을 보낼 수 있습니다:

Claude가 10 + 10에 대한 계산기 도구 사용 블록 ab3와 30 + 30에 대한 po9를 전송합니다; 결과는 po9 출력 60, 그다음 ab3 20으로 반환됩니다.

각 도구 사용 블록은 고유한 ID를 가지며, 결과를 다시 전송할 때 이 ID들을 일치시켜야 합니다:

Claude가 10 + 10에 대한 도구 사용 ab3와 30 + 30에 대한 po9를 반환합니다; 우리 서버는 po9 출력 60, 그다음 ab3 출력 20으로 응답합니다.

이 ID 시스템은 결과가 다른 순서로 도착하더라도 Claude가 각 결과를 해당 요청과 올바르게 매칭할 수 있도록 보장합니다.

후속 요청 전송하기

Claude에게 보내는 후속 요청에는 전체 대화 기록과 새로운 도구 결과가 포함되어야 합니다:

python
messages.append({
    "role": "user",
    "content": [{
        "type": "tool_result",
        "tool_use_id": response.content[1].id,
        "content": result,
        "is_error": False
    }]
})

대화 흐름은 다음과 같습니다:

우리 서버가 Claude에게 도구 스키마, "현재 시각이 몇 시인가요?"라는 질문, 도구 사용 및 도구 결과 블록을 전송합니다.

Claude가 다시 도구를 호출할 필요가 없을 가능성이 높더라도, 후속 요청에는 도구 스키마를 포함시키는 것을 잊지 마세요. Claude는 대화 기록에 있는 도구 참조를 이해하기 위해 스키마가 필요합니다.

전체 워크플로우

전체 과정은 다음과 같습니다:

  1. 사용자가 도구 사용이 필요한 질문을 합니다
  2. Claude가 도구 사용 블록으로 응답합니다
  3. 요청된 도구 함수를 실행합니다
  4. 도구 결과와 함께 후속 요청을 전송합니다
  5. Claude가 도구 출력을 사용하여 최종 답변을 제공합니다

최종 요청에는 전체 메시지 기록, 도구 결과 블록, 그리고 도구 스키마가 포함됩니다. 그러면 Claude는 도구 실행 결과의 정보를 반영한 일반 텍스트 메시지로 응답합니다.