search_news

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

无注解可用，描述需承担完整行为披露责任。它说明了返回JSON格式的参数细节，但未明确声明该操作是只读的、是否修改数据，也未提及权限或副作用。搜索操作通常隐含只读，但未显式说明这一关键行为特质。

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?

描述较长但结构清晰，分为Args、Returns、Examples三部分，每个句子都承载必要信息。内容虽多但无冗余，为全面解释参数和示例所必需，组织良好，略超于“简洁”但合理。

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?

鉴于工具拥有10个参数且无schema描述，描述提供了完整的信息：每个参数的意义、默认值、格式，使用建议，以及三个典型示例。虽存在输出模式，描述仍概括了返回结构（JSON），没有遗漏关键调用信息，对于复杂工具而言非常全面。

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描述覆盖率为0%，描述完全弥补了这一点。Args部分详细解释了全部10个参数，包括枚举值（搜索模式）、默认值、格式示例（date_range）、条件用途（threshold仅fuzzy模式）、布尔标志含义等，远超出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?

描述使用具体动词“搜索”和资源“热榜和RSS”，明确指出这是“统一搜索接口”，能区分于兄弟工具如search_rss（仅RSS）和get_latest_news（最新新闻）。但未明确命名这些兄弟工具或说明它们的差异，因此未达到5分。

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?

描述明确建议在需要自然语言日期时先调用resolve_date_range，提供了具体的使用场景。但未明确说明何时不使用本工具（如仅搜索RSS时该用哪个），缺乏排除性指导，未达到5分。

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