ListTools - 列出工具-智能体 AgentRun(AgentRun)-阿里云帮助中心

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

agentrun:ListTools

list

*全部资源

*

无

请求语法

GET /2025-09-10/agents/tools HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
pageSize	integer	否	每页大小	10
pageNumber	integer	否	页码	1
toolType	string	否	工具类型枚举值： MCP : MCP 工具 - 基于 Model Context Protocol 的工具 FUNCTIONCALL : 函数调用工具 - 通过函数调用方式实现的工具 SKILL : 技能工具 - 预定义的技能类型工具	MCP
toolName	string	否	工具名称，支持模糊搜索	tool-1
workspaceId	string	否	工作空间 ID	workspace-xyz789
workspaceIds	string	否	工作空间列表，逗号分隔	ws1,ws2

返回参数

名称	类型	描述	示例值
	ListToolsResult	工具列表返回结果

示例

正常返回示例

JSON格式

{
  "code": "",
  "requestId": "",
  "data": {
    "pageSize": 10,
    "pageNumber": 1,
    "total": 100,
    "items": [
      {
        "toolId": "tool-abc123",
        "toolName": "my-mcp-tool",
        "workspaceId": "workspace-xyz789",
        "description": "这是一个用于处理文档的 MCP 工具",
        "toolType": "MCP",
        "createMethod": "MCP_REMOTE",
        "protocolSpec": "",
        "mcpConfig": {
          "sessionAffinity": "MCP_STREAMABLE",
          "sessionAffinityConfig": "",
          "proxyEnabled": true,
          "mcpProxyConfiguration": {
            "hooks": [
              {
                "url": "",
                "description": "",
                "apiVersion": "",
                "enabled": true,
                "timeout": 0,
                "event": "",
                "headers": {
                  "key": ""
                }
              }
            ]
          },
          "boundConfiguration": {
            "boundTools": [
              {
                "toolName": "my-tool",
                "method": "POST",
                "path": "/api/v1/tools",
                "apis": [
                  {
                    "method": "",
                    "path": ""
                  }
                ]
              }
            ]
          }
        },
        "status": "Running",
        "statusReason": "",
        "executionRoleArn": "acs:ram::123456789:role/AliyunFCDefaultRole",
        "artifactType": "Code",
        "networkConfiguration": {
          "networkMode": "PRIVATE",
          "vpcId": "vpc-1234567890abcdef0",
          "securityGroupId": "sg-1234567890abcdef0",
          "vswitchIds": [
            "vsw-sg-1234567890abcdef0"
          ]
        },
        "codeConfiguration": {
          "zipFile": "UEsDBAoAAAAAANF",
          "ossBucketName": "my-agent-code-bucket",
          "ossObjectName": "agent-code-v1.0.zip",
          "checksum": "1234567890123456789",
          "language": "python3.12",
          "command": [
            ""
          ]
        },
        "containerConfiguration": {
          "image": "registry.cn-hangzhou.aliyuncs.com/my-namespace/agent-runtime:latest",
          "imageRegistryType": "ACR",
          "acrInstanceId": "cri-xxxxx",
          "command": [
            "/usr/local/bin/entrypoint.sh"
          ],
          "registryConfig": {
            "authConfig": {
              "userName": "admin",
              "password": "abc***"
            },
            "certConfig": {
              "insecure": false,
              "rootCaCertBase64": "cm9vdF9jYV9jZXJ0X2Jhc2U2NA=="
            },
            "networkConfig": {
              "vpcId": "vpc-xxxxxxxxxxxxx",
              "vSwitchId": "vsw-xxxxxxxxxxxxx",
              "securityGroupId": "sg-xxxxxxxxxxxxx"
            }
          },
          "port": 5000
        },
        "logConfiguration": {
          "project": "agent-runtime-logs",
          "logstore": "agent-runtime-logs"
        },
        "ossMountConfig": {
          "mountPoints": [
            {
              "bucketName": "my-bucket",
              "bucketPath": "/my-dir",
              "endpoint": "http://oss-cn-shanghai.aliyuncs.com",
              "mountDir": "/mnt/dir",
              "readOnly": true
            }
          ]
        },
        "nasConfig": {
          "groupId": 100,
          "mountPoints": [
            {
              "enableTLS": true,
              "mountDir": "/home/test",
              "serverAddr": "***-uni85.cn-hangzhou.nas.com:/"
            }
          ],
          "userId": 100
        },
        "cpu": 0.5,
        "memory": 512,
        "port": 8080,
        "createdAt": "2025-09-10T10:00:00Z",
        "updatedAt": "2025-09-10T12:00:00Z",
        "credentialName": "my-credential",
        "timeout": 300,
        "environmentVariables": {
          "key": ""
        }
      }
    ]
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。