{
  "name": "ags",
  "display_name": "Agent 沙箱服务",
  "description": "Agent Sandbox API密钥管理，沙箱管理、调用等",
  "domain": "other",
  "api_version": "2025-09-20",
  "endpoint": "ags.tencentcloudapi.com",
  "actions": [
    {
      "name": "AcquireSandboxInstanceToken",
      "description": "获取访问沙箱工具时所需要使用的访问Token，创建沙箱实例后需调用此接口获取沙箱实例访问Token。 此Token可用于调用代码沙箱实例执行代码，或浏览器沙箱实例进行浏览器操作等。",
      "status": "online",
      "parameters": [
        {
          "name": "InstanceId",
          "type": "string",
          "required": true,
          "description": "沙箱实例ID，生成的访问Token将仅可用于访问此沙箱实例",
          "example": "a123478903213307971e7bc5793"
        }
      ],
      "required": [
        "InstanceId"
      ]
    },
    {
      "name": "CreateAPIKey",
      "description": "创建新的API密钥，用于调用Agent Sandbox接口。相较于腾讯云Secret ID Secret Key支持调用所有接口使用，仅有部分接口支持使用API密钥调用。",
      "status": "online",
      "parameters": [
        {
          "name": "Name",
          "type": "string",
          "required": false,
          "description": "API密钥名称，方便用户记忆",
          "example": "LocalDev"
        }
      ],
      "required": []
    },
    {
      "name": "CreatePreCacheImageTask",
      "description": "创建镜像预热任务",
      "status": "online",
      "parameters": [
        {
          "name": "Image",
          "type": "string",
          "required": true,
          "description": "镜像地址",
          "example": "nginx:latest"
        },
        {
          "name": "ImageRegistryType",
          "type": "string",
          "required": true,
          "description": "镜像仓库类型：`enterprise`、`personal`。",
          "example": "enterprise"
        }
      ],
      "required": [
        "Image",
        "ImageRegistryType"
      ]
    },
    {
      "name": "CreateSandboxTool",
      "description": "创建沙箱工具",
      "status": "online",
      "parameters": [
        {
          "name": "ToolName",
          "type": "string",
          "required": true,
          "description": "沙箱工具名称，长度 1-50 字符，支持英文、数字、下划线和连接线。同一 AppId 下沙箱工具名称必须唯一",
          "example": "code-interpreter-v1"
        },
        {
          "name": "ToolType",
          "type": "string",
          "required": true,
          "description": "沙箱工具类型，目前支持：browser、code-interpreter、custom",
          "example": "code-interpreter"
        },
        {
          "name": "NetworkConfiguration",
          "type": "object",
          "required": true,
          "description": "网络配置",
          "example": "无",
          "children": [
            {
              "name": "NetworkMode",
              "type": "string",
              "required": true,
              "description": "网络模式（当前支持 PUBLIC, VPC, SANDBOX）",
              "example": "PUBLIC"
            },
            {
              "name": "VpcConfig",
              "type": "object",
              "required": false,
              "description": "VPC网络相关配置",
              "example": "无",
              "children": [
                {
                  "name": "SubnetIds",
                  "type": "array",
                  "required": false,
                  "description": "VPC子网ID列表",
                  "example": "[\"subnet-012abcde\", \"subnet-012edcba\"]",
                  "item_type": "string"
                },
                {
                  "name": "SecurityGroupIds",
                  "type": "array",
                  "required": false,
                  "description": "安全组ID列表",
                  "example": "[\"sg-abcde012\", \"sg-210edcba\"]",
                  "item_type": "string"
                }
              ]
            }
          ]
        },
        {
          "name": "Description",
          "type": "string",
          "required": false,
          "description": "沙箱工具描述，最大长度 200 字符",
          "example": "代码解释器沙箱工具"
        },
        {
          "name": "DefaultTimeout",
          "type": "string",
          "required": false,
          "description": "默认超时时间，支持格式：5m、300s、1h 等，不指定则使用系统默认值（5 分钟）。最大 24 小时",
          "example": "5m"
        },
        {
          "name": "Tags",
          "type": "array",
          "required": false,
          "description": "标签规格，为沙箱工具绑定标签，支持多种资源类型的标签绑定",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "Key",
              "type": "string",
              "required": false,
              "description": "标签键",
              "example": "business"
            },
            {
              "name": "Value",
              "type": "string",
              "required": false,
              "description": "标签值",
              "example": "biz1"
            }
          ]
        },
        {
          "name": "ClientToken",
          "type": "string",
          "required": false,
          "description": "幂等性 Token，长度不超过 64 字符",
          "example": "your-unique-client-token"
        },
        {
          "name": "RoleArn",
          "type": "string",
          "required": false,
          "description": "角色ARN",
          "example": "qcs::cam::uin/100000001:roleName/test_role"
        },
        {
          "name": "StorageMounts",
          "type": "array",
          "required": false,
          "description": "沙箱工具存储配置",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "Name",
              "type": "string",
              "required": false,
              "description": "存储挂载配置名称",
              "example": "Storage1"
            },
            {
              "name": "StorageSource",
              "type": "object",
              "required": false,
              "description": "存储配置",
              "example": "无",
              "children": [
                {
                  "name": "Cos",
                  "type": "object",
                  "required": false,
                  "description": "对象存储桶配置",
                  "example": "无",
                  "children": [
                    {
                      "name": "Endpoint",
                      "type": "string",
                      "required": false,
                      "description": "对象存储访问域名",
                      "example": "test-123456789.cos.ap-guangzhou.myqcloud.com"
                    },
                    {
                      "name": "BucketName",
                      "type": "string",
                      "required": false,
                      "description": "对象存储桶名称",
                      "example": "test-123456789"
                    },
                    {
                      "name": "BucketPath",
                      "type": "string",
                      "required": false,
                      "description": "对象存储桶路径，必须为以/起始的绝对路径",
                      "example": "/"
                    }
                  ]
                },
                {
                  "name": "Image",
                  "type": "object",
                  "required": false,
                  "description": "镜像卷配置",
                  "example": "无",
                  "children": [
                    {
                      "name": "Reference",
                      "type": "string",
                      "required": false,
                      "description": "镜像地址",
                      "example": "ccr.ccs.tencentyun.com/example/nginx:latest"
                    },
                    {
                      "name": "ImageRegistryType",
                      "type": "string",
                      "required": false,
                      "description": "镜像仓库类型：`enterprise`、`personal`。",
                      "example": "enterprise"
                    },
                    {
                      "name": "SubPath",
                      "type": "string",
                      "required": false,
                      "description": "镜像内部的路径",
                      "example": "/mnt/sub"
                    },
                    {
                      "name": "Digest",
                      "type": "string",
                      "required": false,
                      "description": "镜像 Digest，请求时无需传入",
                      "example": "sha256:abcdefg123..."
                    }
                  ]
                },
                {
                  "name": "Cfs",
                  "type": "object",
                  "required": false,
                  "description": "文件存储配置",
                  "example": "无",
                  "children": [
                    {
                      "name": "FileSystemId",
                      "type": "string",
                      "required": false,
                      "description": "CFS资源ID",
                      "example": "cfs-123456"
                    },
                    {
                      "name": "Path",
                      "type": "string",
                      "required": false,
                      "description": "CFS挂载路径",
                      "example": "/"
                    }
                  ]
                }
              ]
            },
            {
              "name": "MountPath",
              "type": "string",
              "required": false,
              "description": "沙箱实例本地挂载路径",
              "example": "/home/user"
            },
            {
              "name": "ReadOnly",
              "type": "boolean",
              "required": false,
              "description": "存储挂载读写权限配置，默认为false",
              "example": "false"
            }
          ]
        },
        {
          "name": "CustomConfiguration",
          "type": "object",
          "required": false,
          "description": "沙箱工具自定义配置",
          "example": "无",
          "children": [
            {
              "name": "Image",
              "type": "string",
              "required": false,
              "description": "镜像地址",
              "example": "test.tencentcloudcr.com/example/nginx:latest"
            },
            {
              "name": "ImageRegistryType",
              "type": "string",
              "required": false,
              "description": "镜像仓库类型：`enterprise`、`personal`。",
              "example": "enterprise"
            },
            {
              "name": "Command",
              "type": "array",
              "required": false,
              "description": "启动命令",
              "example": "[\"/bin/bash\", \"-c\"]",
              "item_type": "string"
            },
            {
              "name": "Args",
              "type": "array",
              "required": false,
              "description": "启动参数",
              "example": "[\"-h\", \"0.0.0.0\", \"-p\", \"8000\"]",
              "item_type": "string"
            },
            {
              "name": "Env",
              "type": "array",
              "required": false,
              "description": "环境变量",
              "example": "无",
              "item_type": "object",
              "children": [
                {
                  "name": "Name",
                  "type": "string",
                  "required": false,
                  "description": "环境变量名",
                  "example": "TEST_ENV"
                },
                {
                  "name": "Value",
                  "type": "string",
                  "required": false,
                  "description": "环境变量值",
                  "example": "ABD"
                }
              ]
            },
            {
              "name": "Ports",
              "type": "array",
              "required": false,
              "description": "端口配置",
              "example": "无",
              "item_type": "object",
              "children": [
                {
                  "name": "Name",
                  "type": "string",
                  "required": false,
                  "description": "端口名",
                  "example": "http"
                },
                {
                  "name": "Port",
                  "type": "integer",
                  "required": false,
                  "description": "端口",
                  "example": "8000"
                },
                {
                  "name": "Protocol",
                  "type": "string",
                  "required": false,
                  "description": "协议",
                  "example": "TCP"
                }
              ]
            },
            {
              "name": "Resources",
              "type": "object",
              "required": false,
              "description": "资源配置",
              "example": "无",
              "children": [
                {
                  "name": "CPU",
                  "type": "string",
                  "required": false,
                  "description": "cpu 资源量",
                  "example": "500m"
                },
                {
                  "name": "Memory",
                  "type": "string",
                  "required": false,
                  "description": "内存资源量",
                  "example": "1Gi"
                }
              ]
            },
            {
              "name": "Probe",
              "type": "object",
              "required": false,
              "description": "探针配置",
              "example": "无",
              "children": [
                {
                  "name": "HttpGet",
                  "type": "object",
                  "required": false,
                  "description": "HTTP GET 探测配置",
                  "example": "无",
                  "children": [
                    {
                      "name": "Path",
                      "type": "string",
                      "required": false,
                      "description": "路径",
                      "example": "/health"
                    },
                    {
                      "name": "Port",
                      "type": "integer",
                      "required": false,
                      "description": "端口",
                      "example": "8000"
                    },
                    {
                      "name": "Scheme",
                      "type": "string",
                      "required": false,
                      "description": "协议",
                      "example": "HTTP"
                    }
                  ]
                },
                {
                  "name": "ReadyTimeoutMs",
                  "type": "integer",
                  "required": false,
                  "description": "健康检查就绪超时",
                  "example": "30000"
                },
                {
                  "name": "ProbeTimeoutMs",
                  "type": "integer",
                  "required": false,
                  "description": "健康检查单次探测超时",
                  "example": "1000"
                },
                {
                  "name": "ProbePeriodMs",
                  "type": "integer",
                  "required": false,
                  "description": "健康检查间隔",
                  "example": "1000"
                },
                {
                  "name": "SuccessThreshold",
                  "type": "integer",
                  "required": false,
                  "description": "健康检查成功阈值",
                  "example": "1"
                },
                {
                  "name": "FailureThreshold",
                  "type": "integer",
                  "required": false,
                  "description": "健康检查失败阈值",
                  "example": "3"
                }
              ]
            }
          ]
        },
        {
          "name": "LogConfiguration",
          "type": "object",
          "required": false,
          "description": "沙箱工具日志推送相关配置",
          "example": "无",
          "children": [
            {
              "name": "CLSConfig",
              "type": "object",
              "required": false,
              "description": "日志推送CLS的配置。",
              "example": "无",
              "children": [
                {
                  "name": "TopicId",
                  "type": "string",
                  "required": false,
                  "description": "沙箱工具日志推送所使用的CLS日志主题ID",
                  "example": "123e4567-e89b-12d3-a456-426614174000"
                }
              ]
            }
          ]
        }
      ],
      "required": [
        "ToolName",
        "ToolType",
        "NetworkConfiguration"
      ]
    },
    {
      "name": "DeleteAPIKey",
      "description": "删除API密钥。注意区别于腾讯云Secret ID Secret Key，本接口删除的是Agent Sandbox专用API key。",
      "status": "online",
      "parameters": [
        {
          "name": "KeyId",
          "type": "string",
          "required": true,
          "description": "需要删除的API密钥ID",
          "example": "ark-2wsxdr5t"
        }
      ],
      "required": [
        "KeyId"
      ]
    },
    {
      "name": "DeleteSandboxTool",
      "description": "删除沙箱工具",
      "status": "online",
      "parameters": [
        {
          "name": "ToolId",
          "type": "string",
          "required": true,
          "description": "沙箱工具ID",
          "example": "sdt-dibk4rra"
        }
      ],
      "required": [
        "ToolId"
      ]
    },
    {
      "name": "DescribeAPIKeyList",
      "description": "获取API密钥列表，包含API密钥简略信息，包含名称、创建时间等。",
      "status": "online",
      "parameters": [],
      "required": []
    },
    {
      "name": "DescribePreCacheImageTask",
      "description": "查询镜像预热任务信息",
      "status": "online",
      "parameters": [
        {
          "name": "Image",
          "type": "string",
          "required": true,
          "description": "镜像地址",
          "example": "nginx:latest"
        },
        {
          "name": "ImageDigest",
          "type": "string",
          "required": true,
          "description": "镜像 Digest",
          "example": "sha256:abcdefg123..."
        },
        {
          "name": "ImageRegistryType",
          "type": "string",
          "required": true,
          "description": "镜像仓库类型：`enterprise`、`personal`。",
          "example": "enterprise"
        }
      ],
      "required": [
        "Image",
        "ImageDigest",
        "ImageRegistryType"
      ]
    },
    {
      "name": "DescribeSandboxInstanceList",
      "description": "查询沙箱实例列表",
      "status": "online",
      "parameters": [
        {
          "name": "InstanceIds",
          "type": "array",
          "required": false,
          "description": "沙箱实例ID列表，指定要查询的实例。如果为空则查询所有实例。最大支持100个ID",
          "example": "[\"c8f390ac57ce454db5cefff77fc8174a\"]",
          "item_type": "string"
        },
        {
          "name": "ToolId",
          "type": "string",
          "required": false,
          "description": "沙箱工具ID，指定时查询该沙箱模板下的实例，为空则查询所有沙箱模板的实例",
          "example": "sdt-ee4ywozw"
        },
        {
          "name": "Offset",
          "type": "integer",
          "required": false,
          "description": "偏移量，默认为0",
          "example": "10"
        },
        {
          "name": "Limit",
          "type": "integer",
          "required": false,
          "description": "返回数量，默认为20，最大值为100",
          "example": "20"
        },
        {
          "name": "Filters",
          "type": "array",
          "required": false,
          "description": "过滤条件",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "Name",
              "type": "string",
              "required": false,
              "description": "属性名称, 若存在多个Filter时，Filter间的关系为逻辑与（AND）关系。",
              "example": "FILTER_KEY_NAME"
            },
            {
              "name": "Values",
              "type": "array",
              "required": false,
              "description": "属性值, 若同一个Filter存在多个Values，同一Filter下Values间的关系为逻辑或（OR）关系。",
              "example": "[\"LocalDev\"]",
              "item_type": "string"
            }
          ]
        }
      ],
      "required": []
    },
    {
      "name": "DescribeSandboxToolList",
      "description": "查询沙箱工具列表",
      "status": "online",
      "parameters": [
        {
          "name": "ToolIds",
          "type": "array",
          "required": false,
          "description": "沙箱工具ID列表，指定要查询的工具。如果为空则查询所有工具。最大支持100个ID",
          "example": "[\"sdt-dibk4rra\", \"sdt-lxoi5oiq\"]",
          "item_type": "string"
        },
        {
          "name": "Offset",
          "type": "integer",
          "required": false,
          "description": "偏移量，默认为0",
          "example": "0"
        },
        {
          "name": "Limit",
          "type": "integer",
          "required": false,
          "description": "返回数量，默认为20，最大值为100",
          "example": "20"
        },
        {
          "name": "Filters",
          "type": "array",
          "required": false,
          "description": "过滤条件",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "Name",
              "type": "string",
              "required": false,
              "description": "属性名称, 若存在多个Filter时，Filter间的关系为逻辑与（AND）关系。",
              "example": "FILTER_KEY_NAME"
            },
            {
              "name": "Values",
              "type": "array",
              "required": false,
              "description": "属性值, 若同一个Filter存在多个Values，同一Filter下Values间的关系为逻辑或（OR）关系。",
              "example": "[\"LocalDev\"]",
              "item_type": "string"
            }
          ]
        }
      ],
      "required": []
    },
    {
      "name": "PauseSandboxInstance",
      "description": "暂停沙箱实例",
      "status": "online",
      "parameters": [
        {
          "name": "InstanceId",
          "type": "string",
          "required": true,
          "description": "沙箱实例ID",
          "example": "4729e19d67fb4ba38854dbbfc63c72e9"
        }
      ],
      "required": [
        "InstanceId"
      ]
    },
    {
      "name": "ResumeSandboxInstance",
      "description": "恢复沙箱实例",
      "status": "online",
      "parameters": [
        {
          "name": "InstanceId",
          "type": "string",
          "required": true,
          "description": "沙箱实例ID",
          "example": "4729e19d67fb4ba38854dbbfc63c72e9"
        }
      ],
      "required": [
        "InstanceId"
      ]
    },
    {
      "name": "StartSandboxInstance",
      "description": "启动沙箱实例",
      "status": "online",
      "parameters": [
        {
          "name": "ToolId",
          "type": "string",
          "required": false,
          "description": "沙箱工具 ID，与 ToolName 至少有一个要填",
          "example": "sdt-ee4ywozw"
        },
        {
          "name": "ToolName",
          "type": "string",
          "required": false,
          "description": "沙箱工具名称，与 ToolId 至少有一个要填",
          "example": "my-browser-sandbox"
        },
        {
          "name": "Timeout",
          "type": "string",
          "required": false,
          "description": "超时时间，超过这个时间就自动回收实例。支持格式：5m、300s、1h 等，默认 5m。最小 30s，最大 24h",
          "example": "10m"
        },
        {
          "name": "ClientToken",
          "type": "string",
          "required": false,
          "description": "幂等性 Token，长度不超过 64 字符",
          "example": "instance-token-456"
        },
        {
          "name": "MountOptions",
          "type": "array",
          "required": false,
          "description": "沙箱实例存储挂载配置",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "Name",
              "type": "string",
              "required": false,
              "description": "指定沙箱工具中的存储配置名称",
              "example": "Storage1"
            },
            {
              "name": "MountPath",
              "type": "string",
              "required": false,
              "description": "沙箱实例本地挂载路径（可选），默认继承工具中的存储配置",
              "example": "/home/user"
            },
            {
              "name": "SubPath",
              "type": "string",
              "required": false,
              "description": "沙箱实例存储挂载子路径（可选）",
              "example": "workspace1"
            },
            {
              "name": "ReadOnly",
              "type": "boolean",
              "required": false,
              "description": "沙箱实例存储挂载读写权限（可选），默认继承工具存储配置",
              "example": "false"
            }
          ]
        },
        {
          "name": "CustomConfiguration",
          "type": "object",
          "required": false,
          "description": "沙箱实例自定义配置",
          "example": "无",
          "children": [
            {
              "name": "Image",
              "type": "string",
              "required": false,
              "description": "镜像地址",
              "example": "test.tencentcloudcr.com/example/nginx:latest"
            },
            {
              "name": "ImageRegistryType",
              "type": "string",
              "required": false,
              "description": "镜像仓库类型：`enterprise`、`personal`。",
              "example": "enterprise"
            },
            {
              "name": "Command",
              "type": "array",
              "required": false,
              "description": "启动命令",
              "example": "[\"/bin/bash\", \"-c\"]",
              "item_type": "string"
            },
            {
              "name": "Args",
              "type": "array",
              "required": false,
              "description": "启动参数",
              "example": "[\"-h\", \"0.0.0.0\", \"-p\", \"8000\"]",
              "item_type": "string"
            },
            {
              "name": "Env",
              "type": "array",
              "required": false,
              "description": "环境变量",
              "example": "无",
              "item_type": "object",
              "children": [
                {
                  "name": "Name",
                  "type": "string",
                  "required": false,
                  "description": "环境变量名",
                  "example": "TEST_ENV"
                },
                {
                  "name": "Value",
                  "type": "string",
                  "required": false,
                  "description": "环境变量值",
                  "example": "ABD"
                }
              ]
            },
            {
              "name": "Ports",
              "type": "array",
              "required": false,
              "description": "端口配置",
              "example": "无",
              "item_type": "object",
              "children": [
                {
                  "name": "Name",
                  "type": "string",
                  "required": false,
                  "description": "端口名",
                  "example": "http"
                },
                {
                  "name": "Port",
                  "type": "integer",
                  "required": false,
                  "description": "端口",
                  "example": "8000"
                },
                {
                  "name": "Protocol",
                  "type": "string",
                  "required": false,
                  "description": "协议",
                  "example": "TCP"
                }
              ]
            },
            {
              "name": "Resources",
              "type": "object",
              "required": false,
              "description": "资源配置",
              "example": "无",
              "children": [
                {
                  "name": "CPU",
                  "type": "string",
                  "required": false,
                  "description": "cpu 资源量",
                  "example": "500m"
                },
                {
                  "name": "Memory",
                  "type": "string",
                  "required": false,
                  "description": "内存资源量",
                  "example": "1Gi"
                }
              ]
            },
            {
              "name": "Probe",
              "type": "object",
              "required": false,
              "description": "探针配置",
              "example": "无",
              "children": [
                {
                  "name": "HttpGet",
                  "type": "object",
                  "required": false,
                  "description": "HTTP GET 探测配置",
                  "example": "无",
                  "children": [
                    {
                      "name": "Path",
                      "type": "string",
                      "required": false,
                      "description": "路径",
                      "example": "/health"
                    },
                    {
                      "name": "Port",
                      "type": "integer",
                      "required": false,
                      "description": "端口",
                      "example": "8000"
                    },
                    {
                      "name": "Scheme",
                      "type": "string",
                      "required": false,
                      "description": "协议",
                      "example": "HTTP"
                    }
                  ]
                },
                {
                  "name": "ReadyTimeoutMs",
                  "type": "integer",
                  "required": false,
                  "description": "健康检查就绪超时",
                  "example": "30000"
                },
                {
                  "name": "ProbeTimeoutMs",
                  "type": "integer",
                  "required": false,
                  "description": "健康检查单次探测超时",
                  "example": "1000"
                },
                {
                  "name": "ProbePeriodMs",
                  "type": "integer",
                  "required": false,
                  "description": "健康检查间隔",
                  "example": "1000"
                },
                {
                  "name": "SuccessThreshold",
                  "type": "integer",
                  "required": false,
                  "description": "健康检查成功阈值",
                  "example": "1"
                },
                {
                  "name": "FailureThreshold",
                  "type": "integer",
                  "required": false,
                  "description": "健康检查失败阈值",
                  "example": "3"
                }
              ]
            }
          ]
        }
      ],
      "required": []
    },
    {
      "name": "StopSandboxInstance",
      "description": "停止沙箱实例",
      "status": "online",
      "parameters": [
        {
          "name": "InstanceId",
          "type": "string",
          "required": true,
          "description": "沙箱实例ID",
          "example": "12345678123412341234123456789abc"
        }
      ],
      "required": [
        "InstanceId"
      ]
    },
    {
      "name": "UpdateSandboxInstance",
      "description": "更新沙箱实例",
      "status": "online",
      "parameters": [
        {
          "name": "InstanceId",
          "type": "string",
          "required": true,
          "description": "沙箱实例ID",
          "example": "953e15d3655e4daab120b885c908edf7"
        },
        {
          "name": "Timeout",
          "type": "string",
          "required": false,
          "description": "新的超时时间（从设置时开始重新计算超时），支持格式：5m、300s、1h等。最小30s，最大24h。如果不指定则保持原有超时设置",
          "example": "1h"
        }
      ],
      "required": [
        "InstanceId"
      ]
    },
    {
      "name": "UpdateSandboxTool",
      "description": "更新沙箱工具",
      "status": "online",
      "parameters": [
        {
          "name": "ToolId",
          "type": "string",
          "required": true,
          "description": "沙箱工具ID",
          "example": "sdt-dibk4rra"
        },
        {
          "name": "Description",
          "type": "string",
          "required": false,
          "description": "沙箱工具描述，最大长度200字符",
          "example": "这是一个沙箱"
        },
        {
          "name": "NetworkConfiguration",
          "type": "object",
          "required": false,
          "description": "网络配置",
          "example": "无",
          "children": [
            {
              "name": "NetworkMode",
              "type": "string",
              "required": true,
              "description": "网络模式（当前支持 PUBLIC, VPC, SANDBOX）",
              "example": "PUBLIC"
            },
            {
              "name": "VpcConfig",
              "type": "object",
              "required": false,
              "description": "VPC网络相关配置",
              "example": "无",
              "children": [
                {
                  "name": "SubnetIds",
                  "type": "array",
                  "required": false,
                  "description": "VPC子网ID列表",
                  "example": "[\"subnet-012abcde\", \"subnet-012edcba\"]",
                  "item_type": "string"
                },
                {
                  "name": "SecurityGroupIds",
                  "type": "array",
                  "required": false,
                  "description": "安全组ID列表",
                  "example": "[\"sg-abcde012\", \"sg-210edcba\"]",
                  "item_type": "string"
                }
              ]
            }
          ]
        },
        {
          "name": "Tags",
          "type": "array",
          "required": false,
          "description": "标签",
          "example": "无",
          "item_type": "object",
          "children": [
            {
              "name": "Key",
              "type": "string",
              "required": false,
              "description": "标签键",
              "example": "business"
            },
            {
              "name": "Value",
              "type": "string",
              "required": false,
              "description": "标签值",
              "example": "biz1"
            }
          ]
        },
        {
          "name": "CustomConfiguration",
          "type": "object",
          "required": false,
          "description": "沙箱工具自定义配置",
          "example": "无",
          "children": [
            {
              "name": "Image",
              "type": "string",
              "required": false,
              "description": "镜像地址",
              "example": "test.tencentcloudcr.com/example/nginx:latest"
            },
            {
              "name": "ImageRegistryType",
              "type": "string",
              "required": false,
              "description": "镜像仓库类型：`enterprise`、`personal`。",
              "example": "enterprise"
            },
            {
              "name": "Command",
              "type": "array",
              "required": false,
              "description": "启动命令",
              "example": "[\"/bin/bash\", \"-c\"]",
              "item_type": "string"
            },
            {
              "name": "Args",
              "type": "array",
              "required": false,
              "description": "启动参数",
              "example": "[\"-h\", \"0.0.0.0\", \"-p\", \"8000\"]",
              "item_type": "string"
            },
            {
              "name": "Env",
              "type": "array",
              "required": false,
              "description": "环境变量",
              "example": "无",
              "item_type": "object",
              "children": [
                {
                  "name": "Name",
                  "type": "string",
                  "required": false,
                  "description": "环境变量名",
                  "example": "TEST_ENV"
                },
                {
                  "name": "Value",
                  "type": "string",
                  "required": false,
                  "description": "环境变量值",
                  "example": "ABD"
                }
              ]
            },
            {
              "name": "Ports",
              "type": "array",
              "required": false,
              "description": "端口配置",
              "example": "无",
              "item_type": "object",
              "children": [
                {
                  "name": "Name",
                  "type": "string",
                  "required": false,
                  "description": "端口名",
                  "example": "http"
                },
                {
                  "name": "Port",
                  "type": "integer",
                  "required": false,
                  "description": "端口",
                  "example": "8000"
                },
                {
                  "name": "Protocol",
                  "type": "string",
                  "required": false,
                  "description": "协议",
                  "example": "TCP"
                }
              ]
            },
            {
              "name": "Resources",
              "type": "object",
              "required": false,
              "description": "资源配置",
              "example": "无",
              "children": [
                {
                  "name": "CPU",
                  "type": "string",
                  "required": false,
                  "description": "cpu 资源量",
                  "example": "500m"
                },
                {
                  "name": "Memory",
                  "type": "string",
                  "required": false,
                  "description": "内存资源量",
                  "example": "1Gi"
                }
              ]
            },
            {
              "name": "Probe",
              "type": "object",
              "required": false,
              "description": "探针配置",
              "example": "无",
              "children": [
                {
                  "name": "HttpGet",
                  "type": "object",
                  "required": false,
                  "description": "HTTP GET 探测配置",
                  "example": "无",
                  "children": [
                    {
                      "name": "Path",
                      "type": "string",
                      "required": false,
                      "description": "路径",
                      "example": "/health"
                    },
                    {
                      "name": "Port",
                      "type": "integer",
                      "required": false,
                      "description": "端口",
                      "example": "8000"
                    },
                    {
                      "name": "Scheme",
                      "type": "string",
                      "required": false,
                      "description": "协议",
                      "example": "HTTP"
                    }
                  ]
                },
                {
                  "name": "ReadyTimeoutMs",
                  "type": "integer",
                  "required": false,
                  "description": "健康检查就绪超时",
                  "example": "30000"
                },
                {
                  "name": "ProbeTimeoutMs",
                  "type": "integer",
                  "required": false,
                  "description": "健康检查单次探测超时",
                  "example": "1000"
                },
                {
                  "name": "ProbePeriodMs",
                  "type": "integer",
                  "required": false,
                  "description": "健康检查间隔",
                  "example": "1000"
                },
                {
                  "name": "SuccessThreshold",
                  "type": "integer",
                  "required": false,
                  "description": "健康检查成功阈值",
                  "example": "1"
                },
                {
                  "name": "FailureThreshold",
                  "type": "integer",
                  "required": false,
                  "description": "健康检查失败阈值",
                  "example": "3"
                }
              ]
            }
          ]
        }
      ],
      "required": [
        "ToolId"
      ]
    }
  ]
}