你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ToolChoiceAllowed interface

将模型可用的工具限制为预定义集。

属性

将模型可用的工具限制为预定义集。 auto 允许模型从允许的工具中选择并生成信息。 required 要求模型调用一个或多个允许的工具。

应允许模型调用的工具定义列表。对于响应 API，工具定义列表可能如下所示：

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

允许的工具配置类型。始终为 allowed_tools。

将模型可用的工具限制为预定义集。 auto 允许模型从允许的工具中选择并生成信息。 required 要求模型调用一个或多个允许的工具。

mode: "auto" | "required"

"auto" | "required"

应允许模型调用的工具定义列表。对于响应 API，工具定义列表可能如下所示：

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

tools: Record<string, unknown>[]

Record<string, unknown>[]

允许的工具配置类型。始终为 allowed_tools。

type: "allowed_tools"

"allowed_tools"