Kimi 업무 흐름에서 도구 사용을 필수로 해도 특정 도구가 지정되지는 않습니다

한 장의 그림으로 이해하기

개념 비유입니다. 여러 공구 중 하나를 집는 행동은 도구 호출 필수, 특정 렌치를 가리키는 행동은 지정 함수 호출에 대응합니다. 그림의 공구 사용은 실제 API 실행 성공을 뜻하지 않습니다. 하나는 사용이라는 표시는 최소 한 개라는 뜻이며 정확히 하나만 허용한다는 뜻이 아닙니다.
내용의 흐름을 표현한 설명용 그림입니다. 실제 제품 화면이나 실행 결과가 아닙니다.
그림 크게 보기 ↗ (새 탭)

업무·자동화 · 판정 관망

그림을 글로 풀면

필수 호출과 도구 지정 구분

필수 조회 경로를 만들 때 도구 종류까지 고정됐다고 오해할 수 있습니다.

대상
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·업무 처리 시험 미실행.

함께 더 정확하게

질문·오류 제보

그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.

공개된 질문·제보

    아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.