AlibabaCloud MCP Server
OfficialThe AlibabaCloud MCP Server enables seamless integration with Alibaba Cloud APIs, allowing AI assistants to manage cloud resources across various services through the Model Context Protocol:
ECS Management: Create, start, stop, reboot instances; run commands; reset passwords; replace system disks
RDS Management: Start, stop, reboot, and list RDS instances
OSS Management: List, create, delete buckets, and manage objects
CloudMonitor: Retrieve CPU, memory, and disk usage metrics for ECS instances
VPC & Switch Management: View VPCs and VSwitches
Security Groups: Describe and manage security groups
Resource Inventory: View details for available resources, regions, zones, account attributes, and images
Used for installing the uv package manager which is required to run the MCP server.
Supported platform for running the MCP server with installation via curl script.
Supported platform for running the MCP server with installation via curl script.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AlibabaCloud MCP Serverlist my running ECS instances in the Shanghai region"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Alibaba Cloud Ops MCP Server
Alibaba Cloud Ops MCP Server is a Model Context Protocol (MCP) server that provides seamless integration with Alibaba Cloud APIs, enabling AI assistants to operate resources on Alibaba Cloud, supporting ECS, Cloud Monitor, OOS, OSS, VPC, RDS and other widely used cloud products. It also enables AI assistants to analyze, build, and deploy applications to Alibaba Cloud ECS instances.
MCP Maketplace Integration
Related MCP server: Alibaba Cloud RDS OpenAPI MCP Server
Features
ECS Management: Create, start, stop, reboot, delete instances, run commands, view instances, regions, zones, images, security groups, and more
VPC Management: View VPCs and VSwitches
RDS Management: List, start, stop, and restart RDS instances
OSS Management: List, create, delete buckets, and view objects
Cloud Monitor: Get CPU usage, load average, memory usage, and disk usage metrics for ECS instances
Application Deployment: Deploy applications to ECS instances with automatic application and application group management
Project Analysis: Automatically identify project technology stack and deployment methods (npm, Python, Java, Go, Docker, etc.)
Local File Operations: List directories, run shell scripts, and analyze project structures
Dynamic API Tools: Support for Alibaba Cloud OpenAPI operations
Prepare
Install uv
# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | shConfiguration
Use VS Code + Cline to config MCP Server.
To use alibaba-cloud-ops-mcp-server MCP Server with any other MCP Client, you can manually add this configuration and restart for changes to take effect:
{
"mcpServers": {
"alibaba-cloud-ops-mcp-server": {
"timeout": 600,
"command": "uvx",
"args": [
"alibaba-cloud-ops-mcp-server@latest"
],
"env": {
"ALIBABA_CLOUD_ACCESS_KEY_ID": "Your Access Key ID",
"ALIBABA_CLOUD_ACCESS_KEY_SECRET": "Your Access Key SECRET"
}
}
}
}For detailed parameter description, see MCP startup parameter document
Know More
Alibaba Cloud Ops MCP Server is ready to use out of the box!!
Build your own Alibaba Cloud OpenAPI MCP Server with 10 lines of code
Tools
Product | Tool | Function | Implementation | Status |
ECS | RunCommand | Run Command | OOS | Done |
StartInstances | Start Instances | OOS | Done | |
StopInstances | Stop Instances | OOS | Done | |
RebootInstances | Reboot Instances | OOS | Done | |
DescribeInstances | View Instances | API | Done | |
DescribeRegions | View Regions | API | Done | |
DescribeZones | View Zones | API | Done | |
DescribeAvailableResource | View Resource Inventory | API | Done | |
DescribeImages | View Images | API | Done | |
DescribeSecurityGroups | View Security Groups | API | Done | |
RunInstances | Create Instances | OOS | Done | |
DeleteInstances | Delete Instances | API | Done | |
ResetPassword | Modify Password | OOS | Done | |
ReplaceSystemDisk | Replace Operating System | OOS | Done | |
VPC | DescribeVpcs | View VPCs | API | Done |
DescribeVSwitches | View VSwitches | API | Done | |
RDS | DescribeDBInstances | List RDS Instances | API | Done |
StartDBInstances | Start the RDS instance | OOS | Done | |
StopDBInstances | Stop the RDS instance | OOS | Done | |
RestartDBInstances | Restart the RDS instance | OOS | Done | |
OSS | ListBuckets | List Bucket | API | Done |
PutBucket | Create Bucket | API | Done | |
DeleteBucket | Delete Bucket | API | Done | |
ListObjects | View object information in the bucket | API | Done | |
CloudMonitor | GetCpuUsageData | Get CPU Usage Data for ECS Instances | API | Done |
GetCpuLoadavgData | Get CPU One-Minute Average Load Metric Data | API | Done | |
GetCpuloadavg5mData | Get CPU Five-Minute Average Load Metric Data | API | Done | |
GetCpuloadavg15mData | Get CPU Fifteen-Minute Average Load Metric Data | API | Done | |
GetMemUsedData | Get Memory Usage Metric Data | API | Done | |
GetMemUsageData | Get Memory Utilization Metric Data | API | Done | |
GetDiskUsageData | Get Disk Utilization Metric Data | API | Done | |
GetDiskTotalData | Get Total Disk Partition Capacity Metric Data | API | Done | |
GetDiskUsedData | Get Disk Partition Usage Metric Data | API | Done | |
Application Management | OOS_CodeDeploy | Deploy applications to ECS instances with automatic artifact upload to OSS | OOS | Done |
OOS_GetDeployStatus | Query deployment status of application groups | API | Done | |
OOS_GetLastDeploymentInfo | Retrieve information about the last deployment | API | Done | |
Local | LOCAL_ListDirectory | List files and subdirectories in a directory | Local | Done |
LOCAL_RunShellScript | Execute shell scripts or commands | Local | Done | |
LOCAL_AnalyzeDeployStack | Identify project deployment methods and technology stack | Local | Done |
Deployment Workflow
The typical deployment workflow includes:
Project Analysis: Use
LOCAL_AnalyzeDeployStackto identify the project's technology stack and deployment methodBuild Artifacts: Build or package the application locally (e.g., create tar.gz or zip files)
Deploy Application: Use
OOS_CodeDeployto deploy the application to ECS instancesAutomatically creates application and application group if they don't exist
Uploads artifacts to OSS
Deploys to specified ECS instances
Monitor Deployment: Use
OOS_GetDeployStatusto check deployment status
Contact us
If you have any questions, please join the Alibaba Cloud Ops MCP discussion group (DingTalk group: 113455011677) for discussion.
Available Tools
34 toolsDeleteBucketC
删除指定的OSS存储空间。
| Name | Required | Description | Default |
|---|---|---|---|
| BucketName | Yes | AlibabaCloud OSS Bucket Name | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the action is deletion, implying a destructive operation, but does not specify critical details such as whether deletion is permanent, requires specific permissions, has rate limits, or what happens if the bucket contains objects. This is a significant gap for a high-risk tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, direct sentence that efficiently conveys the core action without unnecessary words. It is front-loaded with the key information ('删除指定的OSS存储空间'), making it highly concise and well-structured for quick understanding.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (destructive deletion with 2 parameters) and the absence of both annotations and an output schema, the description is incomplete. It fails to address behavioral risks, usage prerequisites, or expected outcomes, which are essential for safe and effective tool invocation in this context.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with clear descriptions for both parameters (BucketName and RegionId). The description does not add any semantic details beyond the schema, such as format constraints or examples. Since the schema adequately documents the parameters, the baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('删除' meaning 'delete') and the resource ('OSS存储空间' meaning 'OSS storage space'), which is specific and unambiguous. However, it does not distinguish this tool from sibling tools like 'DeleteInstances' or 'ListBuckets', as it lacks context about what makes this deletion unique to OSS buckets versus other resources.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It does not mention prerequisites (e.g., bucket must be empty), exclusions (e.g., cannot delete if in use), or refer to related tools like 'ListBuckets' for verification. This leaves the agent without context for proper tool selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
DeleteInstancesB
本接口用于批量删除或者释放按量付费实例或者到期的包年包月实例,支持通过参数设置决定云盘是否释放或转换为按量付费保留。
| Name | Required | Description | Default |
|---|---|---|---|
| ClientToken | No | 保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。**ClientToken**只支持ASCII字符,且不能超过64个字符。更多信息,请参见[如何保证幂等性](~~25693~~)。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:123e4567-e89b-12d3-a456-426655440000 | |
| DryRun | No | 是否只预检此次请求。 - true:发送检查请求,不会查询资源状况。检查项包括AccessKey是否有效、RAM用户的授权情况和是否填写了必需参数。如果检查不通过,则返回对应错误。如果检查通过,会返回错误码DRYRUN.SUCCESS。 - false:发送正常请求,通过检查后返回2XX HTTP状态码并直接查询资源状况。 默认值:false。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
| Force | No | 是否强制释放**运行中**(`Running`)的ECS实例。 - true:强制释放**运行中**(`Running`)的实例。 - false:正常释放实例,此时实例必须处于**已停止**(`Stopped`)状态。 默认值:false。 ><warning>强制释放相当于断电,实例内存以及存储中的临时数据都会被擦除,无法恢复。></warning> 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
| ForceStop | No | 释放**运行中**(`Running`)的实例时的是否采取强制关机策略。仅当`Force=true`时生效。取值范围: - true:强制关机并释放实例。相当于典型的断电操作,实例会直接进入资源释放流程。 ><warning>强制释放相当于断电,实例内存以及存储中的临时数据都会被擦除,无法恢复。></warning> - false:在实例释放前,系统将优先执行标准关机流程,该模式会导致实例释放动作持续几分钟。用户在操作系统关机时,配置一些业务排水动作,从而减少业务系统的噪声。 默认值:true。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:true | |
| InstanceId | Yes | 实例ID数组。数组长度:1~100。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: array,参数示例:i-bp1g6zv0ce8oghu7**** | |
| RegionId | Yes | 实例所属的地域ID。您可以调用[DescribeRegions](~~25609~~)查看最新的阿里云地域列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou | |
| TerminateSubscription | No | 是否释放已到期的包年包月实例。 - true:释放。 - false:不释放。 默认值:false。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full burden. It discloses key behavioral traits: it's a destructive operation (deletes/releases instances), supports batch processing (1-100 instances), and mentions cloud disk handling options. However, it lacks details on permissions needed, rate limits, error handling, or confirmation prompts. The description adds value but isn't comprehensive for a high-risk mutation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, dense sentence that efficiently covers the tool's core functionality and key parameter capability. It's front-loaded with the main purpose and avoids redundancy. However, it could be more structured (e.g., separating usage notes) and slightly verbose in phrasing.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given high schema coverage (100%) but no annotations or output schema, the description is moderately complete. It identifies the tool as a destructive batch operation and hints at parameter-driven disk handling, but lacks critical context like required permissions, idempotency (though in schema), return values, or error scenarios. For a complex, high-stakes mutation tool, this is adequate but has clear gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so parameters are well-documented in the schema. The description adds minimal semantic context by mentioning '支持通过参数设置决定云盘是否释放或转换为按量付费保留' (supports parameter settings to decide whether cloud disks are released or converted to pay-as-you-go retention), which loosely relates to parameters like 'Force' or 'TerminateSubscription'. This provides slight value beyond the schema, warranting a baseline score.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: '批量删除或者释放按量付费实例或者到期的包年包月实例' (batch delete or release pay-as-you-go instances or expired subscription instances). It specifies the verb ('delete/release') and resource ('instances'), but doesn't explicitly differentiate from sibling tools like 'StopInstances' or 'RebootInstances' beyond the destructive nature implied by 'delete'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives is provided. The description mentions it handles specific instance types (pay-as-you-go, expired subscription) but doesn't clarify prerequisites (e.g., instance state), compare to tools like 'StopInstances' for temporary halts, or warn about irreversible deletion. Usage context is implied but not structured.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
DescribeAccountAttributesB
查询您在一个阿里云地域下能创建的ECS资源配额。包括您能创建的安全组数量、弹性网卡数量、按量付费vCPU核数、抢占式实例vCPU核数、按量付费云盘总容量配额、专用宿主机数量、网络类型以及账号是否已完成实名认证。
| Name | Required | Description | Default |
|---|---|---|---|
| AttributeName | No | 查询某类资源在指定地域下的使用配额,N的取值范围为1~8。取值范围: - instance-network-type:可选择的网络类型。 - max-security-groups:安全组数量。 - max-elastic-network-interfaces:弹性网卡的数量。 - max-postpaid-instance-vcpu-count:按量付费实例的vCPU核数上限。 - max-spot-instance-vcpu-count:抢占式实例vCPU核数上限。 - used-postpaid-instance-vcpu-count:已使用按量付费实例的vCPU核数。 - used-spot-instance-vcpu-count:已使用抢占式实例vCPU核数。 - max-postpaid-yundisk-capacity:用作数据盘的按量付费云盘的总容量上限。(该参数值已弃用) - used-postpaid-yundisk-capacity:已使用的用作数据盘的按量付费云盘容量。(该参数值已弃用) - max-dedicated-hosts:专用宿主机数量。 - supported-postpaid-instance-types:按量付费I/O优化实例规格。 - max-axt-command-count:云助手命令的数量。 - max-axt-invocation-daily:每天可以执行的云助手命令次数。 - real-name-authentication:账号是否完成了实名认证。 > 您只有完成了实名认证才可以在中国内地地域中创建ECS实例。 - max-cloud-assistant-activation-count:可创建的云助手托管实例激活码数量上限。 默认值为空。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: array,参数示例:max-security-groups | |
| RegionId | Yes | 地域ID。您可以调用[DescribeRegions](~~25609~~)查看最新的阿里云地域列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou | |
| ZoneId | No | 可用区ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou-b |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It states the query purpose but lacks behavioral details: it doesn't specify if this is a read-only operation (implied but not explicit), whether it requires authentication, rate limits, error conditions, or the format of returned data. For a quota query tool with zero annotation coverage, this is a significant gap in transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese that lists the quota types covered. It's front-loaded with the core purpose and avoids redundancy. However, it could be slightly more structured by separating the query action from the quota list for better readability.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (querying multiple quota types across regions), lack of annotations, and no output schema, the description is incomplete. It doesn't explain the return format, error handling, or authentication needs. While it covers the purpose well, it misses critical behavioral and output context needed for effective tool use.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all three parameters (AttributeName, RegionId, ZoneId) in detail. The description adds no parameter-specific information beyond implying a regional context. Baseline 3 is appropriate as the schema does the heavy lifting, but the description doesn't enhance parameter understanding (e.g., explaining AttributeName options beyond what's in the schema).
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the specific action ('查询' meaning 'query') and the exact resource ('ECS资源配额' meaning 'ECS resource quotas') in a specific context ('在一个阿里云地域下' meaning 'in an Alibaba Cloud region'). It distinguishes from siblings by focusing on account-level quotas rather than instance operations (e.g., RunInstances) or resource listings (e.g., DescribeInstances).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., needing RegionId), exclusions, or compare with similar tools like DescribeAvailableResource (which might show available resources rather than quotas). Usage is implied only through the query purpose.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
DescribeAvailableResourceB
查询可用区的资源库存状态。您可以在某一可用区创建实例(RunInstances)或者修改实例规格(ModifyInstanceSpec)时查询该可用区的资源库存状态。
| Name | Required | Description | Default |
|---|---|---|---|
| Cores | No | 实例规格的vCPU内核数目。取值参见[实例规格族](~~25378~~)。 当DestinationResource取值为InstanceType时,Cores才为有效参数。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:2 | |
| DataDiskCategory | No | 数据盘类型。取值范围: - cloud:普通云盘。 - cloud_efficiency:高效云盘。 - cloud_ssd:SSD云盘。 - ephemeral_ssd:本地SSD盘。 - cloud_essd:ESSD云盘。 - cloud_auto:ESSD AutoPL云盘。 <props="china"> - cloud_essd_entry:ESSD Entry云盘。 </props> 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cloud_ssd | |
| DedicatedHostId | No | 专有宿主机ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:dh-bp165p6xk2tlw61e**** | |
| DestinationResource | Yes | 要查询的资源类型。取值范围: - Zone:可用区。 - IoOptimized:I/O优化。 - InstanceType:实例规格。 - Network:网络类型。 - ddh:专有宿主机。 - SystemDisk:系统盘。 - DataDisk:数据盘。 >当DestinationResource取值为`SystemDisk`时,由于系统盘受实例规格限制,此时必须传入InstanceType。 参数DestinationResource的取值方式请参见本文中的**接口说明**。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:InstanceType | |
| InstanceChargeType | No | 资源的计费方式。更多信息,请参见[计费概述](~~25398~~)。取值范围: - PrePaid:包年包月。 - PostPaid:按量付费。 默认值:PostPaid。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:PrePaid | |
| InstanceType | No | 实例规格。更多信息,请参见[实例规格族](~~25378~~),您也可以调用[DescribeInstanceTypes](~~25620~~)接口获得最新的规格表。 参数InstanceType的取值方式请参见本文开头的**接口说明**。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:ecs.g5.large | |
| IoOptimized | No | 是否为I/O优化实例。取值范围: - none:非I/O优化实例。 - optimized:I/O优化实例。 默认值:optimized。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:optimized | |
| Memory | No | 实例规格的内存大小,单位为GiB。取值参见[实例规格族](~~25378~~)。 当DestinationResource取值为InstanceType时,Memory才为有效参数。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: number,参数示例:8.0 | |
| NetworkCategory | No | 网络类型。取值范围: - vpc:专有网络。 - classic:经典网络。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:vpc | |
| RegionId | Yes | 目标地域ID。您可以调用[DescribeRegions](~~25609~~)查看最新的阿里云地域列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou | |
| ResourceType | No | 资源类型。取值范围: - instance:ECS实例。 - disk:云盘。 - reservedinstance:预留实例券。 - ddh:专有宿主机。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:instance | |
| Scope | No | 预留实例券的范围。取值范围: - Region:地域级别。 - Zone:可用区级别。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:Region | |
| SpotDuration | No | 抢占式实例的保留时长,单位为小时。 默认值:1。取值范围: - 1:创建后阿里云会保证实例运行1小时不会被自动释放;超过1小时后,系统会自动比较出价与市场价格、检查资源库存,来决定实例的持有和回收。 - 0:创建后,阿里云不保证实例运行1小时,系统会自动比较出价与市场价格、检查资源库存,来决定实例的持有和回收。 实例回收前5分钟阿里云会通过ECS系统事件向您发送通知。抢占式实例按秒计费,建议您结合具体任务执行耗时来选择合适的保留时长。 > 当`InstanceChargeType`取值为`PostPaid`,并且`SpotStrategy`值为`SpotWithPriceLimit`或`SpotAsPriceGo`时该参数生效。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:1 | |
| SpotStrategy | No | 按量付费实例的竞价策略。取值范围: - NoSpot:正常按量付费实例。 - SpotWithPriceLimit:设置上限价格的抢占式实例。 - SpotAsPriceGo:系统自动出价,最高按量付费价格。 默认值:NoSpot。 当参数`InstanceChargeType`取值为`PostPaid`时,参数`SpotStrategy`才有效。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:NoSpot | |
| SystemDiskCategory | No | 系统盘类型。取值范围: - cloud:普通云盘。 - cloud_efficiency:高效云盘。 - cloud_ssd:SSD云盘。 - ephemeral_ssd:本地SSD盘。 - cloud_essd:ESSD云盘。 - cloud_auto:ESSD AutoPL云盘。 <props="china"> - cloud_essd_entry:ESSD Entry云盘。 </props> 默认值:cloud_efficiency。 > 参数ResourceType取值为instance、DestinationResource取值为DataDisk时,参数SystemDiskCategory是必选参数。如果未传递参数值,则以默认值生效。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cloud_ssd | |
| ZoneId | No | 可用区ID。 默认值:无。返回该地域(`RegionId`)下所有可用区符合查询条件的资源。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou-e |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. While it indicates this is a query/read operation (implied by '查询'), it doesn't address important behavioral aspects like: whether this requires specific permissions, rate limits, pagination behavior, error conditions, or what the response format looks like. For a complex 16-parameter tool with no annotation coverage, this is a significant gap in behavioral transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is appropriately concise - just two sentences that directly state the purpose and usage context. It's front-loaded with the core purpose and wastes no words. However, it could be slightly more structured by separating the purpose from usage guidance more clearly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (16 parameters, no annotations, no output schema), the description is insufficiently complete. It doesn't explain what 'resource inventory status' means in practical terms, what the output looks like, how to interpret results, or any limitations/constraints of the query. For a tool that presumably returns availability/capacity information critical for provisioning decisions, more context about the nature and format of results would be essential.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all 16 parameters thoroughly with descriptions, examples, and constraints. The description doesn't add any meaningful parameter semantics beyond what's in the schema - it doesn't explain parameter relationships, provide usage examples, or clarify complex dependencies. With complete schema coverage, the baseline score of 3 is appropriate as the description doesn't compensate but also doesn't need to given the comprehensive schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: '查询可用区的资源库存状态' (query resource inventory status in availability zones). It specifies the verb ('查询' - query) and resource ('资源库存状态' - resource inventory status), and mentions two specific use cases (creating instances or modifying instance specs). However, it doesn't explicitly differentiate from sibling tools like DescribeZones or DescribeRegions that might provide related but different information.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides good context about when to use this tool: '您可以在某一可用区创建实例(RunInstances)或者修改实例规格(ModifyInstanceSpec)时查询该可用区的资源库存状态' (You can query resource inventory status when creating instances or modifying instance specs in an availability zone). This gives clear situational guidance. However, it doesn't explicitly state when NOT to use it or mention alternative tools for similar purposes.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
DescribeDBInstancesC
该接口用于查询RDS的实例列表。
| Name | Required | Description | Default |
|---|---|---|---|
| Category | No | 实例的系列。取值: - **Basic**:基础系列 - **HighAvailability**:高可用系列 - **cluster**:集群系列 - **serverless_basic**:Serverless 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cluster | |
| ClientToken | No | 用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:ETnLKlblzczshOTUbOCz**** | |
| ConnectionMode | No | 实例的访问模式,取值: * **Standard**:标准访问模式 * **Safe**:数据库代理模式 默认返回所有访问模式下的实例。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:Standard | |
| ConnectionString | No | 实例的连接地址。通过该连接地址查询对应的实例。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:rm-uf6wjk5****.mysql.rds.aliyuncs.com | |
| DBInstanceClass | No | 实例规格,详见[实例规格表](~~26312~~)。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:rds.mys2.small | |
| DBInstanceId | No | 实例ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:rm-uf6wjk5**** | |
| DBInstanceStatus | No | 实例状态,详情请参见[实例状态表](~~26315~~)。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:Running | |
| DBInstanceType | No | 实例类型,取值: * **Primary**:主实例 * **Readonly**:只读实例 * **Guard**:灾备实例 * **Temp**:临时实例 默认返回所有实例类型。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:Primary | |
| DedicatedHostGroupId | No | 专属集群ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:dhg-7a9**** | |
| DedicatedHostId | No | 专属集群内的主机ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:i-bp**** | |
| Engine | No | 数据库类型,取值: * **MySQL** * **SQLServer** * **PostgreSQL** * **MariaDB** 默认返回所有数据库类型。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:MySQL | |
| EngineVersion | No | 数据库版本。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:8.0 | |
| Expired | No | 实例的过期状态,取值: * **True**:已过期 * **False**:未过期 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:True | |
| Filter | No | 实例过滤条件参数及其值的JSON串 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:{"babelfishEnabled":"true"} | |
| InstanceLevel | No | 是否返回实例系列(Category)信息,取值: * **0**:不返回 * **1**:返回 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:0 | |
| InstanceNetworkType | No | 实例的网络类型,取值: * **VPC**:专有网络下的实例 * **Classic**:经典网络下的实例 默认返回所有网络类型下的实例。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:Classic | |
| MaxResults | No | 每页记录数。取值:**1~100**。 默认值:**30**。 >传入该参数,则**PageSize**和**PageNumber**参数不可用。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:30 | |
| NextToken | No | 翻页凭证。取值为上一次调用**DescribeDBInstances**接口时返回的**NextToken**参数值。如果调用结果分多页展示,再次调用接口时传入该值便可以展示下一页的内容。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:o7PORW5o2TJg**** | |
| PageNumber | No | 页码,取值:大于0且不超过Integer的最大值。 默认值:**1**。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:1 | |
| PageSize | No | 每页记录数,取值:**1**~**100**。 默认值:**30**。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:30 | |
| PayType | No | 付费类型,取值: * **Postpaid**:按量付费 * **Prepaid**:包年包月 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:Postpaid | |
| RegionId | Yes | 地域ID。可调用DescribeRegions获取。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou | |
| ResourceGroupId | No | 资源组ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:rg-acfmy**** | |
| SearchKey | No | 可基于实例ID或者实例备注模糊搜索。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:rm-uf6w | |
| Tags | No | 查询绑定有该标签的实例,包括TagKey和TagValue。单次最多支持传入5组值,格式:{"key1":"value1","key2":"value2"...}。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:{"key1":"value1"} | |
| VSwitchId | No | 交换机ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:vsw-uf6adz52c2p**** | |
| VpcId | No | VPC ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:vpc-uf6f7l4fg90**** | |
| ZoneId | No | 可用区ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou-a | |
| proxyId | No | 废弃参数,无需配置。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:API |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool queries instance lists, implying a read-only operation, but doesn't confirm safety (e.g., no mutations), discuss rate limits, authentication needs, pagination behavior (implied by NextToken but not explained), or error handling. For a tool with 29 parameters and no annotations, this leaves significant behavioral gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese: '该接口用于查询RDS的实例列表.' It's front-loaded with the core purpose (querying RDS instances) and has zero redundant information. Every word earns its place, making it highly concise and well-structured for quick understanding.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (29 parameters, no output schema, no annotations), the description is incomplete. It doesn't explain the return format (e.g., list structure, fields), pagination (hinted by NextToken but not described), filtering logic, or error cases. For a query tool with many parameters and no structured output, the description should provide more context to guide the agent effectively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with detailed parameter descriptions in the input schema (e.g., Category with enum values, MaxResults with defaults). The tool description adds no parameter-specific information beyond the schema. According to guidelines, when coverage is high (>80%), the baseline is 3 even with no param info in the description, which applies here as the schema fully documents parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description '该接口用于查询RDS的实例列表' (This interface is used to query RDS instance lists) states the verb ('query') and resource ('RDS instance lists'), making the purpose clear. However, it's vague about scope (e.g., all instances vs. filtered) and doesn't distinguish from sibling tools like 'DescribeInstances' (which likely queries compute instances) or 'DescribeRegions' (which queries regions). It provides basic clarity but lacks specificity for sibling differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description offers no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., requiring RegionId), exclusions, or comparisons to sibling tools such as 'DescribeInstances' (for compute instances) or 'DescribeRegions' (for region data). Without any usage context, the agent must infer from tool names alone, which is insufficient for reliable selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
DescribeImagesC
指定ImageId、镜像被使用场景、Filter过滤等参数,查询您可以使用的镜像资源列表。
| Name | Required | Description | Default |
|---|---|---|---|
| ActionType | No | 镜像需要被使用到的场景。取值范围: - CreateEcs(默认):创建实例。 - ChangeOS:更换系统盘/更换操作系统。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:CreateEcs | |
| Architecture | No | 镜像的体系架构。取值范围: - i386。 - x86_64。 - arm64。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:i386 | |
| DryRun | No | 是否只预检此次请求。 - true:发送检查请求,不会查询资源状况。检查项包括AccessKey是否有效、RAM用户的授权情况和是否填写了必需参数。如果检查不通过,则返回对应错误。如果检查通过,会返回错误码DryRunOperation。 - false:发送正常请求,通过检查后返回2XX HTTP状态码并直接查询资源状况。 默认值:false。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
| Filter | No | 查询资源时的筛选条件列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: array,参数示例: | |
| ImageFamily | No | 镜像族系名称,查询镜像时可通过设置该参数来过滤当前族系对应的镜像。 默认值:空。 > 阿里云官方镜像关联的镜像族系信息请参见[公共镜像概述](~~108393~~)。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:hangzhou-daily-update | |
| ImageId | No | 镜像ID。 <details> <summary>镜像ID的命名规则</summary> - 公共镜像:以操作系统版本号、架构、语言和发布日期命名。例如,Windows Server 2008 R2企业版、64位英文系统的镜像ID为win2008r2_64_ent_sp1_en-us_40G_alibase_20190318.vhd。 - 自定义镜像、共享镜像、云市场镜像、社区镜像的镜像:以m开头。 </details> 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:m-bp1g7004ksh0oeuc**** | |
| ImageName | No | 镜像名称。支持模糊搜索。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:testImageName | |
| ImageOwnerAlias | No | 镜像来源。取值范围: - system:阿里云官方提供的,且不是通过云市场发布的镜像,和控制台中的“公共镜像”概念不同。 - self:您创建的自定义镜像。 - others:包含共享镜像(其他阿里云用户直接共享给您的镜像)和社区镜像(任意阿里云用户将其自定义镜像完全公开共享后的镜像)。您需要注意: - 查找社区镜像时,IsPublic必须为true。 - 查找共享镜像时,IsPublic需要设置为false或者不传值。 - marketplace:阿里云或者第三方供应商ISV在云市场发布的镜像,需要和ECS一起购买。请自行留意云市场镜像的收费详情。 默认值:空。 >空表示返回取值为system、self以及others的结果。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:self | |
| ImageOwnerId | No | 镜像所属的阿里云账号ID。该参数仅在查询共享镜像以及社区镜像时生效。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:20169351435666**** | |
| InstanceType | No | 为指定的实例规格查询可以使用的镜像。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:ecs.g5.large | |
| IsPublic | No | 是否查询已发布的社区镜像。取值范围: - true:查询已发布的社区镜像。当您指定该参数值为true时,ImageOwnerAlias必须为others。 - false:查询除社区镜像的其他镜像类型,具体以ImageOwnerAlias参数值为准。 默认值:false。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
| IsSupportCloudinit | No | 镜像是否支持cloud-init。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:true | |
| IsSupportIoOptimized | No | 镜像是否可以运行在I/O优化实例上。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:true | |
| OSType | No | 镜像的操作系统类型。取值范围: - windows。 - linux。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:linux | |
| PageNumber | No | 镜像资源列表的页码。 起始值:1。 默认值:1。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:1 | |
| PageSize | No | 分页查询时设置的每页行数。 最大值:100。 默认值:10。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:10 | |
| RegionId | Yes | 镜像所属的地域ID。您可以调用[DescribeRegions](~~25609~~)查看最新的阿里云地域列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou | |
| ResourceGroupId | No | 自定义镜像所在的企业资源组ID。使用该参数过滤资源时,资源数量不能超过1000个。 >不支持默认资源组过滤。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:rg-bp67acfmxazb4p**** | |
| ShowExpired | No | 订阅型镜像是否已经超过使用期限。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
| SnapshotId | No | 根据某一快照ID创建的自定义镜像。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:s-bp17ot2q7x72ggtw**** | |
| Status | No | 查询指定状态的镜像,如果不配置此参数,默认只返回Available状态的镜像。取值范围: - Creating:镜像正在创建中。 - Waiting:多任务排队中。 - Available(默认):您可以使用的镜像。 - UnAvailable:您不能使用的镜像。 - CreateFailed:创建失败的镜像。 - Deprecated:已弃用的镜像。 默认值:Available。当前参数支持同时取多个值,值之间以半角逗号(,)隔开。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:Available | |
| Tag | No | 标签列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: array,参数示例: | |
| Usage | No | 镜像是否已经运行在ECS实例中。取值范围: - instance:镜像处于运行状态,有ECS实例使用。 - none:镜像处于闲置状态,暂无ECS实例使用。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:instance |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It only states it's a query tool ('查询'), implying it's read-only, but doesn't clarify if it's safe, idempotent, or has side effects. It lacks details on rate limits, authentication needs, error handling, or response format. For a tool with 23 parameters and no annotations, this is insufficient.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that lists parameters but is somewhat cluttered. It front-loads the purpose but includes parameter names without clear structuring. It could be more streamlined by focusing on the core action and omitting the parameter list, as the schema covers them. However, it's not overly verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (23 parameters, no annotations, no output schema), the description is incomplete. It doesn't explain the tool's behavior, output format, or error conditions. While the schema covers parameters, the description fails to provide necessary context for safe and effective use, especially for a query tool with many filtering options.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all 23 parameters thoroughly. The description mentions parameters like ImageId, Filter, and '镜像被使用场景' (image usage scenario) but doesn't add meaningful context beyond what's in the schema. It lists parameters without explaining their interplay or typical combinations. Baseline 3 is appropriate since the schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: '查询您可以使用的镜像资源列表' (query the list of image resources you can use). It specifies the verb '查询' (query) and resource '镜像资源列表' (image resource list), making the action explicit. However, it doesn't differentiate from sibling tools like DescribeInstances or DescribeRegions, which are also query tools but for different resources.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It mentions parameters like ImageId and Filter but doesn't explain scenarios where this tool is preferred over other query tools or when it should be avoided. There's no mention of prerequisites, dependencies, or typical use cases.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
DescribeInstancesC
本接口支持根据不同请求条件查询实例列表,并关联查询实例的详细信息。
| Name | Required | Description | Default |
|---|---|---|---|
| AdditionalAttributes | No | 实例其他属性列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: array,参数示例:META_OPTIONS | |
| DeviceAvailable | No | >该参数正在邀测中,暂不支持使用。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
| DryRun | No | 是否只预检此次请求。取值范围: - true:发送检查请求,不会查询资源状况。检查项包括AccessKey是否有效、RAM用户的授权情况和是否填写了必需参数。如果检查不通过,则返回对应错误。如果检查通过,会返回错误码DryRunOperation。 - false:发送正常请求,通过检查后返回2XX HTTP状态码并直接查询资源状况。 默认值:false。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
| EipAddresses | No | 实例的弹性公网IP列表。当InstanceNetworkType=vpc时该参数生效,取值可以由多个IP组成一个JSON数组,最多支持100个IP,IP之间用半角逗号(,)隔开。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:["42.1.1.**", "42.1.2.**", … "42.1.10.**"] | |
| HpcClusterId | No | 实例所在的HPC集群ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:hpc-bp67acfmxazb4p**** | |
| HttpEndpoint | No | 是否启用实例元数据的访问通道。取值范围: - enabled:启用。 - disabled:禁用。 默认值:enabled。 >有关实例元数据的更多信息,请参见[实例元数据概述](~~49122~~)。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:enabled | |
| HttpPutResponseHopLimit | No | >该参数暂未开放使用。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:0 | |
| HttpTokens | No | 访问实例元数据时是否强制使用加固模式(IMDSv2)。取值范围: - optional:不强制使用。 - required:强制使用。设置该取值后,普通模式无法访问实例元数据。 默认值:optional。 >有关访问实例元数据模式的更多信息,请参见[实例元数据访问模式](~~150575~~)。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:optional | |
| ImageId | No | 镜像ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:m-bp67acfmxazb4p**** | |
| InnerIpAddresses | No | 经典网络类型实例的内网IP列表。当InstanceNetworkType=classic时生效,取值可以由多个IP组成一个JSON数组,最多支持100个IP,IP之间用半角逗号(,)隔开。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:["10.1.1.1", "10.1.2.1", … "10.1.10.1"] | |
| InstanceChargeType | No | 实例的计费方式。取值范围: - PostPaid:按量付费。 - PrePaid:包年包月。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:PostPaid | |
| InstanceIds | No | 实例ID。取值可以由多个实例ID组成一个JSON数组,最多支持100个ID,ID之间用半角逗号(,)隔开。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:["i-bp67acfmxazb4p****", "i-bp67acfmxazb4p****", … "i-bp67acfmxazb4p****"] | |
| InstanceName | No | 实例名称,支持使用通配符*进行模糊搜索。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:Test | |
| InstanceNetworkType | No | 实例网络类型。取值范围: - classic:经典网络。 - vpc:专有网络VPC。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:vpc | |
| InstanceType | No | 实例的规格。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:ecs.g5.large | |
| InstanceTypeFamily | No | 实例的规格族。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:ecs.g5 | |
| InternetChargeType | No | 公网带宽计费方式。取值范围: - PayByBandwidth:按固定带宽计费。 - PayByTraffic:按使用流量计费。 > **按使用流量计费**模式下的出入带宽峰值都是带宽上限,不作为业务承诺指标。当出现资源争抢时,带宽峰值可能会受到限制。如果您的业务需要有带宽的保障,请使用**按固定带宽计费**模式。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:PayByTraffic | |
| IoOptimized | No | 是否是I/O优化型实例。取值范围: - true:是。 - false:否。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:true | |
| Ipv6Address | No | 为弹性网卡指定的IPv6地址。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: array,参数示例: | |
| KeyPairName | No | 实例使用的SSH密钥对名称。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:KeyPairNameTest | |
| LockReason | No | 资源被锁定的原因。取值范围: - financial:因欠费被锁定。 - security:因安全原因被锁定。 - Recycling:抢占式实例的待释放锁定状态。 - dedicatedhostfinancial:因为专有宿主机欠费导致ECS实例被锁定。 - refunded:因退款被锁定。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:security | |
| MaxResults | No | 分页查询时每页行数。最大值为100。 默认值: - 当不设置值或设置的值小于10时,默认值为10。 - 当设置的值大于100时,默认值为100。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:10 | |
| NeedSaleCycle | No | >该参数正在邀测中,暂不支持使用。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
| NextToken | No | 查询凭证(Token),取值为上一次API调用返回的`NextToken`参数值。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:caeba0bbb2be03f84eb48b699f0a4883 | |
| PageNumber | No | > 该参数即将下线,推荐您使用NextToken与MaxResults完成分页查询操作。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:1 | |
| PageSize | No | > 该参数即将下线,推荐您使用NextToken与MaxResults完成分页查询操作。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:10 | |
| PrivateIpAddresses | No | VPC网络类型实例的私有IP。当InstanceNetworkType=vpc时生效,取值可以由多个IP组成一个JSON数组,最多支持100个IP,IP之间用半角逗号(,)隔开。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:["172.16.1.1", "172.16.2.1", … "172.16.10.1"] | |
| PublicIpAddresses | No | 实例的公网IP列表。取值可以由多个IP组成一个JSON数组,最多支持100个IP,IP之间用半角逗号(,)隔开。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:["42.1.1.**", "42.1.2.**", … "42.1.10.**"] | |
| RdmaIpAddresses | No | HPC实例的RDMA网络IP。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:10.10.10.102 | |
| RegionId | Yes | 实例所属的地域ID。您可以调用[DescribeRegions](~~25609~~)查看最新的阿里云地域列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou | |
| ResourceGroupId | No | 实例所在的企业资源组ID。使用该参数过滤资源时,资源数量不能超过1000个。 >不支持默认资源组过滤。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:rg-bp67acfmxazb4p**** | |
| SecurityGroupId | No | 实例所属的安全组。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:sg-bp67acfmxazb4p**** | |
| Status | No | 实例状态。取值范围: - Pending:创建中。 - Running:运行中。 - Starting:启动中。 - Stopping:停止中。 - Stopped:已停止。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:Running | |
| Tag | No | 标签列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: array,参数示例: | |
| VSwitchId | No | 交换机ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:vsw-bp67acfmxazb4p**** | |
| VpcId | No | 专有网络VPC ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:v-bp67acfmxazb4p**** | |
| ZoneId | No | 可用区ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou-g |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It implies a read-only query operation but lacks details on permissions, rate limits, pagination behavior (beyond parameters like MaxResults and NextToken), or error handling. This leaves significant gaps for an agent to understand operational constraints.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence in Chinese, which is concise but under-specified. It front-loads the core purpose but lacks structure and detail, making it efficient yet insufficient for clarity. It earns its place but could be more informative without verbosity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (37 parameters, no output schema, no annotations), the description is incomplete. It doesn't explain the return format, pagination strategy, or error scenarios, leaving the agent with inadequate context for effective use. The high parameter count and lack of behavioral info exacerbate this gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all 37 parameters thoroughly. The description adds no additional parameter semantics beyond implying filtering capabilities, resulting in a baseline score of 3 where the schema does the heavy lifting without extra value from the description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states the tool '查询实例列表' (queries instance lists) and '关联查询实例的详细信息' (associates with querying instance details), which clarifies it's a read operation for instances. However, it's vague about what 'instances' refer to (e.g., ECS instances) and doesn't differentiate from siblings like DescribeImages or DescribeDBInstances, leaving ambiguity in scope.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives is provided. The description mentions querying based on different request conditions but doesn't specify scenarios, prerequisites, or comparisons to siblings like DescribeAvailableResource or DescribeRegions, offering minimal contextual direction.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
DescribeRegionsC
根据计费方式、资源类型等参数查询地域信息列表。
| Name | Required | Description | Default |
|---|---|---|---|
| AcceptLanguage | No | 根据汉语、英语和日语筛选返回结果。更多详情,请参见[RFC 7231](https://tools.ietf.org/html/rfc7231)。取值范围: - zh-CN:简体中文。 - zh-TW:繁体中文。 - en-US:英文。 - ja:日文。 - fr:法语。 - de:德语。 - ko:韩语。 默认值:zh-CN。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:zh-CN | |
| InstanceChargeType | No | 实例的计费方式,更多信息,请参见[计费概述](~~25398~~)。取值范围: - PrePaid:包年包月。此时,请确认自己的账号支持余额支付或者信用支付,否则将报错InvalidPayMethod。 - PostPaid:按量付费。 - SpotWithPriceLimit:设置上限价格。 - SpotAsPriceGo:系统自动出价,最高按量付费价格。 默认值:PostPaid。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:PrePaid | |
| RegionId | No | 地域ID | |
| ResourceType | No | 资源类型。取值范围: - instance:ECS实例。 - disk:磁盘。 - reservedinstance:预留实例券。 - scu:存储容量单位包。 默认值:instance。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:instance |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full responsibility for behavioral disclosure. It only states the query function without mentioning whether this is a read-only operation, if it requires authentication, what the response format looks like, or any rate limits. For a query tool with zero annotation coverage, this leaves significant behavioral aspects undocumented.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that directly states the tool's function. It's appropriately sized for a query tool and front-loads the core purpose without unnecessary elaboration. Every word contributes to understanding what the tool does.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of annotations and output schema, the description is incomplete. It doesn't explain what the query returns (e.g., region names, IDs, availability statuses), how results are structured, or any behavioral constraints. For a tool that presumably returns important infrastructure metadata, this leaves too much unspecified for effective agent use.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, meaning all four parameters are thoroughly documented in the input schema with descriptions, examples, and allowed values. The description mentions '计费方式' (billing method) and '资源类型' (resource type) which correspond to InstanceChargeType and ResourceType parameters, but adds no additional semantic context beyond what the schema already provides. The baseline score of 3 is appropriate when the schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose as querying a list of region information based on billing methods and resource types. It uses specific verbs ('查询' - query) and resources ('地域信息列表' - region information list), making the intent unambiguous. However, it doesn't explicitly differentiate from sibling tools like DescribeZones or DescribeAvailableResource, which appear to serve similar informational purposes.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention sibling tools like DescribeZones (which might provide zone-level information) or DescribeAvailableResource (which might focus on resource availability rather than region metadata). There's no context about prerequisites, typical use cases, or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
DescribeSecurityGroupsC
本接口用于查询安全组基本信息列表,支持您通过地域、安全组ID、安全组类型等不同参数查询。
| Name | Required | Description | Default |
|---|---|---|---|
| DryRun | No | 是否只预检此次请求。取值范围: - true:发送检查请求,不会查询资源状况。检查项包括AccessKey是否有效、RAM用户的授权情况和是否填写了必需参数。如果检查不通过,则返回对应错误。如果检查通过,会返回错误码DryRunOperation。 - false:发送正常请求,通过检查后返回2XX HTTP状态码并直接查询资源状况。 默认值为false。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
| FuzzyQuery | No | >该参数已废弃。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:null | |
| IsQueryEcsCount | No | 是否查询安全组的容量信息。传True时,返回值中的`EcsCount`和`AvailableInstanceAmount`有效。 >该参数已废弃。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:null | |
| MaxResults | No | 分页查询时每页的最大条目数。一旦设置该参数,即表示使用`MaxResults`与`NextToken`组合参数的查询方式。 最大值为100。 默认值为10。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:10 | |
| NetworkType | No | 安全组的网络类型。取值范围: - vpc:专有网络。 - classic:经典网络。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:vpc | |
| NextToken | No | 查询凭证(Token)。取值为上一次调用该接口返回的NextToken参数值,初次调用接口时无需设置该参数。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:e71d8a535bd9cc11 | |
| PageNumber | No | > 该参数即将下线,推荐您使用NextToken与MaxResults完成分页查询操作。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:1 | |
| PageSize | No | > 该参数即将下线,推荐您使用NextToken与MaxResults完成分页查询操作。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:10 | |
| RegionId | Yes | 地域ID。您可以调用[DescribeRegions](~~25609~~)查看最新的阿里云地域列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou | |
| ResourceGroupId | No | 安全组所在的企业资源组ID。使用该参数过滤资源时,资源数量不能超过1000个。您可以调用[ListResourceGroups](~~158855~~)查询资源组列表。 >不支持默认资源组过滤。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:rg-bp67acfmxazb4p**** | |
| SecurityGroupId | No | 安全组ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:sg-bp67acfmxazb4p**** | |
| SecurityGroupIds | No | 安全组ID列表。一次最多支持100个安全组ID,ID之间用半角逗号(,)隔开,格式为JSON数组。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:["sg-bp67acfmxazb4p****", "sg-bp67acfmxazb4p****", "sg-bp67acfmxazb4p****",....] | |
| SecurityGroupName | No | 安全组名称。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:SGTestName | |
| SecurityGroupType | No | 安全组类型。取值范围: - normal:普通安全组。 - enterprise:企业安全组。 > 当不为该参数传值时,表示查询所有类型的安全组。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:normal | |
| ServiceManaged | No | 是否为托管安全组。取值范围: - true:是托管安全组。 - false:不是托管安全组。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
| Tag | No | 标签列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: array,参数示例: | |
| VpcId | No | 安全组所在的专有网络ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:vpc-bp67acfmxazb4p**** |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden but lacks behavioral details. It states it's a query tool, implying read-only behavior, but doesn't disclose pagination mechanics (implied by MaxResults/NextToken but not explained in description), rate limits, authentication needs, or error handling. The description is too minimal for a tool with 17 parameters and no output schema.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese that directly states the tool's purpose and key filtering capabilities. It's front-loaded with the main function and wastes no words, making it highly concise and well-structured for quick understanding.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (17 parameters, no output schema, no annotations), the description is inadequate. It doesn't explain the return format, pagination behavior, or common use cases. For a list/query tool with many parameters, more context is needed to guide effective usage, especially without annotations or output schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema fully documents all 17 parameters. The description adds minimal value by listing example filter parameters (region, security group ID, type) but doesn't provide additional context beyond what's in the schema. Baseline 3 is appropriate as the schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: '查询安全组基本信息列表' (query security group basic information list). It specifies the verb (query) and resource (security groups), and mentions filtering parameters like region, security group ID, and type. However, it doesn't explicitly differentiate from sibling tools like DescribeInstances or DescribeVpcs, which have similar query patterns for different resources.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It mentions filtering parameters but doesn't specify scenarios, prerequisites, or exclusions. For example, it doesn't clarify if this is for listing all security groups versus detailed inspection of a single group, or how it relates to other Describe* tools in the sibling list.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
DescribeVpcsC
查询已创建的VPC。
| Name | Required | Description | Default |
|---|---|---|---|
| DhcpOptionsSetId | No | DHCP选项集的ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:dopt-o6w0df4epg9zo8isy**** | |
| DryRun | No | 是否只预检此次请求,取值: - **true**:发送检查请求,不会查询资源状况。检查项包括AccessKey是否有效、RAM用户的授权情况和是否填写了必需参数。如果检查不通过,则返回对应错误。如果检查通过,会返回错误码`DryRunOperation`。 - **false**(默认值):发送正常请求,通过检查后返回HTTP 2xx状态码并直接查询资源状况。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
| EnableIpv6 | No | 是否查询指定地域下开启IPv6网段的VPC,默认为空值(空值则不根据是否开启IPv6网段做过滤),取值: - **false**:不开启。 - **true**:开启。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
| IsDefault | No | 是否查询指定地域下的默认VPC,取值: - **true**(默认值):查询指定地域下的默认VPC。 - **false**:不查询默认VPC。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
| PageNumber | No | 列表的页码,默认值为**1**。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:1 | |
| PageSize | No | 分页查询时每页的行数,最大值为**50**,默认值为**10**。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:10 | |
| RegionId | Yes | VPC所在的地域ID。 您可以通过调用[DescribeRegions](~~448570~~)接口获取地域ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou | |
| ResourceGroupId | No | 要查询的VPC所属的资源组ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:rg-acfmxvfvazb4p**** | |
| Tag | No | 资源的标签。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: array,参数示例: | |
| VpcId | No | VPC的ID。 最多支持指定20个VPC ID,多个VPC的ID之间用半角逗号(,)隔开。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:vpc-bp1b1xjllp3ve5yze**** | |
| VpcName | No | VPC的名称。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:Vpc-1 | |
| VpcOwnerId | No | VPC所属的阿里云账号ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:253460731706911258 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. '查询' (query) implies a read-only operation, but the description doesn't explicitly state this, nor does it mention pagination behavior, rate limits, authentication requirements, or what happens when no VPCs match filters. For a tool with 12 parameters and no annotation coverage, this is a significant gap in behavioral context.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise - a single Chinese phrase. While this is efficient and front-loaded, it may be too brief given the tool's complexity with 12 parameters. Every word earns its place, but the description could benefit from slightly more context without becoming verbose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (12 parameters, no output schema, no annotations), the description is inadequate. It doesn't explain what the tool returns, how results are structured, pagination behavior, or error conditions. For a query tool with extensive filtering options, the single-phrase description leaves too much unspecified for effective agent use.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all 12 parameters thoroughly. The description adds no parameter-specific information beyond the generic '查询已创建的VPC' statement. According to guidelines, when schema coverage is high (>80%), the baseline is 3 even with no parameter info in the description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description '查询已创建的VPC' (Query created VPCs) clearly states the verb (query) and resource (VPCs), but it's vague about scope and filtering capabilities. It doesn't differentiate from sibling tools like DescribeInstances or DescribeSecurityGroups beyond mentioning VPCs specifically. The purpose is understandable but lacks specificity about what kind of query this performs.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. There's no mention of prerequisites, typical use cases, or comparison to sibling tools like DescribeVSwitches or DescribeRegions. The agent must infer usage solely from the tool name and parameters.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
DescribeVSwitchesC
查询可组网的信息,内网按vswitch进行组网。
| Name | Required | Description | Default |
|---|---|---|---|
| DryRun | No | 是否只预检此次请求。取值: - **true**:发送检查请求,不会创建资源(接口功能)。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过,则返回对应错误。如果检查通过,则返回错误码`DryRunOperation`。 - **false**(默认值):发送正常请求,通过检查后返回HTTP 2xx状态码并直接进行操作。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:true | |
| EnableIpv6 | No | 是否查询指定地域下开启IPv6网段的交换机,取值: - **true**:查询指定地域下开启IPv6网段的交换机。 - **false**:不查询指定地域下开启IPv6网段的交换机。 如果不传入该参数,系统默认查询指定地域下的所有交换机。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
| IsDefault | No | 是否查询指定地域下的默认交换机,取值: - **true**:查询指定地域下的默认交换机。 - **false**:不查询指定地域下的默认交换机。 如果不传入该参数,系统默认查询指定地域下的所有交换机。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:true | |
| PageNumber | No | 列表的页码,默认值为**1**。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:1 | |
| PageSize | No | 分页查询时每页的行数,最大值为**50**。默认值为**10**。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:10 | |
| RegionId | No | 交换机所属地域的ID。您可以通过调用[DescribeRegions](~~36063~~)接口获取地域ID。 > **RegionId**和**VpcId**参数至少输入一个。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou | |
| ResourceGroupId | No | 交换机所属的资源组ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:rg-bp67acfmxazb4ph**** | |
| RouteTableId | No | 路由表的ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:vtb-bp145q7glnuzdvzu2**** | |
| Tag | No | 资源的标签。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: array,参数示例: | |
| VSwitchId | No | 要查询的交换机的ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:vsw-23dscddcffvf3**** | |
| VSwitchName | No | 交换机的名称。 名称长度为1~128个字符,不能以`http://`或`https://`开头。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:vSwitch | |
| VSwitchOwnerId | No | 资源归属的阿里云账号ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:2546073170691**** | |
| VpcId | No | 要查询的交换机所属VPC的ID。 > **RegionId**和**VpcId**参数至少输入一个。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:vpc-25cdvfeq58pl**** | |
| ZoneId | No | 交换机所属可用区的ID。您可以通过调用[DescribeZones](~~36064~~)接口获取可用区ID。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou-d |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. It only states this is a query operation ('查询'), implying read-only behavior, but doesn't mention pagination (though parameters suggest it), rate limits, authentication requirements, error conditions, or what the response contains. For a 14-parameter query tool with no annotations, this minimal description leaves critical behavioral aspects undocumented.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise (one Chinese sentence) but this brevity comes at the cost of being under-specified rather than efficiently informative. While it's front-loaded with the core action, it lacks the necessary detail for a tool with 14 parameters and complex filtering options. The single sentence doesn't earn its place by providing adequate guidance.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (14 parameters, no output schema, no annotations), the description is severely incomplete. It doesn't explain what information is returned about vswitches, how results are structured, whether this is a list or detailed view, or how to interpret the output. The description fails to compensate for the lack of output schema and annotations, leaving the agent with insufficient context to use the tool effectively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema fully documents all 14 parameters with detailed descriptions, defaults, and examples. The description adds no parameter information beyond what's in the schema - it doesn't explain parameter relationships, common usage patterns, or which parameters are most important. With complete schema coverage, the baseline of 3 is appropriate as the description doesn't enhance parameter understanding.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description '查询可组网的信息,内网按vswitch进行组网' translates to 'Query information for networking, internal network networking by vswitch.' This is vague and tautological - it essentially restates the tool name 'DescribeVSwitches' (describe virtual switches) without specifying what information is returned or how it's used. It mentions 'networking' but doesn't clarify if this lists vswitches, describes their properties, or provides configuration details.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. With sibling tools like DescribeVpcs, DescribeSecurityGroups, and DescribeInstances available, there's no indication of when this specific vswitch query tool is appropriate versus other networking or infrastructure description tools. No prerequisites, exclusions, or comparison context is provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
DescribeZonesC
根据地域ID、计费方式等参数查询可用区信息列表。
| Name | Required | Description | Default |
|---|---|---|---|
| AcceptLanguage | No | 根据汉语、英语和日语筛选返回结果。更多信息,请参见[RFC 7231](https://tools.ietf.org/html/rfc7231)。取值范围: - zh-CN:简体中文。 - zh-TW:繁体中文。 - en-US:英文。 - ja:日文。 - fr:法语。 - de:德语。 - ko:韩语。 默认值:zh-CN。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:zh-CN | |
| InstanceChargeType | No | 可用区里支持的资源计费方式。更多信息,请参见[计费概述](~~25398~~)。取值范围: - PrePaid:包年包月。 - PostPaid:按量付费。 默认值:PostPaid。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:PostPaid | |
| RegionId | Yes | 可用区所在的地域ID。您可以调用[DescribeRegions](~~25609~~)查看最新的阿里云地域列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou | |
| SpotStrategy | No | 按量付费实例的竞价策略。当`InstanceChargeType=PostPaid`时,您可以传入该参数。更多信息,请参见[抢占式实例](~~52088~~)。取值范围: - NoSpot:正常按量付费实例。 - SpotWithPriceLimit:设置上限价格的抢占式实例。 - SpotAsPriceGo:系统自动出价,最高按量付费价格。 默认值:NoSpot。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:NoSpot | |
| Verbose | No | 是否展示详细信息。 - true:展示。 - false:不展示。 默认值:true。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool queries information, implying it's a read-only operation, but doesn't confirm this or describe other traits like rate limits, authentication needs, error conditions, or pagination. For a tool with 5 parameters and no annotations, this minimal description leaves critical behavioral aspects unspecified.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese that directly states the tool's purpose and key parameters. It's front-loaded with no wasted words, making it easy to parse quickly. Every part of the sentence contributes to understanding the tool's function.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (5 parameters, no output schema, no annotations), the description is insufficiently complete. It lacks information on the return format (e.g., what fields are included in the list), error handling, or typical use cases. For a query tool with multiple parameters and no structured output documentation, users need more context to use it effectively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description coverage is 100%, so the schema already documents all 5 parameters thoroughly with descriptions, examples, and defaults. The description adds minimal value by listing '地域ID、计费方式等参数' (region ID, billing method, and other parameters), which loosely maps to RegionId and InstanceChargeType, but doesn't provide additional context or meaning beyond what's in the schema. This meets the baseline for high schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: '查询可用区信息列表' (query availability zone information list) with filtering by '地域ID、计费方式等参数' (region ID, billing method, and other parameters). It specifies both the action (query/list) and resource (availability zones), but doesn't explicitly differentiate from sibling tools like DescribeRegions or DescribeAvailableResource, which appear related.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. The description mentions parameters but doesn't explain the context or prerequisites for use, such as whether it's for resource provisioning or general information lookup. With many sibling tools in the server (e.g., DescribeRegions, DescribeAvailableResource), the lack of comparative guidance is a significant gap.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
GetCpuloadavg15mDataC
获取CPU十五分钟平均负载指标数据
| Name | Required | Description | Default |
|---|---|---|---|
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. While '获取' (get) implies a read operation, the description doesn't mention authentication requirements, rate limits, error conditions, or what format the data returns. For a cloud monitoring tool with no annotation coverage, this leaves significant behavioral questions unanswered.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient Chinese sentence that directly states the tool's purpose without unnecessary words. It's appropriately sized for what it communicates, though it could be more helpful with additional context.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a cloud monitoring tool with no annotations and no output schema, the description is insufficiently complete. It doesn't explain what the returned data looks like, what units are used, whether it's real-time or historical data, or how to interpret the results. The agent would need to guess about the tool's behavior and output format.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 100% schema description coverage, the input schema already documents both parameters well. The description adds no additional parameter information beyond what's in the schema. The baseline score of 3 reflects adequate parameter documentation through the schema alone, though the description contributes nothing extra.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('获取' - get/retrieve) and resource ('CPU十五分钟平均负载指标数据' - CPU 15-minute average load metric data), making the purpose understandable. However, it doesn't differentiate from its siblings like GetCpuloadavg5mData or GetCpuLoadavgData, which appear to be similar CPU load monitoring tools with different timeframes.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. With siblings like GetCpuloadavg5mData, GetCpuLoadavgData, and GetCpuUsageData, there's no indication of what distinguishes this 15-minute average tool from other CPU monitoring tools, leaving the agent to guess based on naming alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
GetCpuloadavg5mDataC
获取CPU五分钟平均负载指标数据
| Name | Required | Description | Default |
|---|---|---|---|
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states this is a 'get' operation, implying read-only behavior, but doesn't specify authentication needs, rate limits, response format, or whether it returns real-time or historical data. For a monitoring tool with zero annotation coverage, this leaves significant gaps in understanding its behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese that directly states the tool's function. It's front-loaded with the core purpose and contains no unnecessary words. However, it could be slightly more structured by explicitly mentioning the data source (AlibabaCloud ECS).
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of a monitoring tool with no annotations and no output schema, the description is incomplete. It doesn't explain what the returned data looks like (e.g., numeric values, timestamps), how to interpret the load average, or error conditions. For a tool that fetches metric data, more context on the output is needed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with both parameters (InstanceIds and RegionId) well-documented in the schema. The description adds no additional parameter information beyond what the schema provides, such as format examples or constraints. With high schema coverage, the baseline score of 3 is appropriate as the schema handles parameter documentation adequately.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description '获取CPU五分钟平均负载指标数据' (Get CPU five-minute average load metric data) states a clear verb ('获取' - get) and resource (CPU load data), but it doesn't distinguish this tool from its siblings like GetCpuloadavg15mData or GetCpuLoadavgData. The purpose is understandable but lacks sibling differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention when to choose this over GetCpuloadavg15mData (15-minute average) or GetCpuLoadavgData (general load data), nor does it specify prerequisites or exclusions. Usage context is implied but not explicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
GetCpuLoadavgDataC
获取CPU一分钟平均负载指标数据
| Name | Required | Description | Default |
|---|---|---|---|
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states it 'gets' data, implying a read-only operation, but doesn't mention any behavioral traits such as authentication requirements, rate limits, error conditions, or what the returned data looks like (e.g., format, units). This leaves significant gaps for a tool interacting with a cloud service.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese that directly states the tool's purpose without any unnecessary words or fluff. It is appropriately sized and front-loaded, making it easy to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of interacting with AlibabaCloud ECS instances and the lack of annotations and output schema, the description is incomplete. It doesn't cover behavioral aspects like authentication, error handling, or data format, and there's no output schema to clarify return values. This makes it inadequate for safe and effective tool invocation in a cloud environment.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description coverage is 100%, with clear descriptions for both parameters (InstanceIds and RegionId). The description adds no additional parameter semantics beyond what the schema provides, such as explaining the format of InstanceIds or implications of RegionId. Given the high schema coverage, the baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('获取' meaning 'get') and resource ('CPU一分钟平均负载指标数据' meaning 'CPU one-minute average load metric data'), providing a specific verb+resource combination. However, it doesn't explicitly differentiate from its siblings GetCpuloadavg15mData and GetCpuloadavg5mData, which appear to be similar tools for different time intervals.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. There are no explicit instructions about when/when-not to use it, nor does it mention sibling tools like GetCpuloadavg15mData or GetCpuloadavg5mData for different time intervals, leaving the agent to infer usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
GetCpuUsageDataC
获取ECS实例的CPU使用率数据
| Name | Required | Description | Default |
|---|---|---|---|
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states '获取' (get), implying a read-only operation, but doesn't clarify aspects like authentication requirements, rate limits, data freshness, or response format. For a tool with no annotations, this leaves significant behavioral gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese that directly states the tool's purpose without unnecessary words. It is appropriately sized and front-loaded, making it easy to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no annotations, no output schema, and a read operation with potential complexity (e.g., data aggregation, time ranges), the description is incomplete. It lacks details on return values, error handling, or operational context, making it inadequate for full agent understanding without external inference.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with clear descriptions for both parameters (InstanceIds and RegionId). The description adds no additional parameter semantics beyond what the schema provides, such as format details or constraints. With high schema coverage, the baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb ('获取' meaning 'get') and resource ('ECS实例的CPU使用率数据' meaning 'ECS instance CPU usage data'), making the purpose specific and understandable. However, it doesn't explicitly differentiate from sibling tools like GetCpuloadavgData or GetMemUsageData, which target different metrics, leaving some ambiguity about when to choose this specific CPU metric tool.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention sibling tools like GetCpuloadavgData (for load averages) or GetMemUsageData (for memory), nor does it specify prerequisites, contexts, or exclusions for usage, leaving the agent to infer based on tool names alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
GetDiskTotalDataC
获取磁盘分区总容量指标数据
| Name | Required | Description | Default |
|---|---|---|---|
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It only states what data is retrieved ('get disk partition total capacity metric data') without mentioning any behavioral traits such as whether this is a read-only operation, potential rate limits, authentication needs, or what the output format might be. This leaves significant gaps for an AI agent to understand how to invoke it effectively.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese that directly states the purpose without unnecessary words. It's appropriately sized for a simple data retrieval tool, though it could be more front-loaded with additional context if needed.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of a data retrieval tool with no annotations and no output schema, the description is incomplete. It doesn't explain what the returned data looks like (e.g., format, units), how it's structured, or any limitations (e.g., time ranges, aggregation). This makes it inadequate for an AI agent to fully understand the tool's behavior and output.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description adds no meaning beyond what the input schema provides. With 100% schema description coverage, the schema already documents both parameters (InstanceIds and RegionId) clearly. The description doesn't explain how these parameters relate to retrieving disk total capacity data, so it meets the baseline of 3 where the schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description '获取磁盘分区总容量指标数据' (Get disk partition total capacity metric data) states the verb ('get') and resource ('disk partition total capacity metric data'), but it's somewhat vague about what exactly is being retrieved. It doesn't clearly distinguish from sibling tools like GetDiskUsageData or GetDiskUsedData, which also deal with disk metrics but for different aspects (usage vs. used vs. total capacity).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. With sibling tools like GetDiskUsageData and GetDiskUsedData, there's no indication of when total capacity data is needed compared to usage or used data, nor any prerequisites or exclusions mentioned in the description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
GetDiskUsageDataC
获取磁盘利用率指标数据
| Name | Required | Description | Default |
|---|---|---|---|
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It only states what data is retrieved ('disk utilization metric data') without disclosing behavioral traits like whether this is a real-time or historical query, if it requires specific permissions, rate limits, or what the output format looks like (e.g., JSON structure, units). This is inadequate for a tool with no annotation coverage.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese that directly states the tool's purpose without unnecessary words. It's appropriately sized and front-loaded, making it easy to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (retrieving metrics from a cloud service), lack of annotations, and no output schema, the description is incomplete. It doesn't explain what 'disk utilization metric data' includes (e.g., percentages, timestamps, aggregation), how results are returned, or any prerequisites, leaving significant gaps for an AI agent to use the tool effectively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with clear descriptions for InstanceIds ('AlibabaCloud ECS instance ID List') and RegionId ('AlibabaCloud region ID'). The description adds no parameter semantics beyond the schema, but the baseline is 3 since the schema adequately documents the parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description '获取磁盘利用率指标数据' (Get disk utilization metric data) states a clear verb ('get') and resource ('disk utilization metric data'), but it's vague about what specific metrics are retrieved. It doesn't distinguish from siblings like GetDiskTotalData or GetDiskUsedData, leaving ambiguity about what 'utilization' encompasses (e.g., percentage, raw values, or both).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives. With siblings like GetDiskTotalData and GetDiskUsedData, the description doesn't clarify if this tool combines both metrics or serves a different purpose, leaving the agent to guess based on tool names alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
GetDiskUsedDataC
获取磁盘分区使用量指标数据
| Name | Required | Description | Default |
|---|---|---|---|
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states it 'gets' data, implying a read-only operation, but doesn't clarify aspects like whether it requires specific permissions, rate limits, data freshness, or error handling. For a tool with no annotations, this leaves significant gaps in understanding its behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese that directly states the purpose without unnecessary words. It's appropriately sized for a simple data retrieval tool, though it could be slightly more informative without losing conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's moderate complexity (retrieving metric data with two parameters), no annotations, and no output schema, the description is minimally adequate. It covers the basic purpose but lacks details on behavior, output format, or usage context, which are important for an agent to operate effectively in this server environment with many sibling tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description adds no parameter-specific information beyond what's in the input schema, which has 100% description coverage. It doesn't explain the relationship between InstanceIds and RegionId or provide usage examples. With high schema coverage, the baseline is 3, as the schema adequately documents parameters without extra help from the description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description '获取磁盘分区使用量指标数据' (Get disk partition usage metric data) clearly states the verb (get) and resource (disk partition usage metrics). It distinguishes from siblings like GetDiskTotalData (total disk data) and GetDiskUsageData (usage data without specifying partition focus), though the distinction could be more explicit.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives like GetDiskUsageData or GetDiskTotalData. It lacks context about prerequisites, such as needing AlibabaCloud ECS instances, or exclusions, leaving the agent to infer usage from the input schema alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
GetMemUsageDataC
获取内存利用率指标数据
| Name | Required | Description | Default |
|---|---|---|---|
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden but only states what the tool does ('获取' - get) without behavioral details. It doesn't disclose whether this is a read-only operation, requires specific permissions, has rate limits, returns time-series vs snapshot data, or what format/units the data comes in. For a metric tool with zero annotation coverage, this is insufficient.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese that directly states the tool's function without fluff. However, it could be more front-loaded with critical context (e.g., specifying it's for AlibabaCloud ECS instances, which is only in the schema).
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a metric-fetching tool with no annotations and no output schema, the description is incomplete. It doesn't explain what 'memory utilization metric data' entails (e.g., percentages, time ranges, aggregation), return format, or error conditions. Given the complexity of cloud monitoring data and lack of structured output, more context is needed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with both parameters (InstanceIds, RegionId) well-documented in the schema. The description adds no parameter-specific information beyond implying memory metrics are fetched, which the schema already covers through parameter names and descriptions. Baseline 3 is appropriate when schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description '获取内存利用率指标数据' (Get memory utilization metric data) states a clear verb ('获取' - get) and resource ('内存利用率指标数据' - memory utilization metric data), but it's vague about scope and doesn't differentiate from siblings like GetMemUsedData. It doesn't specify whether this is historical, real-time, aggregated, or per-instance data.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives like GetMemUsedData or other metric tools (GetCpuUsageData, GetDiskUsageData). The description doesn't mention prerequisites, timing considerations, or comparison with sibling tools, leaving the agent to infer usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
GetMemUsedDataC
获取内存使用量指标数据
| Name | Required | Description | Default |
|---|---|---|---|
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It states the action ('get') but doesn't describe what the tool returns (e.g., format, units, time range), whether it's a read-only operation, potential rate limits, or authentication needs. This leaves significant gaps in understanding how the tool behaves beyond its basic purpose.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese that directly states the tool's purpose without any unnecessary words or fluff. It is front-loaded and appropriately sized for a simple data retrieval tool, making it easy to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (data retrieval with parameters), lack of annotations, and no output schema, the description is incomplete. It doesn't explain the return values (e.g., what 'memory usage metric data' includes), potential errors, or behavioral traits like whether it's safe or has side effects. This leaves the agent with insufficient context to use the tool effectively beyond basic parameter input.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description coverage is 100%, with clear descriptions for both parameters (InstanceIds and RegionId). The description adds no additional parameter semantics beyond what the schema provides, such as explaining what 'memory usage metric data' entails or how parameters affect the output. This meets the baseline score since the schema adequately documents the parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb ('获取' meaning 'get') and resource ('内存使用量指标数据' meaning 'memory usage metric data'), making the purpose understandable. However, it doesn't explicitly distinguish this tool from its sibling 'GetMemUsageData', which appears to be a related memory metric tool, leaving some ambiguity about their differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives like 'GetMemUsageData' or other memory-related tools. It lacks context about prerequisites, such as needing instance IDs or region specifications, and offers no exclusions or recommendations for when not to use it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ListBucketsB
列出指定区域的所有OSS存储空间。
| Name | Required | Description | Default |
|---|---|---|---|
| Prefix | No | AlibabaCloud OSS Bucket Name prefix | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It mentions listing buckets in a specified region but doesn't disclose behavioral traits like pagination, rate limits, authentication requirements, error conditions, or what 'all' means (e.g., whether it includes hidden or system buckets). For a read operation with no annotation coverage, this is a significant gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese that directly states the tool's purpose without unnecessary words. It is appropriately sized and front-loaded with the core action.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's moderate complexity (listing resources with filtering), no annotations, and no output schema, the description is minimally adequate. It covers the basic purpose but lacks details on behavior, output format, or usage context. It meets the minimum viable threshold but has clear gaps in completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents both parameters (Prefix and RegionId) with descriptions. The description adds no additional meaning beyond implying regional filtering, which is already covered by the RegionId parameter in the schema. Baseline 3 is appropriate when the schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('列出' - list) and resource ('OSS存储空间' - OSS buckets) with geographic scope ('指定区域' - specified region). It distinguishes from sibling tools like ListObjects (which lists objects within buckets) but doesn't explicitly differentiate from other list-like tools like DescribeInstances or DescribeRegions.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites, when not to use it, or compare it to similar tools like DescribeRegions (which might list regions rather than buckets). The context is implied but not explicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ListObjectsC
获取指定OSS存储空间中的所有文件信息。
| Name | Required | Description | Default |
|---|---|---|---|
| BucketName | Yes | AlibabaCloud OSS Bucket Name | |
| Prefix | No | AlibabaCloud OSS Bucket Name prefix | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states it retrieves file information, implying a read-only operation, but doesn't specify whether this is safe, if it requires specific permissions, what the output format is, or any rate limits. For a tool with zero annotation coverage, this leaves significant gaps in understanding its behavior and constraints.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that directly states the tool's purpose without any unnecessary words. It's front-loaded with the core action and resource, making it easy to understand at a glance. Every part of the sentence contributes to clarifying the tool's function.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of interacting with cloud storage (OSS), no annotations, and no output schema, the description is incomplete. It doesn't explain what 'file information' includes, how results are returned, pagination, error handling, or authentication needs. For a tool that likely returns a list of objects with metadata, more context is needed to use it effectively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description coverage is 100%, with clear descriptions for all three parameters (BucketName, Prefix, RegionId). The description adds no additional parameter semantics beyond what the schema provides, such as explaining how Prefix filters results or default behaviors. Since the schema does the heavy lifting, the baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('获取' meaning 'get' or 'retrieve') and resource ('所有文件信息' meaning 'all file information' from an OSS storage space). It specifies the scope ('指定OSS存储空间中' meaning 'in the specified OSS storage space'), making the purpose unambiguous. However, it doesn't explicitly differentiate from sibling tools like ListBuckets, which likely lists buckets rather than objects within a bucket, so it misses full sibling distinction.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention any prerequisites, such as needing proper authentication or permissions, or compare it to other tools like ListBuckets or DescribeInstances. The context is implied by the tool name and description, but no explicit usage rules are given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
PutBucketC
创建一个新的OSS存储空间。
| Name | Required | Description | Default |
|---|---|---|---|
| BucketName | Yes | AlibabaCloud OSS Bucket Name | |
| DataRedundancyType | No | The data disaster recovery type of AlibabaCloud OSS Bucket, LRS (default): Locally redundant LRS, which stores your data redundantly on different storage devices in the same availability zone. ZRS: Intra-city redundant ZRS, which uses a multi-availability zone (AZ) mechanism to store your data redundantly in three availability zones in the same region. | LRS |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
| StorageClass | No | The Storage Type of AlibabaCloud OSS Bucket, The value range is as follows: Standard (default): standard storage, IA: infrequent access, Archive: archive storage, ColdArchive: cold archive storage, DeepColdArchive: deep cold archive storage | Standard |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. While 'creates' implies a write/mutation operation, it doesn't describe permissions required, whether the operation is idempotent, what happens on failure, or any rate limits. For a bucket creation tool with zero annotation coverage, this leaves significant behavioral gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that states the core purpose without any wasted words. It's appropriately sized for a creation operation and gets straight to the point.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a bucket creation tool with no annotations and no output schema, the description is insufficient. It doesn't explain what happens after creation, what permissions are needed, whether the bucket name must be globally unique, or what the response contains. The 100% schema coverage helps with parameters, but behavioral and operational context is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all 4 parameters thoroughly with descriptions, defaults, and value explanations. The description adds no additional parameter information beyond what's in the schema, meeting the baseline expectation when schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('创建一个新的' - creates a new) and resource ('OSS存储空间' - OSS storage space/bucket). It's specific about what the tool does, though it doesn't explicitly differentiate from sibling tools like ListBuckets or DeleteBucket in the description text itself.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. There's no mention of prerequisites, when creation is appropriate versus listing existing buckets, or what happens if a bucket with the same name already exists. The sibling tool ListBuckets exists but isn't referenced.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
RebootInstancesB
批量重启ECS实例,适用于需要同时管理和重启多台ECS实例的场景。
| Name | Required | Description | Default |
|---|---|---|---|
| ForeceStop | No | Is forced shutdown required | |
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. It mentions '批量重启' (batch reboot) which implies a destructive/mutative operation affecting multiple instances, but doesn't disclose critical behavioral aspects like: whether this requires specific permissions, potential service interruption duration, whether instances must be in a particular state, error handling for partial failures, or confirmation requirements. The description is insufficient for a mutation tool with zero annotation coverage.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient Chinese sentence that communicates the core purpose and context. It's appropriately sized without unnecessary elaboration, though it could be slightly more front-loaded by stating the primary action more prominently.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a destructive batch operation tool with no annotations and no output schema, the description is incomplete. It doesn't address critical aspects like: what happens during reboot (service interruption), whether instances must be stopped first, error behavior for invalid InstanceIds, return values or confirmation, or rate limits. The combination of mutation tool + zero annotations + no output schema requires more comprehensive description.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all three parameters (InstanceIds, RegionId, ForceStop). The description adds no additional parameter semantics beyond what's in the schema - it doesn't explain parameter interactions, format details, or usage examples. Baseline 3 is appropriate when the schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('批量重启' - batch reboot) and target resource ('ECS实例' - ECS instances), making the purpose understandable. It distinguishes from some siblings like StartInstances/StopInstances by specifying reboot rather than power state changes, though it doesn't explicitly differentiate from RebootRDSInstances which reboots a different resource type.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides some usage context ('适用于需要同时管理和重启多台ECS实例的场景' - suitable for scenarios requiring simultaneous management and reboot of multiple ECS instances), which implies batch operations. However, it doesn't explicitly state when to use this versus alternatives like StopInstances+StartInstances or RebootRDSInstances, nor does it mention prerequisites or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
RebootRDSInstancesB
批量重启RDS实例,适用于需要同时管理和重启多台RDS实例的场景。
| Name | Required | Description | Default |
|---|---|---|---|
| InstanceIds | Yes | AlibabaCloud RDS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions batch restarting but does not cover critical aspects such as whether this operation is destructive (likely yes, as rebooting disrupts service), required permissions, rate limits, or what happens during the reboot process. This leaves significant gaps for an agent to understand the tool's behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese that front-loads the core purpose ('批量重启RDS实例') and adds context. It avoids redundancy and wastes no words, though it could be slightly more structured for clarity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of a batch restart operation, no annotations, and no output schema, the description is incomplete. It fails to address behavioral traits (e.g., destructiveness, permissions), output expectations, or error handling, which are crucial for an agent to use this tool effectively in a production environment.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description coverage is 100%, with clear descriptions for both parameters (InstanceIds and RegionId). The description adds no additional parameter semantics beyond what the schema provides, such as format details or constraints. According to the rules, with high schema coverage (>80%), the baseline score is 3, as the schema adequately documents the parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('批量重启' meaning 'batch restart') and resource ('RDS实例' meaning 'RDS instances'), which is specific and unambiguous. However, it does not explicitly differentiate from sibling tools like 'RebootInstances' or 'StartRDSInstances', though the focus on RDS instances implies some distinction.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides implied usage context by stating it's for scenarios requiring simultaneous management and restart of multiple RDS instances. However, it lacks explicit guidance on when to use this tool versus alternatives like 'RebootInstances' (for non-RDS instances) or 'StartRDSInstances' (for starting rather than restarting), and does not mention prerequisites or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ReplaceSystemDiskC
批量替换ECS实例的系统盘,更换操作系统
| Name | Required | Description | Default |
|---|---|---|---|
| ImageId | Yes | Image ID | |
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It mentions '批量替换' (batch replacement) and '更换操作系统' (OS change), which implies a destructive, write operation. However, it lacks critical behavioral details: whether instances need to be stopped first, if data loss occurs, required permissions, rate limits, or what the response looks like. For a destructive tool with zero annotation coverage, this is a significant gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Chinese: '批量替换ECS实例的系统盘,更换操作系统' (Batch replace ECS instance system disks, change the operating system). It's front-loaded with the core action and resource, with no wasted words or redundant information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of a destructive batch operation (replacing system disks and changing OS), no annotations, and no output schema, the description is incomplete. It lacks essential context: prerequisites (e.g., instance state), side effects (data loss, downtime), error handling, and response format. For a high-stakes tool like this, the description should provide more guidance.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all three parameters (ImageId, InstanceIds, RegionId) with basic descriptions. The description adds no additional parameter semantics beyond implying that ImageId relates to the new OS and InstanceIds are for batch operations. Baseline 3 is appropriate when the schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('批量替换' - batch replace) and resource ('ECS实例的系统盘' - ECS instance system disk), with the additional context of '更换操作系统' (changing the operating system). It's specific about what the tool does, though it doesn't explicitly differentiate from sibling tools like 'RebootInstances' or 'RunInstances' which might be related but serve different purposes.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., instance must be stopped), exclusions, or compare it to siblings like 'RunInstances' (which creates new instances) or 'RebootInstances' (which restarts without disk replacement). Usage is implied only by the action described.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ResetPasswordA
批量修改ECS实例的密码,请注意,本操作将会重启ECS实例
| Name | Required | Description | Default |
|---|---|---|---|
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| Password | Yes | The password of the ECS instance must be 8-30 characters and must contain only the following characters: lowercase letters, uppercase letters, numbers, and special characters only.()~!@#$%^&*-_+=(40:<>,?/ | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden and adds crucial behavioral context: it explicitly warns that the operation will restart ECS instances ('本操作将会重启ECS实例'). This discloses a significant side effect not evident from the input schema alone, though it could further detail authentication needs or rate limits.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise with just two clauses: the core purpose and a critical warning. Every word earns its place, and the warning is front-loaded after the main action, making it immediately noticeable without unnecessary elaboration.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a mutation tool with no annotations and no output schema, the description is minimally complete: it states the purpose and a key behavioral trait (restart). However, it lacks details on permissions, error handling, or return values, leaving gaps given the tool's destructive nature and complexity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all three parameters thoroughly. The description doesn't add any parameter-specific semantics beyond what's in the schema, maintaining the baseline score of 3 for adequate but no extra value.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the specific action ('批量修改ECS实例的密码' - batch modify ECS instance passwords) and resource ('ECS实例' - ECS instances). It distinguishes from siblings like 'RebootInstances' by specifying password reset as the primary purpose, not just restarting.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage context through the warning about instance restart, suggesting this tool should be used when password changes are needed despite downtime. However, it doesn't explicitly state when to use this vs alternatives like 'RunCommand' for remote password changes or 'RebootInstances' for just restarting without password modification.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
RunCommandB
批量在多台ECS实例上运行云助手命令,适用于需要同时管理多台ECS实例的场景,如应用程序管理和资源标记操作等。
| Name | Required | Description | Default |
|---|---|---|---|
| Command | Yes | Content of the command executed on the ECS instance | |
| CommandType | No | The type of command executed on the ECS instance, optional value:RunShellScript,RunPythonScript,RunPerlScript,RunBatScript,RunPowerShellScript | RunShellScript |
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It mentions the tool runs commands on instances but doesn't describe critical behavioral aspects: what permissions are required, whether commands run synchronously or asynchronously, how results are returned, potential side effects, error handling, or rate limits. For a tool that executes commands on cloud instances (a potentially powerful/destructive operation), this is a significant gap in transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is appropriately concise - two sentences that convey the core purpose and usage context without unnecessary elaboration. It's front-loaded with the main functionality. While efficient, it could potentially benefit from slightly more structure (e.g., separating purpose from examples more clearly).
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of a command execution tool with no annotations and no output schema, the description is incomplete. It doesn't explain what the tool returns (success/failure indicators, command outputs, execution IDs), doesn't mention authentication requirements, doesn't warn about potential destructive commands, and doesn't provide error handling context. For a tool that could significantly impact cloud instances, more comprehensive guidance is needed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all four parameters thoroughly. The description doesn't add any parameter-specific information beyond what's in the schema (it doesn't explain Command syntax, InstanceIds format, or RegionId implications). According to scoring rules, when schema coverage is high (>80%), the baseline is 3 even with no param info in the description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: '批量在多台ECS实例上运行云助手命令' (batch run cloud assistant commands on multiple ECS instances). It specifies the verb ('运行' - run) and resource ('ECS实例' - ECS instances), and mentions the multi-instance scope. However, it doesn't explicitly differentiate from potential sibling tools like 'RunInstances' (which likely provisions instances rather than running commands on existing ones).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides some usage context: '适用于需要同时管理多台ECS实例的场景,如应用程序管理和资源标记操作等' (suitable for scenarios requiring simultaneous management of multiple ECS instances, such as application management and resource tagging operations). This implies when to use it (batch management scenarios) but doesn't explicitly state when NOT to use it or name specific alternatives among the sibling tools. The guidance is helpful but not comprehensive.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
RunInstancesB
批量创建ECS实例,适用于需要同时创建多台ECS实例的场景,例如应用部署和高可用性场景。
| Name | Required | Description | Default |
|---|---|---|---|
| Amount | No | Number of ECS instances | |
| ImageId | Yes | Image ID | |
| InstanceName | No | Instance Name | |
| InstanceType | Yes | Instance Type | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
| SecurityGroupId | Yes | SecurityGroup ID | |
| VSwitchId | Yes | VSwitch ID |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. It mentions the batch creation capability but doesn't disclose critical behavioral traits: whether this is a destructive/write operation (implied but not stated), what permissions are required, whether there are rate limits, what happens on failure (partial success?), or what the return format looks like. For a complex creation tool with 7 parameters, this is a significant gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is appropriately concise - two sentences that efficiently convey the core purpose and usage scenarios. It's front-loaded with the main action ('批量创建ECS实例') followed by context. There's no wasted verbiage, though it could potentially benefit from slightly more detail given the tool's complexity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given this is a complex instance creation tool with 7 parameters, no annotations, and no output schema, the description is insufficiently complete. It doesn't address critical aspects: what the tool returns (instance IDs? status?), error conditions, permissions required, cost implications, or behavioral details like whether instances start automatically after creation. The description should do more to compensate for the lack of structured metadata.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so all parameters are documented in the schema. The description doesn't add any parameter-specific information beyond what's already in the schema descriptions. It mentions batch creation which relates to the 'Amount' parameter, but doesn't provide additional context about parameter interactions, dependencies, or usage patterns. Baseline 3 is appropriate when schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: '批量创建ECS实例' (batch create ECS instances). It specifies the verb (create) and resource (ECS instances), and adds context about batch operations. However, it doesn't explicitly differentiate from potential siblings like 'StartInstances' or 'DescribeInstances' beyond mentioning batch creation scenarios.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides some usage context: '适用于需要同时创建多台ECS实例的场景,例如应用部署和高可用性场景' (suitable for scenarios requiring simultaneous creation of multiple ECS instances, such as application deployment and high availability scenarios). This gives implied guidance about when to use it (batch creation needs), but doesn't explicitly state when NOT to use it or mention alternatives like creating single instances through other means.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
StartInstancesB
批量启动ECS实例,适用于需要同时管理和启动多台ECS实例的场景,例如应用部署和高可用性场景。
| Name | Required | Description | Default |
|---|---|---|---|
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. While it mentions this is for batch operations and gives usage scenarios, it doesn't disclose important behavioral aspects: whether this requires specific permissions, what happens if some instances fail to start, whether there are rate limits, what the expected response looks like, or whether this operation is idempotent. For a mutation tool with zero annotation coverage, this is a significant gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is appropriately concise with two clear sentences. The first sentence states the core functionality, and the second provides usage context. There's no wasted verbiage or unnecessary repetition. However, it could be slightly more front-loaded by making the batch nature more prominent earlier.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a mutation tool with no annotations and no output schema, the description is insufficiently complete. It doesn't explain what the tool returns, what error conditions might occur, or important behavioral constraints. Given that this performs a potentially significant operation (starting cloud instances), more contextual information about permissions, idempotency, and failure modes would be valuable.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description doesn't mention any parameters directly, but with 100% schema description coverage, the schema already documents both parameters (InstanceIds and RegionId) adequately. The description's mention of '批量' (batch) operation aligns with the InstanceIds array parameter, but adds minimal semantic value beyond what the schema provides. The baseline of 3 is appropriate when the schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('批量启动' - batch start) and resource ('ECS实例' - ECS instances), making the purpose immediately understandable. It distinguishes from siblings like StopInstances and RebootInstances by focusing on starting rather than stopping or restarting. However, it doesn't explicitly differentiate from StartRDSInstances (which starts RDS instances rather than ECS instances).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides usage context with examples ('应用部署和高可用性场景' - application deployment and high availability scenarios), which helps understand when this tool might be appropriate. However, it doesn't explicitly state when NOT to use this tool or mention clear alternatives like RunInstances (for creating and starting new instances) or RebootInstances (for restarting already running instances).
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
StartRDSInstancesB
批量启动RDS实例,适用于需要同时管理和启动多台RDS实例的场景,例如应用部署和高可用性场景。
| Name | Required | Description | Default |
|---|---|---|---|
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. It mentions batch operations and use cases but fails to disclose critical behavioral traits such as permissions required, whether this is a destructive/mutative operation (implied by 'start' but not explicit), potential side effects, rate limits, or what happens if instances are already running. This leaves significant gaps for an agent to understand the tool's behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise with two sentences that efficiently convey purpose and usage context without unnecessary elaboration. It is front-loaded with the core action and resource, followed by contextual examples. There's minimal waste, though it could be slightly more structured with explicit bullet points for use cases.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (batch operation on cloud resources), lack of annotations, and no output schema, the description is incomplete. It doesn't address behavioral risks, output format, error conditions, or prerequisites like authentication. For a mutative tool with no structured safety hints, this leaves the agent under-informed about critical operational aspects.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, providing good documentation for both parameters (InstanceIds and RegionId). The description adds no additional parameter semantics beyond what's in the schema, such as format details for InstanceIds or RegionId constraints. With high schema coverage, the baseline score of 3 is appropriate as the description doesn't compensate but also doesn't detract.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('批量启动' - batch start) and resource ('RDS实例' - RDS instances), making the purpose evident. It distinguishes from sibling tools like 'StartInstances' by specifying RDS instances, though it doesn't explicitly contrast with 'StopRDSInstances' or other RDS operations.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides usage context ('适用于需要同时管理和启动多台RDS实例的场景,例如应用部署和高可用性场景' - suitable for scenarios requiring simultaneous management and startup of multiple RDS instances, such as application deployment and high availability scenarios), which implies when to use it. However, it lacks explicit guidance on when NOT to use it or alternatives like 'StartInstances' for non-RDS instances.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
StopInstancesB
批量停止ECS实例,适用于需要同时管理和停止多台ECS实例的场景。
| Name | Required | Description | Default |
|---|---|---|---|
| ForeceStop | No | Is forced shutdown required | |
| InstanceIds | Yes | AlibabaCloud ECS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It mentions batch stopping but lacks critical behavioral details: whether this is destructive (likely yes, but not stated), permission requirements, rate limits, error handling, or what happens to running workloads. The description is too vague for a mutation tool with no annotation coverage.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that front-loads the core purpose. It avoids unnecessary words, though it could be slightly more structured by separating purpose from usage context.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given this is a mutation tool (stopping instances) with no annotations and no output schema, the description is incomplete. It lacks details on behavioral traits (e.g., destructiveness, side effects), error cases, or return values, which are crucial for safe agent operation in a cloud environment.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all parameters (InstanceIds, ForceStop, RegionId). The description adds no additional parameter semantics beyond implying batch operations via '批量' (batch), which is redundant with the array type of InstanceIds. Baseline 3 is appropriate when schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('批量停止' - batch stop) and resource ('ECS实例' - ECS instances), making the purpose evident. It distinguishes from siblings like StopRDSInstances by specifying ECS instances, but doesn't explicitly differentiate from RebootInstances or DeleteInstances, which are also instance management tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides implied usage context ('适用于需要同时管理和停止多台ECS实例的场景' - suitable for scenarios requiring simultaneous management and stopping of multiple ECS instances), suggesting batch operations. However, it doesn't explicitly state when to use this versus alternatives like RebootInstances or DeleteInstances, nor does it mention prerequisites or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
StopRDSInstancesB
批量停止RDS实例,适用于需要同时管理和停止多台RDS实例的场景。
| Name | Required | Description | Default |
|---|---|---|---|
| InstanceIds | Yes | AlibabaCloud RDS instance ID List | |
| RegionId | No | AlibabaCloud region ID | cn-hangzhou |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It mentions batch stopping but doesn't disclose critical behavioral traits: whether this is destructive (likely yes, but not stated), what permissions are required, whether instances can be restarted afterward, if there are rate limits, or what happens to associated resources. For a mutation tool with zero annotation coverage, this is a significant gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that communicates the core purpose and usage context without unnecessary words. It's appropriately sized for a tool with 2 parameters and clear functionality, though it could be slightly more front-loaded with the primary action.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given this is a destructive mutation tool (stopping cloud instances) with no annotations and no output schema, the description is incomplete. It should address safety considerations, permissions, what the tool returns, and error conditions. The current description leaves too many behavioral questions unanswered for a tool that modifies production infrastructure.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents both parameters (InstanceIds and RegionId). The description doesn't add any parameter-specific information beyond what's in the schema. With high schema coverage, the baseline is 3 even without additional param details in the description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('批量停止' - batch stop) and resource ('RDS实例' - RDS instances), making the purpose evident. It distinguishes from individual stop operations by emphasizing batch capability, though it doesn't explicitly differentiate from sibling 'StopInstances' which stops ECS instances rather than RDS instances.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides some usage context ('适用于需要同时管理和停止多台RDS实例的场景' - suitable for scenarios requiring simultaneous management and stopping of multiple RDS instances), which implies when to use it (batch operations). However, it doesn't explicitly state when NOT to use it or mention alternatives like 'StopInstances' for ECS instances or individual RDS instance stopping methods.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
TDQS
Most tools have distinct purposes targeting specific resources (e.g., OSS buckets, ECS instances, RDS instances, monitoring metrics), but there is some overlap in monitoring tools like GetCpuloadavg15mData, GetCpuloadavg5mData, and GetCpuLoadavgData which differ only in time granularity and could be confusing. Overall, the boundaries are clear for the majority of tools.
The naming follows a consistent verb_noun pattern (e.g., DescribeInstances, RunInstances, DeleteBucket) with minor deviations such as GetCpuloadavgData (mixed case) and ListBuckets vs. ListObjects. Most tools use camelCase with initial capitals, but a few like GetCpuloadavgData break this slightly, though the pattern remains largely predictable.
With 34 tools, the count is borderline high for a cloud management server, as it covers multiple services (ECS, RDS, OSS, VPC, monitoring). While comprehensive, it may feel heavy and could be streamlined by grouping similar operations, but it's not extreme and aligns with the broad scope of Alibaba Cloud services.
The tool set provides good coverage for core cloud operations including CRUD for instances, buckets, and monitoring, with lifecycle management (create, start, stop, reboot, delete). Minor gaps exist, such as no explicit update tools for instances or buckets, but agents can work around this using existing tools like ReplaceSystemDisk or by combining operations.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
SEFAZ: Cadastro Centralizado de Contribuinte (CCC), official-source lookup. Platform-hosted, pay per
SEFAZ RO DEC: Caixa Postal, official-source lookup. Platform-hosted, pay per query with prepaid cred
Cadastro Ambiental Rural: Imóvel, official-source lookup. Platform-hosted, pay per query with prepai
Cadastro Ambiental Rural: Demonstrativo, official-source lookup. Platform-hosted, pay per query with
Related MCP Servers
- AlicenseCqualityDmaintenanceA Model Context Protocol server that enables AI agents to interact with Alibaba Cloud DataWorks through standardized interfaces, allowing seamless management of DataWorks resources and operations via the DataWorks Open API.10011450Apache 2.0
- AlicenseBqualityAmaintenanceA server that provides management and connectivity for Alibaba Cloud RDS database services via OpenAPI, enabling users to create, query, and modify RDS instances through MCP integration.3655Apache 2.0
- FlicenseBqualityDmaintenanceA server that provides access to Alibaba Cloud workitem descriptions through MCP protocol, allowing agents to retrieve structured workitem data including text, images, and HTML content by ID.11
- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables agent applications like Cursor and Cline to integrate with Alibaba Cloud Function Compute, allowing them to deploy and manage serverless functions through natural language interactions.12359MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/aliyun/alibaba-cloud-ops-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server