한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
업무·자동화 · 판정 관망
그림을 글로 풀면
도구 요청과 실제 결과 구분
내 앱이 실행하는 도구는 결과 반환까지 확인해야 합니다.
- 대상
- 업무 도구를 연결하는 개발자
- 무엇이 바뀜
- 클라이언트 도구 실행은 앱이 담당합니다.
- 왜 중요한가
- 호출 요청만으로 완료 표시하면 잘못 알립니다.
- 지금 할 일
- 요청·실행·결과 상태를 분리합니다.
- 한계·미확인
- 클라이언트 도구의 가상 재고 조회 예시입니다.
- 공식 출처
- Claude 도구 사용 공식 문서
- 확인일
- 2026-09-16
그림은 내 앱에서 실행하는 도구를 설명한다
그림에서 로봇이 직원에게 내미는 종이에는 아직 물음표가 있습니다. 이는 조회를 요청했다는 뜻이며 재고를 확인했다는 결과가 아닙니다. 직원이 권한을 확인하고 선반을 조회한 뒤 결과서를 돌려주는 행동이 클라이언트 도구를 실행하는 앱에 해당합니다. 마지막 답변은 그 결과를 모델이 전달받은 다음에 나옵니다. 주전자와 창고는 이해를 돕는 가상 장면이며 실제 재고나 API 실행을 시험한 결과가 아닙니다.
재고 조회 예시는 권한과 결과를 분리하기 위한 것
재고 수량이나 고객 자료를 실제로 조회하지 않은 가상 예시입니다. 조회 함수의 이름과 입력 형식이 맞더라도 해당 사용자가 그 항목을 조회할 권한이 있는지는 앱에서 확인해야 합니다. 권한 확인은 이 글이 제안하는 설계 조건이며 모델이 대신 보장하는 기능으로 설명하지 않습니다. 도구 오류가 반환되면 수량을 추측해 답하는 대신 조회 실패 상태가 사용자 화면까지 전달되도록 설계합니다.
완료 화면의 기준을 정한다
자체 업무 화면에는 요청됨, 실행 중, 결과 수신, 실패처럼 구분 가능한 상태를 둘 수 있습니다. 이 구분은 특정 SDK의 필수 열거값이 아니라 운영자가 어디서 멈췄는지 찾기 위한 제안입니다. 시험할 때는 정상 결과와 권한 거절, 조회 실패를 나눠 화면 표시를 확인합니다. 이 글에서는 실행이나 연결 시험을 하지 않았으며 프롬프트 인젝션 방어 전체를 다루거나 보장하지 않습니다.
참고 원문: Claude 도구 사용 공식 문서 · 원문 게시일 미확인 · 확인일 2026-09-16
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- 공식 웹 문서 2026-09-16 확인; 실행 미검증
- 확인일
- 2026-09-16
- 검증 상태
- 개발자 주장
- 한계·주의
- 클라이언트 도구의 가상 재고 조회 예시입니다.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.