Для разработчиков

Оформление ответов

Агент может отдавать результат не «простынёй» текста, а оформленным документом. Пачка понимает 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 КБ.