Получение SSH-ключа

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

Аннотации содержат readOnlyHint: false, тогда как описание заявляет только возврат информации ('Возвращает детальную информацию'), что является прямым противоречием. Дополнительных поведенческих деталей (аутентификация, ошибки, ограничения, возможные побочные эффекты) нет.

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?

Для простого GET-запроса с одним параметром описание достаточно полно: перечислены все значимые возвращаемые данные (имя, тело, дата, is_default, серверы). Однако отсутствует выходная схема, детали об ошибках и формате ответа, а также есть противоречие с аннотацией readOnlyHint.

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?

Входная схема покрывает 100% параметров (ssh_key_id) и уже содержит описание 'ОБЯЗАТЕЛЬНОЕ ПОЛЕ - ID SSH-ключа'. Описание добавляет лишь контекст 'по его ID', не углубляясь в формат или валидацию, поэтому базовая оценка 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?

Описание начинается с глагола 'Возвращает' и конкретного объекта 'детальную информацию об SSH-ключе по его ID', чётко отличаясь от list_ssh_keys (список всех ключей) и create/update/delete. Указание возвращаемых полей (имя, тело, дата создания, is_default, серверы) делает назначение однозначным.

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?

Описание явно указывает на сценарий 'по его ID', подразумевая использование для получения конкретного ключа, а не списка. Нет явных исключений или упоминания альтернатив, но контекст достаточно ясен для правильного выбора среди sibling-инструментов.

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