Блок Зрение читает документы и изображения и отвечает на ваш вопрос о них.
По умолчанию выбрана модель 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 или разбор изображения зрительной моделью.
Вход
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
apiKey | string | Для облачных моделей | Ключ API провайдера; для PailotOCR и pailotgpt 3 не нужен |
imageUrl | string | Нет | Ссылка на изображение или документ: публичная или файл платформы из предыдущего блока (<start.pdf>) |
imageFile | file | Нет | Загруженный файл: для PailotOCR — PDF, PNG, JPEG, WebP; для других моделей — изображение или видео |
model | string | Нет | pailot-ocr (PailotOCR, по умолчанию), qwen3.5:9b (pailotgpt 3), gpt-4o, claude-3-opus-20240229 и др. |
prompt | string | Нет | Вопрос или задание к документу или изображению |
Выход
| Параметр | Тип | Описание |
|---|---|---|
content | string | Ответ или описание |
model | string | Модель, которой выполнен разбор (PailotOCR для документа) |
tokens | number | Всего токенов на ответ |
usage | object | Детальный расход токенов |
↳ input_tokens | number | Токены на вход |
↳ output_tokens | number | Токены на ответ |
↳ total_tokens | number | Суммарный расход |
document | json | Только PailotOCR: весь распознанный документ — страницы, блоки текста по порядку чтения, таблицы с ячейками, статус обработки |
warnings | array | Только PailotOCR: предупреждения document_incomplete и document_truncated_for_answer |