*tools object[] | 工具配置 *配置给智能体使用的工具列表，最多支持 128 个工具。 *内置工具集和 MCP 工具可通过 configs 和 default_config 设置启用状态及权限策略。 *MCP 工具通过 mcp_server_name 关联 mcp_servers[].name。 *自定义工具需填写名称、功能描述和输入参数定义。 *创建 Seedance Managed Agent 时，必须同时配置基础工具集和多模态工具集。基础工具集使用 agent_toolset_20260916；多模态工具集使用 agent_toolset_multimodal_20260825。 *多模态工具集中必须启用 image_generate、visual_search、general_search 和 compose_video；video_generate 可按需启用。 *启用 general_search 时，必须关闭基础工具集中的 web_search。 * * * * * * * *type string 必选 | 工具类型 *tools.type *工具类型。 *agent_toolset_20260916：使用方舟内置的 bash、edit、read、write、glob、grep、web_fetch 和 web_search 工具。 *agent_toolset_multimodal_20260825：使用 image_generate、video_generate、visual_search、general_search、compose_video 和 todo_write 工具。 *mcp_toolset：使用指定 MCP 服务提供的工具。 *custom：使用由客户端执行的自定义工具。 *可选值：agent_toolset_20260401、agent_toolset_20260701、agent_toolset_20260916、agent_toolset_multimodal_20260825、mcp_toolset、custom。 *configs object[] | 工具配置列表 *tools.configs *按工具名称设置工具的启用状态和权限策略。 * * * * *name string 必选 | 工具名称 *tools.configs.name *工具配置对应的工具名称。 *enabled boolean | 是否启用 *tools.configs.enabled *是否启用此工具。 *models object[] | 工具模型列表 *tools.configs.models *图片生成或视频生成工具使用的模型 ID 或推理接入点 ID 列表。省略时，服务端为已启用的生成工具绑定平台默认模型，并在响应中返回实际绑定结果。 *说明 *最多填写 10 项，且同一工具配置内的 ID 不能重复。配置多项时，必须且只能将一项的 default 设置为 true。 * * *id string 必选 | 模型或接入点 ID *tools.configs.models.id *图片生成或视频生成工具调用的模型 ID 或推理接入点 ID。 *注意 *所填模型 ID 或推理接入点 ID 对应的模型必须支持当前图片生成或视频生成工具。使用推理接入点 ID 时，该接入点必须属于当前项目；否则，服务端返回 400 InvalidParameter。 *default boolean 默认值 false | 是否为默认模型 *tools.configs.models.default *是否作为该工具的默认模型。配置多个模型或接入点时，必须且只能将一项设置为 true。 *permission_policy object | 权限策略 *tools.configs.permission_policy *该工具使用的权限策略。 * *type string 必选 | 策略类型 *tools.configs.permission_policy.type *工具调用许可策略。 *always_allow：表示总是允许调用。 *always_ask：表示每次使用前需要确认。 *default_config object | 默认工具配置 *tools.default_config *未在 configs 中单独配置的工具所使用的默认启用状态和权限策略。 * * *enabled boolean | 是否启用 *tools.default_config.enabled *是否默认启用未在 configs 中单独配置的工具。 *true：表示默认启用。 *false：表示默认禁用。 *permission_policy object | 权限策略 *tools.default_config.permission_policy *未在 configs 中单独配置的工具所使用的默认权限策略。 * *type string 必选 | 策略类型 *tools.default_config.permission_policy.type *工具调用许可策略。 *always_allow：表示总是允许调用。 *always_ask：表示每次使用前需要确认。 *description string | 自定义工具描述 *tools.description *说明自定义工具的功能和适用场景，供模型判断何时调用该工具。 *说明 *type 为 custom 时必填，长度为 1～10000 个字符。 *input_schema object | 输入参数定义 *tools.input_schema *定义自定义工具的输入参数及其约束。 *注意 *创建 Agent 时，服务端会确认 input_schema.type 为 object，并确认 input_schema.properties 是 JSON 对象，但不会逐项检查其中的属性定义。 *运行 Session 时，服务端会检查完整的 input_schema 是否为合法 JSON Schema。创建 Agent 成功不代表该 Schema 一定可以正常运行。 *模型生成的工具调用参数只会校验是否为合法 JSON。执行自定义工具前，你的应用应按 input_schema 再次校验参数。 * * * *properties object | 参数属性定义 *tools.input_schema.properties *自定义工具输入参数的 JSON Schema 属性映射。键为参数名，值为对应参数的 JSON Schema 子对象。请确保每个属性定义均符合 JSON Schema。 *常用关键字包括： *type：参数类型，如 string、number、integer、boolean、array 或 object。 *description：参数的用途说明，供模型理解并生成参数。 *enum：参数允许使用的值。 *items：数组元素的 JSON Schema。 *对象结构关键字：用于声明对象的子字段及必填字段，包括 properties 和 required。 *数值范围关键字：用于声明数值参数的取值范围，包括 minimum 和 maximum。 *示例： * *required string[] | 必填参数名称列表 *tools.input_schema.required *自定义工具输入中必填的参数名称列表。列表中的每个名称必须与 properties 中定义的参数名称一致。 *type string 默认值 object | Schema 类型 *tools.input_schema.type *指定 JSON Schema 的顶层类型，仅支持 object。 *mcp_server_name string | MCP 服务名称 *tools.mcp_server_name *MCP 工具所属的 MCP 服务名称。 *name string | 自定义工具名称 *tools.name *自定义工具的名称。 *说明 *type 为 custom 时必填。长度为 1～128 个字符，只能包含字母、数字、下划线和连字符，且同一 Agent 内的自定义工具名称不能重复。