Руководство по предпросмотру изображений — документация AIKraft Agents

Обзор

Блок image-preview отображает локальные файлы изображений встроено в сообщениях чата: изображение показывается в контейнере фиксированной высоты с кнопкой разворачивания для полноэкранного просмотра.

Формат	Лучше подходит для	Отображение
Блок `image-preview`	Скриншоты, захваты, визуальные различия	Встроенное вписывание в контейнер + полноэкранный просмотр
Блок `pdf-preview`	PDF-отчёты и документы	Первая страница встроено + полная навигация
Блок `html-preview`	Сложное HTML-содержимое	Изолированное отображение в iframe

Ключевой принцип: изображения уже являются файлами на диске. Ссылайтесь на них напрямую с помощью абсолютного пути в src.

Когда использовать

Используйте image-preview, если:

у вас есть локальный файл скриншота/захвата и нужен встроенный визуальный контекст;
нужны визуальные сравнения «до/после» в одном ответе;
результат инструмента сгенерировал или скачал файлы изображений;
пользователь просит посмотреть изображение непосредственно в чате.

Не используйте image-preview, если:

содержимое — PDF (pdf-preview);
содержимое — сложное HTML (html-preview);
содержимое — структурированные табличные данные (datatable/spreadsheet);
формат файла не поддерживается в Chromium (часто HEIC/HEIF/TIFF).

Базовое использование

Один элемент

terminalbash

```image-preview
{
  "src": "/абсолютный/путь/к/скриншоту.png",
  "title": "Экран настроек"
}
```

Несколько элементов (вкладки)

Используйте items, чтобы показать связанные изображения с навигацией по вкладкам.

terminalbash

```image-preview
{
  "title": "До / После",
  "items": [
    { "src": "/путь/к/до.png", "label": "До" },
    { "src": "/путь/к/после.png", "label": "После" }
  ]
}
```

Содержимое загружается лениво при переключении вкладок и кэшируется после загрузки.

Поля конфигурации

Поле	Обязательно	Тип	Описание
`src`	Да*	строка	Абсолютный путь к файлу изображения (режим одного элемента)
`title`	Нет	строка	Заголовок (по умолчанию «Предпросмотр изображения»)
`items`	Да*	массив	Массив элементов изображений с `src` и необязательным `label`
`items[].src`	Да	строка	Абсолютный путь к файлу изображения
`items[].label`	Нет	строка	Метка вкладки

^*Требуется либо src (один элемент), либо items (несколько). Если указаны оба, приоритет у items.

Поддерживаемые форматы

Предпросмотр в приложении поддерживает форматы, которые может декодировать Chromium:

PNG, JPG, JPEG, GIF, WebP, SVG, BMP, ICO, AVIF

Форматы HEIC/HEIF/TIFF могут не отображаться в приложении. Для таких файлов используйте внешнее открытие.

Поведение при отображении

Встроенный предпросмотр

Область предпросмотра фиксированной высотой 400px
Изображение отображается с object-contain (без обрезки)
Кнопка разворачивания открывает полноэкранный слой
Блоки с несколькими элементами показывают навигатор элементов в заголовке

Полноэкранный слой

Более крупный вид изображения, вписанный в контейнер
Навигация по элементам (стрелки/выпадающий список) для наборов из нескольких элементов
Действие копирования пути в заголовке
Значок пути к файлу поддерживает действия внешнего открытия и показа в проводнике

Устранение неполадок

«Загрузка...» отображается бесконечно

Убедитесь, что src — абсолютный путь
Убедитесь, что файл существует и доступен для чтения
Проверьте, что расширение файла входит в список поддерживаемых форматов

Ошибка «Не удалось загрузить»

Путь к файлу может быть недействительным или доступ может быть запрещён
Изображение может быть повреждено
Формат может не декодироваться в Chromium

HEIC/TIFF не отображается

Ожидаемое поведение во многих средах
Откройте файл во внешнем приложении с помощью действий значка пути к файлу