CPI数据

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

没有提供任何annotations（无readOnlyHint、destructiveHint、idempotencyHint等），因此描述需要承担更多行为披露责任。描述仅说明“获取月度数据”，未提及数据的时间范围、数据来源（统计局？）、更新频率、返回格式、是否分城市/类别、是否有季节性调整、limit参数的作用结果等关键行为特征。相比标注齐全的工具，这个描述对行为的披露明显不足。

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?

描述为一句简洁的中文陈述，直接点明工具功能，没有冗余内容。但作为唯一说明，也显得有些过于简短，没有利用剩余空间补充使用场景或行为细节。考虑到工具功能本身简单，这个长度可以接受。

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?

工具只有一个可选参数，无输出schema，功能简单，但描述仅提供基本信息。考虑到该工具用于获取宏观经济数据，实际应用中可能需要知道数据频率（描述中已有“月度”）、时间范围、数据来源、返回字段等，而描述缺失这些上下文。与兄弟工具如fred_data、wb_data等相比，这类宏观数据工具的说明通常需要更多元信息。

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描述覆盖率为100%，唯一参数limit在schema中已有“返回数量”的描述。描述中的“月度数据”间接说明了该工具返回的是时间序列数据，limit控制的是返回的期数，这补充了limit的语义。尽管描述没有专门解释limit参数，但100%覆盖率已经让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?

描述使用明确动词“获取”和具体资源“中国居民消费价格指数(CPI)月度数据”，清晰说明这是一个获取中国CPI月度数据的工具。在众多宏观类兄弟工具（如macro_interest_rate、macro_money_supply、macro_gdp）中，标题“CPI数据”和描述都能区分其数据主题，但描述未明确提及任何兄弟工具或作用域，也没有说明与macro_inflation等其他宏观工具的区别。

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?

描述没有提供任何何时使用本工具、何时使用替代工具（如macro_gdp、macro_pmi等）的指导。从工具名称和上下文可以推断这用于获取CPI月度数据，但缺乏明确的使用条件、排除条件或与其他宏观数据工具的对比说明。

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