7장 도구 계약을 작고 결정적으로 만든다

음성 에이전트가 호출하는 도구는 한 가지 일을 해야 한다. manage_booking 하나에 검색, 생성, 취소, 결제를 모두 넣지 않는다.

list_available_dates(service, month)
create_booking_draft(service, date, name, request_id)
request_human_review(draft_id, reason)
cancel_draft(draft_id)

각 도구에는 허용 값, 필수 필드, 오류 코드, 외부 행동 여부를 쓴다. 읽기 도구와 쓰기 도구를 구분한다. 쓰기 도구는 확인된 필드와 멱등성 키를 요구한다.

도구 결과를 그대로 길게 읽지 않는다. 사용자에게 필요한 값만 자연어로 요약하고, 중요한 날짜와 비용은 화면에도 표시한다. 도구가 실패하면 성공한 것처럼 이어 가지 않는다.