ToolChoiceAllowed interface

모델에 사용할 수 있는 도구를 미리 정의된 집합으로 제한합니다.

Extends

속성

mode

모델에 사용할 수 있는 도구를 미리 정의된 집합으로 제한합니다. auto 모델이 허용된 도구 중에서 선택해 메시지를 생성할 수 있게 합니다. required 에서는 모델이 허용된 도구 중 하나 이상을 호출해야 합니다.

tools

모델을 호출할 수 있어야 하는 도구 정의 목록입니다. 응답 API의 경우 도구 정의 목록은 다음과 같을 수 있습니다.

[
  { "type": "function", "name": "get_weather" },
  { "type": "mcp", "server_label": "deepwiki" },
  { "type": "image_generation" }
]
type

허용되는 도구 구성 유형입니다. 항상 allowed_tools입니다.

속성 세부 정보

mode

모델에 사용할 수 있는 도구를 미리 정의된 집합으로 제한합니다. auto 모델이 허용된 도구 중에서 선택해 메시지를 생성할 수 있게 합니다. required 에서는 모델이 허용된 도구 중 하나 이상을 호출해야 합니다.

mode: "auto" | "required"

속성 값

"auto" | "required"

tools

모델을 호출할 수 있어야 하는 도구 정의 목록입니다. 응답 API의 경우 도구 정의 목록은 다음과 같을 수 있습니다.

[
  { "type": "function", "name": "get_weather" },
  { "type": "mcp", "server_label": "deepwiki" },
  { "type": "image_generation" }
]
tools: Record<string, unknown>[]

속성 값

Record<string, unknown>[]

type

허용되는 도구 구성 유형입니다. 항상 allowed_tools입니다.

type: "allowed_tools"

속성 값

"allowed_tools"