测试预处理代码

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

没有提供 annotations，因此描述承担了行为透明度的主要责任。描述披露了“需会员”的权限要求、请求参数、统一响应结构和返回的 data 为“预处理后的消息内容字符串”，让智能体知道调用后会得到处理结果。虽然没有明确说明该操作是否只读、是否执行用户代码，但“测试”和返回结果已经提供了足够的操作语义。

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?

描述由三句话组成：第一句点明端点与用途，第二句罗列参数，第三句说明响应结构，信息组织清晰且没有冗余展开。请求参数部分与 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?

工具参数简单且无嵌套对象，没有输出 schema，但描述明确解释了 data 为“预处理后的消息内容字符串”，弥补了返回值的说明缺失。同时包含了“需会员”这一关键调用前提；虽然未给出错误码细节，但统一响应中的 code/msg 已提供了基本错误信息框架。

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 为 100%，因此按校准基线应打 3 分。描述只是重复了 content、contentType、message 的中文含义，几乎没有补充超出 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?

明确说明了该工具用于“测试预处理代码”，并给出了具体的 HTTP 端点“POST /open/pre/test”，属于“特定动词+资源”的清晰表述。虽然没有像“与 open_pre_add 等工具对比”那样显式区分兄弟工具，但“测试”这一动作与预处理的增删改查兄弟工具在语义上已经明显不同。

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?

描述点明了使用前提“需会员”，并说明该工具用于测试预处理代码，暗含了与预处理增删改查工具的区别。但没有明确说明何时应使用本工具而非 open_pre_add、open_pre_edit 等其他兄弟工具，也没有明确的排除条件。

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