Что экономит ограниченная конверсия?

Каждое слово, которое вы помещаете в запрос, читается, оплачивается провайдером модели и конкурирует за внимание со всеми остальными словами. Большинство вопросов о длинном документе касаются лишь небольшой его части. Если сначала конвертировать всё, а затем просить модель игнорировать большую часть, вы платите за весь документ при каждом вопросе.

Экономию легко измерить на документе, которым вы владеете. Ниже приведено реальное измерение с указанием метода. Файл — это исходный Markdown этой же страницы лицензий в документации сервера. Мы разделили его после front‑matter и посчитали слова, разделённые пробелами, включая блоки кода и разметку Hugo‑shortcode (вся страница без shortcodes содержит 810 слов). Таблица иллюстрирует отношение объёма раздела к объёму страницы; это не измеренный результат опции pages, которая выбирает страницы, а не заголовки:

Раздел страницы Слов
Введение и три режима лицензирования 167
Ограничения режима оценки 93
Применение лицензии 78
Лицензирование по метру (pay‑per‑use) 366
Подтверждение активного режима 113
Получение лицензии 27
Вся страница 844

Вопрос о том, какой режим лицензирования активен, требует только 113‑словного раздела. Это около 13 % от всей страницы, или примерно в 7,5 раз короче, чем полный текст. Мы считаем слова, потому что количество токенов зависит от токенизатора модели; количество токенов меняется вместе со словарём, и мы не приводим здесь непроверённые цифры. Страница умышленно короткая. Ваш справочник будет больше, а соотношение вам придётся посчитать самостоятельно.

Способ 1: Какие страницы я могу указать напрямую?

Если вы знаете номера страниц, просто укажите их. Параметр pages в convert_to_markdown принимает список номеров, разделённых запятыми, например "40,41,42". Синтаксиса диапазонов в параметре нет; агент сам развернёт «40‑52» в список. Если опустить pages, будет конвертирован весь документ.

Convert pages 40 to 52 of handbook.pdf to Markdown.

Результатом будет сохранённый файл .md и содержимое, возвращённое inline. Длинный вывод обрезается в inline‑режиме, а сохранённый файл содержит полный текст.

Способ 2: Как конвертировать только главу 3?

У инструмента нет опции, ограниченной заголовком, поэтому «глава 3» сначала нужно превратить в номера страниц. Сделайте это в два небольших шага:

How many pages does handbook.pdf have, and what is its title?

get_document_info отвечает на основе файла без его конвертации: pageCount, title, author, fileFormat и isEncrypted. Он также сразу сообщает, нужен ли пароль. Затем конвертируйте страницы оглавления, прочитайте их и запросите диапазон, указанный в оглавлении.

Пример сеанса (сокращённый):

You:   How many pages does handbook.pdf have, and what is its title?
Agent: get_document_info -> pageCount: 212, title: "Operations Handbook".
You:   Convert pages 3 to 4 (the table of contents), then convert chapter 3.
Agent: convert_to_markdown (pages: "3,4") -> contents read: chapter 3 runs pages 61 to 64.
       convert_to_markdown (pages: "61,62,63,64") -> saved chapter 3 as Markdown.

Две небольшие конвертации заменяют одну огромную.

Способ 3: Как взять один лист из рабочей книги?

В файлах XLSX, XLS и ODS цифры выбирают листы, а не печатные страницы:

Convert worksheet 2 of the model to Markdown.

Это помещает одну таблицу в документ, не включая остальные листы той же книги.

Когда ограниченная конверсия стоит дополнительного шага?

  • Контекст. LLM получает только ту часть, которая отвечает на вопрос, а длинные документы остаются внутри окна.
  • Стоимость по метру. При лицензировании по метру вы платите только за обработанные данные, поэтому меньше страниц — меньший счёт.
  • Качество извлечения. Индекс, содержащий единственный релевантный приложение, не размывается остальными материалами при каждом запросе.

Если задача требует полного документа, не ограничивайте область. Конвертируйте один раз и храните Markdown.

Честные ограничения: страницы в режиме оценки

Без лицензии сервер работает в режиме оценки: обрабатываются только первые 3 страницы, каждая помечена водяным знаком оценки. Это переопределяет параметр pages. Запрос страниц 40‑52 в режиме оценки вернёт страницы 1‑3 без ошибки, поэтому глава из середины книги не может быть протестирована без лицензии. Если вывод начинается не с того места, которое вы ожидали, сначала вызовите get_license_status.

Оглавление может использовать печатные номера страниц. Если конвертированные страницы не начинаются с ожидаемого заголовка, попросите агента конвертировать соседние страницы и скорректировать список; get_document_info выдаёт общее количество страниц, что ограничивает диапазон.

FAQ

Как конвертировать только главу 3 в Markdown?

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

Что делать, когда документ слишком велик для окна контекста?

Конвертируйте только ту часть документа, которая нужна. Используйте pages для выбора страниц или листов, отвечающих на ваш вопрос, и проверьте количество страниц с помощью get_document_info перед началом работы.

Можно ли конвертировать PDF‑страницы 10‑20 в Markdown с помощью ИИ?

Да. Сформулируйте запрос простым языком: «Convert pages 10 to 20 of report.pdf to Markdown», и агент отправит развернутый список номеров страниц. Без лицензии обрабатываются только первые 3 страницы.

Углубиться