Документы
ExtractPageText
Чтение.
Извлечь весь текст со страницы документа с координатами. Работает с XPS и PDF документами. Результат записывается в файл (JSONL). Единицы координат (x, y, width, fontSize) зависят от формата: XPS — 1/96 дюйма, PDF — пункты (1/72 дюйма); y — верх текста сверху вниз.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
documentId |
string |
да | GUID документа в Pilot | |
page |
int |
нет | -1 |
Номер страницы (начинается с 0). Если -1, извлечь все страницы. |
FindTextOnPage
Чтение.
Найти текст на страницах документа и получить координаты всех вхождений (x, y, ширина, размер шрифта). Единицы координат зависят от формата: XPS — 1/96 дюйма, PDF — пункты (1/72 дюйма); y — верх текста сверху вниз. Для создания замечаний к тексту используйте AnnotateText вместо этого инструмента.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
documentId |
string |
да | GUID документа в Pilot | |
searchText |
string |
да | Текст для поиска |
GetDocumentPageImage
Чтение.
Получить изображение страницы документа (PDF или XPS). Возвращает PNG-картинку страницы для визуального анализа. dpi от 36 до 300; если длинная сторона получается больше 2000 px (крупные форматы), dpi снижается автоматически — фактический dpi указан в ответе, его нужно передавать в CreateAnnotation. Номер страницы вне диапазона — ошибка.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
documentId |
string |
да | GUID документа в Pilot | |
page |
int |
нет | 0 |
Номер страницы (с 0) |
dpi |
int |
нет | 150 |
DPI для рендеринга, 36-300 (по умолчанию 150, для экономии контекста) |
GetDocumentText
Чтение.
Прочитать текст документа (PDF или XPS). Для больших документов загружайте постранично (page=0, page=1, ...). Сначала вызовите без параметра page, чтобы узнать количество страниц, затем читайте по одной. Номер страницы вне диапазона — ошибка; если в документе нет текстового слоя (скан), об этом сообщается. Используйте для анализа содержимого (проверка орфографии, поиск ошибок и т.д.). После анализа вызывайте AnnotateText для каждой найденной ошибки — он работает с любыми документами.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
documentId |
string |
да | GUID документа в Pilot | |
page |
int |
нет | -1 |
Номер страницы (с 0). Если не указан — возвращает все страницы (для коротких документов) или только сводку с количеством страниц (для длинных). |
maxChars |
int |
нет | 10000 |
Макс. символов в ответе (0 = без лимита, по умолчанию 10000) |