医薬品詳細取得

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

アノテーションが一切ないため、説明文が動作に関する負担をすべて負う。「取得します」は読み取り操作を示すが、認証の必要性、ネットワークアクセス、レート制限、エラー時（IDなしなど）の動作、部分的なデータ/返り値の形式については明示されていない。破壊的な動作のヒントはないが、読み取り専用のヒントや外部副作用の開示もない。

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?

「KEGG IDを指定して」という文が先頭で、資源が明確になっており、日本語として簡潔で1文のみで、無駄な言葉はない。パラメータの手順や代替手段の詳細を盛り込む必要性に欠ける、整った構造である。

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?

入力は低複雑度（必須パラメータ1つのみ）で、出力スキーマも存在するため、返却値の構造は自己記述的。ただし、記述にはツールのエラーの動作（「見つからない場合は0件や空を返す」）や外部依存（KEGG REST API、ネットワーク認証、レート制限など）については書かれておらず、これらは実行時には不明な点となる。

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?

入力スキーマは kegg_id（文字列）のみでカバレッジ0%。説明文は「KEGG IDを指定」とだけ述べており、スキーマの名前と同じで実質的な意味を追加していない。唯一の追加情報は「search_drugで得たkegg_idを渡してください」というメタ手順の指示で、データ形式やフォーマット、IDの由来は説明されていない。

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?

「KEGG IDを指定して医薬品の詳細（一般名・分類・標的・相互作用など）を取得します」は、具体的な動詞「取得」とリソース「医薬品詳細」、および一意の識別子「KEGG ID」を明示しており、ツールの目的は明確。姉妹ツール search_drug はリスト取得用であることが「search_drugで得たkegg_idを渡してください」の記述から差別化されている。

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?

「search_drugで得たkegg_idを渡してください」という記述が、直近の検索フローからのIDを渡すワークフローを示しており、使用タイミングは暗黙に示されている。ただし、代替案や不使用条件は明示されていないものの、このワークフローの示唆は十分に明確である。

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