Оформление ответов
Агент может отдавать результат не «простынёй» текста, а оформленным документом. Пачка понимает Markdown и в сообщениях, и в прикреплённых .md-файлах, а вложенные .html показывает просмотром прямо в переписке. Отдельная интеграция для этого не нужна.
Markdown в сообщениях
Текст сообщений — Markdown. Жирный, курсив, зачёркивание, ссылки, упоминания, строчный код и блоки кода работают сразу — агенту достаточно прислать обычный Markdown в тексте сообщения. Списки и таблицы в тексте сообщения не распознаются и остаются обычным текстом вместе с маркерами, у цитаты остаётся текст без символа >, а заголовок превращается в жирную строку без решёток. Если нужна настоящая структура, прикрепляйте .md-файл (см. ниже). Полный список поддерживаемых конструкций — в разделе Форматирование текста.
Разметка передаётся в поле content метода POSTНовое сообщение как есть — отдельный флаг включать не нужно, текст всегда интерпретируется как Markdown. Те же правила действуют в методе PUTРедактирование сообщения.
Сообщение с Markdown и .md-файл карточкой
Файл md рендерится карточкой
Если бот прикрепляет к сообщению .md-файл, Пачка показывает его не ссылкой на скачивание, а оформленной карточкой прямо в чате с разворотом в полноэкранный просмотр. Карточка появляется, когда .md — единственный документ сообщения, а среди нескольких файлов он открывается тем же просмотром по нажатию. Поддерживается:
- заголовки, списки, цитаты, ссылки, изображения
- таблицы и чек-листы задач
- блоки кода с подсветкой синтаксиса
- блоки
diffс подсветкой добавленных и удалённых строк - диаграммы
mermaid
Всё, что присылает бот, рендерится так же, как контент от сотрудников. Специального режима для агентов не требуется.
Загрузите .md и прикрепите его к сообщению в три шага по схеме из раздела Файлы. В поле files метода POSTНовое сообщение передаются ключ файла, name и file_type. Расширение .md в имени файла включает рендер карточкой автоматически. Через MCP-сервер небольшой .md передаётся содержимым в том же вызове, подробнее — в разделе Как агент отправляет файл. В CLI загрузку делает одна команда, подробнее — в разделе Файлы.
Полноэкранный просмотр .md-файла
В веб-версии и десктопном приложении свой .md-файл автор сообщения открывает не просмотром, а редактором, где файл можно поправить и сохранить. Пачка заменяет файл в сообщении новой версией, а текст сообщения не меняется. Так сотрудник правит отчёт, который агент отправил от его имени через MCP-сервер или с персональным токеном. Файл из сообщения бота все открывают просмотром.
Файлы html, txt и json показываются в просмотре
Кроме .md Пачка показывает вложенные .html, .htm, .txt и .json: в карточке файла появляется миниатюра документа, а по клику он открывается на весь экран. Миниатюра появляется, когда файл — единственный документ сообщения, а среди нескольких файлов он открывается тем же просмотром по нажатию. Чтобы миниатюра .html появилась сразу, при отправке по ключу передайте в files поле size. Файлы .txt и .json показываются как есть, без оформления: так удобно отдать выгрузку или лог. А .html — это способ отдать результат со своей вёрсткой: дашборд, отчёт с таблицами, макет письма.
HTML-документ открывается в изолированном фрейме, поэтому собирать его нужно самодостаточным:
- Скрипты не выполняются. Страница показывается статической.
- Внешние ресурсы не загружаются. Картинки, шрифты и таблицы стилей с чужих адресов не подтянутся: изображения вшивайте в документ как
data:-URI, а стили держите в тегеstyleили в одноимённом атрибуте. Шрифты и видео не загружаются даже вшитыми в документ, поэтому используйте системные шрифты. - Формы вырезаются. Вместе с ними вырезаются теги
link,base,metaиarea. - Ссылки остаются только
httpsи якорные. Первые открываются в новой вкладке, вторые ведут внутрь документа, аhttp,mailtoи относительные пути перестают быть ссылками.
В веб-версии и десктопном приложении тему Пачки документ получает атрибутом data-pachca-theme со значением dark или light у тега html, поэтому стили для тёмной темы можно задать селектором html[data-pachca-theme="dark"].
Если из документа что-то вырезали, над просмотром появляется пометка, что превью может отличаться от оригинала.
Возможности и кейсы
- Отчёты и сводки — агент собирает данные и присылает структурированный отчёт с таблицами вместо стены текста
- Код-ревью и диффы — агент прикладывает
.mdс блокамиdiff, изменения видны зелёным и красным - Спецификации и заметки встреч — оформленный документ в треде, обсуждение рядом
- Диаграммы — последовательности и схемы через
mermaidпрямо в карточке - Своя вёрстка — если нужен точный вид, агент прикладывает
.htmlс вшитыми картинками и стилями внутри документа
Ограничения
- Длина сообщения. Предел текста сообщения — в разделе Длина текста. Длинный результат присылайте файлом
.md. - Размер файла для просмотра. Карточка
.mdи миниатюра.html,.txtи.jsonпоявляются у файлов до 150 КБ. На весь экран.md,.txtи.jsonоткрываются до 1 МБ, а.htmlдо 2 МБ. Файл крупнее Пачка предлагает скачать. Отчёт, который должен показаться карточкой, держите в пределах 150 КБ.