Обзор разделов

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

Аннотации уже покрывают профиль безопасности (readOnly, idempotent, non-destructive), а описание добавляет поведение сверх них: точный состав ответа (count, атрибуты, поля-связи, до sample_limit образцов), факт усечения выгрузки и предупреждение о росте времени ответа при API_MIN_INTERVAL_SECONDS пропорционально числу разделов.

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?

Output-схемы нет, и описание полностью компенсирует это, перечисляя возвращаемые поля и границы образцов. Для инструмента с двумя параметрами и покрытыми аннотациями описание достаточн для корректного вызова.

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%, поэтому оба параметра уже документированы; описание лишь повторяет диапазон 1-5 для sections и 1-3/по умолчанию 2 для sample_limit. Добавлена только косвенная деталь — что sample_limit влияет на количество образцов, а не на полноту раздела, чего недостаточно для повышенной оценки.

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?

Указан конкретный глагол и ресурс: получить структуру И образцы по 1-5 разделам, с явным ограничением области (раздел целиком не выгружается). Тул четко отделен от соседа describe_section, который покрывает случай одного раздела без образцов.

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?

Явно задано когда вызывать («нужны структура И образцы сразу»), когда не нужно (для одного раздела без образцов достаточно describe_section) и что делать дальше (seaf_jsonata_query со связывающим запросом). Все условия выбора между альтернативами заданы.

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