API
API
Types
AIToolChoice

AIToolChoice

call 시 LLM의 도구(tool) 호출 정책.

  • "auto"(기본): 모델이 호출 여부·대상을 판단한다.

  • "none": 도구 호출 없이 메시지만 응답한다.

  • "required": 등록된 도구 중 하나를 반드시 호출한다.

  • { tool }: 지정한 특정 도구를 강제로 호출한다(args는 모델이 채움).
    provider별로 OpenAI tool_choice / Gemini functionCallingConfig로 매핑된다.
    주의: 특정 도구 강제 시 의도와 무관하게 args를 억지로 만들 수 있으므로 확신할 때만 사용한다.

  • Type: 'auto' | 'none' | 'required'{ tool: string; }