Pailot

Зрение (Vision)

Чтение документов моделью PailotOCR и разбор изображений зрительными моделями

Блок Зрение читает документы и изображения и отвечает на ваш вопрос о них.

По умолчанию выбрана модель PailotOCR — распознавание документов Pailot внутри контура компании:

  • Принимает PDF или изображение PNG, JPEG, WebP загруженным файлом или ссылкой — например, <start.pdf> из Старта. Файл платформы читается только при доступе к нему, внешняя ссылка скачивается с защитой от обращений во внутреннюю сеть.
  • Распознаёт документ целиком: текст всех страниц, таблицы, колонтитулы и номера страниц.
  • Затем локальная модель pailotgpt 3 отвечает на prompt по распознанному тексту.
  • Ключ API (Application Programming Interface — программный интерфейс) не нужен, документ не уходит во внешние сервисы.
  • В выходе content — ответ, document — весь распознанный документ для следующих блоков, warnings — предупреждения.

Другие модели:

  • pailotgpt 3 — локальная мультимодальная модель: описывает фотографии, схемы и видео.
  • gpt-4o и Claude 3 — облачные модели; нужен ключ API провайдера, его хранят в переменных окружения.

Блок не генерирует картинки — только читает их. Его ставят на холст отдельным шагом или прикрепляют к агенту.

Какой файл передавать

  • Документ, который нужен постоянно. Загрузите его один раз в Настройки → Файлы, а в блоке откройте поле «Image File» и выберите его в списке — там рядом с «Upload New File» перечислены все файлы рабочего пространства. Ни ссылка, ни ключ хранилища не нужны. Поле доступно в обоих режимах блока.
  • Разовый разбор. Загрузите файл в тест или пришлите его в чат и запустите процесс. Такой файл принадлежит своему запуску — для нового запуска загрузите его заново.
  • Если файл нужен по ссылке (например, в другом блоке): в Настройках → Файлы нажмите «Скопировать ссылку» у нужного файла. Составлять ссылку или ключ вручную нельзя — ключ выдаётся при загрузке и из имени файла не выводится.
  • Если блок отвечает «file not found». Файла по этой ссылке в хранилище больше нет. Загрузите документ заново и выберите его в блоке.
  • Куда класть ссылку. В обычном режиме блока — поле «Image File» или «Image URL». Поле «Image File Reference» работает только в расширенном режиме: подстановка, оставленная в нём при обычном режиме, теряется, и блок отвечает «Either imageUrl or imageFile is required».

PailotOCR: предупреждения и ошибки

КодЧто значитЧто делать
document_incompleteЧасть страниц распознана не полностью; в сообщении — номера страницПроверьте эти страницы в document или загрузите файл лучшего качества
document_truncated_for_answerДокумент длиннее окна pailotgpt 3: ответ построен по началу текстаВесь текст всё равно есть в document; для вопросов по длинному документу разбейте его или используйте базу знаний

Если сервис PailotOCR не настроен или недоступен, блок вернёт ошибку и не отправит документ в облачную модель. Неподходящий файл (например, видео) даёт ошибку с объяснением. Если файл по ссылке уже удалён из хранилища (например, тестовый файл давнего запуска) или к нему нет доступа, блок сообщит «file not found» — загрузите файл заново.

Инструменты

vision_tool

Чтение документа PailotOCR или разбор изображения зрительной моделью.

Вход

ПараметрТипОбязательныйОписание
apiKeystringДля облачных моделейКлюч API провайдера; для PailotOCR и pailotgpt 3 не нужен
imageUrlstringНетСсылка на изображение или документ: публичная или файл платформы из предыдущего блока (<start.pdf>)
imageFilefileНетЗагруженный файл: для PailotOCR — PDF, PNG, JPEG, WebP; для других моделей — изображение или видео
modelstringНетpailot-ocr (PailotOCR, по умолчанию), qwen3.5:9b (pailotgpt 3), gpt-4o, claude-3-opus-20240229 и др.
promptstringНетВопрос или задание к документу или изображению

Выход

ПараметрТипОписание
contentstringОтвет или описание
modelstringМодель, которой выполнен разбор (PailotOCR для документа)
tokensnumberВсего токенов на ответ
usageobjectДетальный расход токенов
↳ input_tokensnumberТокены на вход
↳ output_tokensnumberТокены на ответ
↳ total_tokensnumberСуммарный расход
documentjsonТолько PailotOCR: весь распознанный документ — страницы, блоки текста по порядку чтения, таблицы с ячейками, статус обработки
warningsarrayТолько PailotOCR: предупреждения document_incomplete и document_truncated_for_answer
На этой странице

На этой странице

Получить доступ
Копилот собирает процесс. Менеджер запускает сам. Можно поставить в контур компании.
Получить доступ