获取上海金交所现货价格

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

无任何 annotations，描述需承担全部行为披露责任。虽然说明了返回数据包含价格走势和技术指标，但未提及数据频率、limit 参数的作用、分页行为、是否只读等边界或副作用信息，agent 难以预知调用行为。

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。描述说明了数据内容和范围，未说明 limit 如何影响返回、数据的时间跨度、是否包含实时数据等。在无标注、无输出 schema 的情况下，描述仍有明显缺口，但工具定位尚清晰。

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 对两个参数均提供了完整描述（limit 默认30并建议30-252，symbol 枚举所有支持的品种），schema 覆盖率为100%。描述本身未额外增加参数语义，仅重复提到黄金白银，因此维持基准3分。

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?

描述以动词'获取'明确指向上海黄金交易所现货历史价格数据，并具体提及黄金、白银等品种和价格走势、技术指标，能将其与 pm_international_prices、pm_benchmark_price 等兄弟工具区分开来。虽未明说排除其他工具，但资源定位已经足够清晰。

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?

描述未提供任何使用时机或与替代工具的对照说明，未告知何时应用本工具而非 pm_international_prices 或 pm_benchmark_price。仅隐含'现货历史'这一语境，缺乏明确的 when/when-not 指导。

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