СкуфозаврEN
Меню

Практика / Инструменты

Возвращать из инструмента данные для решения

Поля, ограничение выдачи и признаки неполноты вместо многократного чтения полной выгрузки.

90%

Даёт схему ответа инструмента с признаками неполноты.

Содержание и границы применения

Проектирование поисковых инструментов и ответов с большим числом записей.

Сужение ответа не должно скрывать ошибки или значимые данные. Полный источник должен оставаться доступным в разрешённых границах.

Быстрая проверка

Проверьте, что агент различает неполную выдачу и полный поиск без результата.

Скачать сценарий проверки · node check-tool-output.mjs

Шесть сценариев покрывают совпадение на обеих страницах, пагинацию, отсутствие результата, потерю курсора и сбой источника.

Синтетические данные. Сценарий проверяет правило, замеров модели и стоимости здесь нет.

Механизм

Anthropic рекомендует проектировать ответы инструментов вокруг информации, полезной агенту, и контролировать расход контекста. Полезность инструмента проверяется через задачи, а не только через корректность его схемы.

Предлагаемый формат

Для вопроса «какие задачи ещё открыты?» редакция предлагает возвращать идентификатор, название, статус и ссылку. Большие вложения и историю изменений можно получать отдельным чтением.

{
  "items": [
    {"id": "demo-17", "title": "Проверить каталог", "status": "open"}
  ],
  "returned": 1,
  "truncated": true,
  "next_cursor": "demo-page-2"
}

Все значения искусственные. truncated означает неполную выдачу: нельзя делать вывод, что в системе существует только одна открытая задача.

Что важно сохранить

Пользователь должен понимать применённый фильтр, область поиска и способ продолжения. Ошибка запроса не становится пустым успешным списком. Для неоднозначных значений возвращайте пояснение или признак неизвестности.

Проверка

Задайте вопрос, который требует последней страницы выдачи, и вопрос, ответ на который отсутствует. Проверьте, различает ли агент найденное, не найденное и ещё не просмотренное. Сравните время, качество и объём всех дополнительных чтений с исходным инструментом.

Источники и происхождение