文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 沙箱工具/ 工具管理/ 查询工具支持特性列表 - ListCoreToolSupportedFeatures
更新时间:2026-11-09 GMT+08:00
分享

查询工具支持特性列表 - ListCoreToolSupportedFeatures

功能介绍

查询工具支持特性列表。

调用方法

请参见如何调用API。

授权信息

当前API调用无需身份策略权限。

URI

GET /v1/core/tool-supported-features

表1 Query参数

参数

是否必选

参数类型

描述

tool_id

是

String

参数解释: 工具的唯一标识符。 代码解释器或者浏览器工具列表页中对应的ID。

约束限制: 不涉及。

取值范围: 匹配标准的UUID格式(8-4-4-4-12的十六进制数字串,由连字符分隔),符合正则条件^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$。

默认取值: 不涉及。

limit

否

Integer

参数解释:

分页查询时每页返回的记录数量,用于控制单次查询返回的数据量。

约束限制:

不涉及。

取值范围:

正整数,取值范围为1-1000。

默认取值:

1000。

offset

否

Integer

参数解释:

分页查询的偏移量,表示从第几条记录开始查询,用于分页场景。

约束限制:

不涉及。

取值范围:

非负整数,取值范围为0-100000。

默认取值:

0。

请求参数

无

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

supported_features

Array of strings

参数解释:

工具支持的特性列表。

取值范围:

数组长度为1-1000个。

size

Integer

参数解释:

当前页返回的特性数量。

取值范围:

取值为 0-1000个。

total

Integer

参数解释:

特性总数。

取值范围:

取值为 0-1000000个。

状态码:400

表3 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:401

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

状态码:403

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

encoded_authorization_message

String

参数解释:

编码后的授权失败信息。

取值范围:

长度1到4096个字符。

details

Array of CoreToolsCommonError objects

参数解释:

依赖的下游服务错误信息列表。

取值范围:

数组长度0到10个元素。

表6 CoreToolsCommonError

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

满足正则^AgentArts.0400\d{4}$,例如AgentArts.04000404。

error_msg

String

参数解释:

错误信息。

取值范围:

符合正则:^[a-zA-Z0-9\s\u4e00-\u9fff.,!?;:()'"-\u3002\uff0c\uff01\uff1f\uff1b\uff1a\uff08\uff09]+$。

请求示例

无

响应示例

状态码:200

{
  "total" : 1,
  "size" : 1,
  "supported_features" : [ "ts_language" ]
}

状态码:400

{
  "error_code" : "AgentArts.04000400",
  "error_msg" : "Invalid parameter."
}

状态码:401

{
  "error_code" : "AgentArts.04000401",
  "error_msg" : "Authentication failed: invalid token."
}

状态码:403

{
  "error_code" : "AgentArts.04000403",
  "error_msg" : "Authentication failed: you have no permission of XXX",
  "encoded_authorization_message" : "eyJlcnJvciI6ICJVbmF1dGhvcml6ZWQifQ==",
  "details" : [ {
    "error_code" : "AgentArts.04000403",
    "error_msg" : "Authentication failed."
  } ]
}

状态码

状态码

描述

200

OK。

400

请求参数错误。

401

认证失败。

403

权限不足。

错误码

请参见错误码。

相关文档