한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
업무·자동화 · 판정 관망
그림을 글로 풀면
필수 호출과 도구 지정 구분
필수 조회 경로를 만들 때 도구 종류까지 고정됐다고 오해할 수 있습니다.
- 대상
- Kimi로 조회 업무를 구성하는 개발자
- 무엇이 바뀜
- required는 이번 응답에서 최소 한 도구 호출을 요구합니다.
- 왜 중요한가
- 특정 함수 지정은 별도이며 thinking 설정과 제약이 있습니다.
- 지금 할 일
- 필수 여부와 지정할 함수 이름을 따로 결정하세요.
- 한계·미확인
- 개념 비유. Kimi API·업무 처리 시험 미실행.
- 확인일
- 2026-11-18
조회가 꼭 필요한 차례를 먼저 구분하기
가상의 재고 답변 업무에서 조회 없이 답하지 않도록 구성한다고 가정합니다. AINOW는 도구 호출이 반드시 필요한 차례와 조회 후 문장으로 답하는 차례를 나눠 적도록 제안합니다. 매 요청에 같은 설정을 반복하기 전에 그 차례의 목적을 확인하세요.
필수와 지정이 제한하는 대상
Kimi 공식 문서에서 tool_choice의 required는 최소 한 개의 도구 호출을 요구합니다. 호출 가능한 도구도 요청에 선언해야 합니다. 특정 함수 이름을 가진 객체를 전달하는 설정은 그 함수를 지정합니다. 따라서 여러 도구가 있을 때 required만으로 원하는 함수 이름이 고정됐다고 판단하면 안 됩니다. auto는 모델이 선택하고 none은 도구 호출을 막습니다.
설정의 수명과 호환성을 확인하기
이 설정은 요청마다 독립적으로 적용됩니다. 공식 문서는 특정 함수를 강제 지정하는 방식이 thinking 활성 상태와 호환되지 않아 400 오류를 낸다고 안내합니다. required 전체가 thinking과 호환되지 않는다는 뜻으로 확대하지 마세요. AINOW는 요청 설정, 반환된 도구 이름, 후속 실행 결과를 나눠 기록하도록 제안합니다. 실제 API 호출이나 재고 조회는 시험하지 않았습니다.
참고 원문: Kimi 공식 Tool Choice 문서 · 원문 게시일 상시 문서·게시일 미표기 · 확인일 2026-11-18
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- 2026-11-18 공식 문서 확인; 확인일은 출시일이 아님. API 및 결과 시험 미실행
- 확인일
- 2026-11-18
- 검증 상태
- 개발자 주장
- 한계·주의
- 개념 비유. Kimi API·업무 처리 시험 미실행.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.