macro_china_swap_rate

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

注解已声明readOnlyHint=true、openWorldHint=true、idempotentHint=true和destructiveHint=false，覆盖了安全特征。描述额外提供了数据可用性限制（近一年）和返回类型（pandas.DataFrame），并包含了原始数据URL，增加了上下文价值。没有与注解冲突。

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?

描述较为简洁，包含了功能、参数、返回类型和数据源，长度适中。但docstring格式（如:param, :type, :return）对AI agent来说略显冗余，且标题信息在描述中重复出现，稍微影响了精炼度。

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?

作为只读数据获取工具，描述涵盖了核心信息：数据内容、来源、参数约束和返回类型（DataFrame）。由于没有输出schema，描述补充了返回值类型，足够引导agent使用。但缺少错误处理或超出日期范围时的行为信息，因此未达到满分。

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?

描述为start_date和end_date提供了中文含义和“不得超过一个月”的约束，这是有价值的补充。然而，schema覆盖率为0%，描述未能明确说明日期格式（如YYYYMMDD），虽然默认值暗示了该格式。参数语义基本清晰但仍有提升空间。

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?

描述明确说明了工具提供FR007利率互换曲线历史数据，并附带了数据来源URL和近一年的数据限制。虽然没有显式的动作动词如“获取”，但结合工具名和返回类型，用途清晰。与同侪工具（如macro_china_lpr等）相比，FR007 swap rate 是独特的，因此具有区分度。

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?

描述明确指出了关键使用限制：只能获取近一年的数据，且开始和结束日期之间的跨度不得超过一个月。这些约束对正确调用至关重要。但描述未提及任何替代工具或何时应避免使用此工具，因此没有达到最高分。

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