Инструменты агента: поиск в интернете и чтение файлов

Пять инструментов и кнопка «Инструменты»

Инструменты — это операции, которые модель может попросить выполнить: сама она к диску и к сети доступа не имеет. В ряду инструментов панели чата стоит кнопка-пилюля Инструменты с подсказкой «Инструменты агента: поиск и чтение файлов». Клик открывает список тумблеров:

• Искать в интернете — находит факты, даты, статьи по запросу;
• Читать страницу по ссылке — открывает адрес и отдаёт модели текст;
• Смотреть библиотеку — показывает ваши тексты из библиотеки;
• Искать по библиотеке — находит фразу в ваших текстах;
• Читать главы и заметки — читает главу или заметку целиком.

По умолчанию включены все пять. Модель вызывает их только тогда, когда без них не обойтись, — на кнопке видно, сколько инструментов работает сейчас. Выбор запоминается в браузере, так что после перезапуска всё остаётся как было.

Поиск в интернете

Поиск идёт через DuckDuckGo и не требует API-ключа. Это честная попытка, а не гарантия: публичного API без ключа у поисковика нет, поэтому выдача разбирается как обычная страница. Поиск сначала пробует одну форму выдачи, потом резервную; если обе не ответили или разметка изменилась, инструмент сообщает об ошибке, а не выдумывает результаты.

Найденные ссылки агент читает отдельным инструментом: страница отдаётся модели текстом, слишком длинная — с обрезкой, а адрес и число знаков попадают в плашку над ответом. Если страница не открылась или в ней нет текста, агент скажет об этом прямо.

Библиотека

Тексты для агента лежат в папке library рядом с данными приложения. Папка создаётся сама, внутри лежит поясняющий README — его можно прочитать первым делом. Открыть её в Finder или Проводнике можно из системного меню приложения: пункт «Папки» → «Библиотека — открыть в Finder» (на Windows — «…открыть в Проводнике»).

Библиотека — это именно читальня, а не второе хранилище рукописи. Кладите сюда черновики, заметки, чужие рассказы для разбора, выгрузки из интернета: агент увидит их и сможет сослаться на фрагмент, но ничего в них не поправит.

Кто поддерживает инструменты

Инструменты работают у провайдеров типа openai-compatible, anthropic и yandexgpt. У google (Gemini) и у GigaChat их пока нет: запрос уходит без инструментов, а в ответе появляется пометка, что эта модель не умеет искать и читать файлы. Если инструменты включены, а провайдер их не знает, приложение не роняет чат, а честно объясняет, почему ответ пришёл без них. Список провайдеров и типы API — в статье «Провайдеры и модели».

Шаги и стоимость

За один ответ модель делает не больше шести шагов. Шаг — это отдельный запрос к модели: она просит инструмент, получает результат и решает, что делать дальше. Поэтому расход токенов растёт, и в ответе он суммируется по всем шагам, а не показывается только за последний.

Отсюда простое правило: чем больше инструментов включено и чем охотнее модель ими пользуется, тем дороже и дольше один ответ. На последнем шаге инструменты уже не предлагаются — модель обязана дать ответ по тому, что успела собрать, чтобы поиск не превращался в бесконечный цикл.

Плашки над ответом

О том, что агент делал, рассказывают плашки над ответом: что он искал, что прочитал и сколько результатов получил. Формулировки короткие и конкретные — например, сколько текстов нашлось в библиотеке или сколько строк оказалось в прочитанном файле.

• инструмент сработал — обычная плашка с иконкой действия;
• инструмент не сработал — плашка подсвечивается оранжевым и называет причину: файл вне библиотеки, страница не открылась, поиск не ответил;
• провайдер не умеет инструменты — отдельная пометка, что ответ пришёл без них.