Быстрая проверка
Проверьте, что агент различает неполную выдачу и полный поиск без результата.
Скачать сценарий проверки · node check-tool-output.mjs
Шесть сценариев покрывают совпадение на обеих страницах, пагинацию, отсутствие результата, потерю курсора и сбой источника.
Синтетические данные. Сценарий проверяет правило, замеров модели и стоимости здесь нет.Механизм
Anthropic рекомендует проектировать ответы инструментов вокруг информации, полезной агенту, и контролировать расход контекста. Полезность инструмента проверяется через задачи, а не только через корректность его схемы.
Предлагаемый формат
Для вопроса «какие задачи ещё открыты?» редакция предлагает возвращать идентификатор, название, статус и ссылку. Большие вложения и историю изменений можно получать отдельным чтением.
{
"items": [
{"id": "demo-17", "title": "Проверить каталог", "status": "open"}
],
"returned": 1,
"truncated": true,
"next_cursor": "demo-page-2"
}
Все значения искусственные. truncated означает неполную выдачу: нельзя делать вывод, что в системе существует только одна открытая задача.
Что важно сохранить
Пользователь должен понимать применённый фильтр, область поиска и способ продолжения. Ошибка запроса не становится пустым успешным списком. Для неоднозначных значений возвращайте пояснение или признак неизвестности.
Проверка
Задайте вопрос, который требует последней страницы выдачи, и вопрос, ответ на который отсутствует. Проверьте, различает ли агент найденное, не найденное и ещё не просмотренное. Сравните время, качество и объём всех дополнительных чтений с исходным инструментом.
Источники и происхождение
- Anthropic: Writing effective tools for AI agents
Первичный инженерный материал о полезности ответов инструментов, управлении объёмом и оценке. Пример ответа — редакционный.
Область и ограничения источника →