kingdee_query_production_plan

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description adds minimal behavioral context beyond annotations. It states the return type (JSON array) and explains the data's origin, but does not disclose details like pagination, filtering behavior, or authentication needs. Annotations already indicate read-only.

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 (two sentences plus returns line) and front-loads the purpose. Every sentence is relevant, but it could include more detail 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 (multiple filter parameters, output as array), the description is incomplete. It lacks guidance on usage and parameter semantics. The existing annotations and output schema mitigate some gaps, but the description should do more.

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 does not explain any parameters. Schema coverage for the top-level 'params' object is 0%, and the nested properties have schema descriptions but lack context on usage or syntax. The description should add meaning beyond the schema, but it does not.

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 '查询生产计划单' (query production plan), which is a specific verb-resource pair. The annotation title also confirms this. However, it does not differentiate from sibling query tools like kingdee_query_production_orders.

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 only describes the data context (MRP, push to orders) but lacks explicit when-to-use or when-not-to-use instructions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.