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

Агент может отдавать результат не «простынёй» текста, а оформленным документом. Пачка понимает Markdown и в сообщениях, и в прикреплённых .md-файлах, а вложенные .html показывает просмотром прямо в переписке. Отдельная интеграция для этого не нужна.

Markdown в сообщениях

Текст сообщений — Markdown. Жирный, курсив, зачёркивание, ссылки, упоминания, инлайн-код и блоки кода работают сразу — агенту достаточно прислать обычный Markdown в тексте сообщения. Списки, цитаты и таблицы в тексте сообщения не распознаются и остаются обычным текстом, а заголовок превращается в жирную строку без решёток. Если нужна настоящая структура, прикрепляйте .md-файл (см. ниже). Полный список поддерживаемых конструкций — в разделе Форматирование текста.

Разметка передаётся в поле content метода POSTНовое сообщение как есть — отдельный флаг включать не нужно, текст всегда интерпретируется как Markdown. Те же правила действуют в методе PUTРедактирование сообщения.

Файл md рендерится карточкой

Если бот прикрепляет к сообщению .md-файл, Пачка показывает его не ссылкой на скачивание, а оформленной карточкой прямо в чате с разворотом в полноэкранный просмотр. Поддерживается:

• заголовки, списки, цитаты, ссылки, изображения
• таблицы и чек-листы задач
• блоки кода с подсветкой синтаксиса
• блоки diff с подсветкой добавленных и удалённых строк
• диаграммы mermaid

Всё, что присылает бот, рендерится так же, как контент от сотрудников. Специального режима для агентов не требуется.

Загрузите .md по схеме Загрузка файлов (три шага через presigned S3), затем передайте полученный ключ файла в поле files при вызове POSTНовое сообщение. Расширение .md в имени файла включает рендер карточкой автоматически.

Файлы html и txt показываются в просмотре

Кроме .md Пачка показывает вложенные .html, .htm и .txt: в карточке файла появляется миниатюра документа, а по клику он открывается на весь экран. Для .txt этим всё и ограничивается — файл показывается как есть, без оформления. А .html — это способ отдать результат со своей вёрсткой: дашборд, отчёт с таблицами, макет письма.

HTML-документ открывается в изолированном фрейме, поэтому собирать его нужно самодостаточным:

• Скрипты не выполняются — страница показывается статической
• Внешние ресурсы не загружаются. Картинки, шрифты и таблицы стилей с чужих адресов не подтянутся: изображения вшивайте в документ как data:-URI, а стили держите в теге style или в одноимённом атрибуте
• Формы вырезаются вместе с тегами link, base, meta и area
• Ссылки остаются только https и якорные. Первые открываются в новой вкладке, вторые ведут внутрь документа, а http, mailto и относительные пути перестают быть ссылками

Если из документа что-то вырезали, над просмотром появляется пометка, что превью может отличаться от оригинала.

Возможности и кейсы

• Отчёты и сводки — агент собирает данные и присылает структурированный отчёт с таблицами вместо стены текста
• Код-ревью и диффы — агент прикладывает .md с блоками diff, изменения видны зелёным и красным
• Спецификации и заметки встреч — оформленный документ в треде, обсуждение рядом
• Диаграммы — последовательности и схемы через mermaid прямо в карточке
• Своя вёрстка — если нужен точный вид, агент прикладывает .html с вшитыми картинками и инлайн-стилями

Ограничения

• Текст сообщения — до 40 000 байт Markdown, это около 20 000 символов кириллицы
• Предпросмотр .md и .html рассчитан на типовой размер документа. Очень крупные файлы открываются как обычное вложение для скачивания.