Коротко
Файл или ссылка: как отдать HTML-дашборд?
HTML-дашборд - это одна страница, которую агент собрал из твоей выгрузки: крупные цифры сверху, графики, подписи при наведении, выводы. Её можно отдать файлом или ссылкой, и это два разных решения.
На одном из обучений мы строили такой дашборд по реальному отчёту клиента, и готовую страницу решили отправить клиенту файлом. На занятии прозвучал ровно этот вопрос: «А я могу потом поделиться этим файлом или этой ссылкой?» Ответ был - файлом: это обычный HTML-файл, он открывается в браузере.
Со ссылкой отдельная история. Ссылка, которую агент показывает в своём окне, ведёт на файл на твоём компьютере, и у получателя она не откроется. Подробнее - в разделе про три вида ссылок ниже.
| Файл | Ссылка с паролем | |
|---|---|---|
| Кому подходит | клиенту или руководителю, который откроет на компьютере | команде, которая смотрит отчёт каждую неделю |
| Что нужно | только браузер у получателя | публикация на хостинге и вход по паролю |
| Как обновлять | собрать и отправить новый файл | загрузить свежую выгрузку на той же странице |
| Кто увидит данные | все, кому переслали файл | только те, у кого есть пароль |
| Персональные данные | только если получатель вправе их видеть | только сервер в России |
Если отчёт регулярный и пока живёт в Excel, сначала стоит связать сами данные. Как это сделать, разобрано в статье живые графики вместо картинок.
Что проверить в файле до отправки клиенту?
Отправленный файл остаётся у клиента в том виде, в каком ушёл. Поэтому проверки - до отправки.
Открой файл без интернета
Выключи Wi-Fi и открой файл двойным щелчком. Если графиков нет, скорее всего страница подтягивает библиотеку для графиков из интернета, и у клиента с медленной или закрытой сетью она не построится. Скажи агенту: «Сделай файл самодостаточным: всё, что нужно для графиков, положи внутрь, без загрузки из интернета».
Сверь две-три цифры с исходником
Возьми итог и пару строк из Excel и найди их на дашборде. На том занятии агент сам написал, что в исходном отчёте нашлась неточность в одном из итогов, и объяснил, какую цифру берёт и почему. Такое решение агента нужно прочитать и согласовать, а не пропустить.
Посмотри, что лежит внутри
HTML-файл - это текст. Цифры для графиков записаны в нём же, и любой получатель может открыть файл в блокноте. Спроси агента: «Перечисли, какие данные из выгрузки лежат внутри файла. Убери всё, что не показано на экране». Внутренние наценки, контакты и чужие строки в файле для клиента не нужны.
Дай файлу понятное имя
Агент может назвать страницу index.html. На том же занятии спросили, не будут ли все новые файлы называться одинаково. Попроси назвать файл по смыслу, например «итоги-отчёта-октябрь.html», чтобы клиент понял, что это, ещё до открытия.
Доработка одним сообщением: клики, крупные цифры, выводы
Первый вариант бывает упрощённым: например, значения на нём не нажимаются. Пересобирать с нуля не нужно, достаточно продолжить чат. Запрос, который я диктовал группе на обучении:
Я хочу, чтобы файл HTML был как управленческий дашборд с кликабельными значениями, чтобы сверху были крупные цифры, были графики с подписями данных, чтобы его можно было использовать для принятия оперативных решений.
С выводами то же самое. Если цифры нравятся, а текст нет, поправь выводы словами, как поправил бы коллегу-аналитика: «всё хорошо, но вот это надо переделать». И дальше по пунктам: какой вывод убрать, какой показатель вынести наверх, что написать для руководства клиента.
Фирменный стиль клиента агент может взять из брендбука. Положи файл брендбука в папку задачи и напиши: «Я положил брендбук, сделай дашборд в этом стиле». Как устроить папку, чтобы агент брал нужные файлы, а не соседние, разобрано в статье гигиена рабочей папки агента.
Откроется ли HTML-файл на телефоне?
На компьютере HTML-файл открывается двойным щелчком в браузере, который стоит по умолчанию. Программы ставить не нужно, вход не нужен.
С телефоном я бы ничего не обещал заранее. По отзывам пользователей на форумах, часть приложений открывает HTML-вложение во встроенном просмотре без работы скриптов, и тогда графики не рисуются. Как поведёт себя конкретный телефон получателя, проще проверить, чем угадать.
Короткая проверка до отправки:
- Отправь файл себе тем же путём, каким его получит клиент: в тот же мессенджер или на ту же почту.
- Открой его на телефоне. Если есть телефон на другой системе, открой и на нём.
- Нажми на график и на любое значение: подписи появляются?
Если всё работает - отправляй. Если графиков нет, есть два варианта. Для разового отчёта приложи рядом PDF с главным экраном: интерактив пропадёт, зато такой файл откроется почти везде. Для отчёта, который смотрят каждую неделю, удобнее ссылка, о ней дальше.
Почему ссылка из окна агента не открывается у коллеги?
Ссылки бывают трёх видов, и в окне агента они выглядят похоже.
| Что за ссылка | Как выглядит | У кого откроется |
|---|---|---|
| Путь к файлу | file:///Users/имя/MyAI/отчёт/index.html | только на твоём компьютере |
| Локальный адрес | localhost:3000 | только у тебя и только пока запущено окно агента |
| Адрес в интернете | https://название.vercel.app | у любого, у кого есть ссылка, а с паролем - у того, кто знает пароль |
Первые две удобны, чтобы посмотреть результат самому: я прошу агента всегда давать ссылку на готовый файл, чтобы открыть его одним нажатием. Отправлять их коллеге бесполезно. Что такое localhost и почему он гаснет вместе с окном, разобрано в статье локальная ссылка перестала открываться.
Как открыть дашборд команде по ссылке с паролем?
Когда дашборд нужен команде каждую неделю, файлы в общем чате быстро плодятся. На обучении прозвучал вопрос, как сделать так, чтобы отчёт не скидывать всем в чат, а чтобы он был в облаке. Решение - опубликовать его. Публикацию называют деплоем: копия страницы переезжает на сервер в интернете и получает постоянный адрес.
Задачу агенту можно поставить так, своими словами:
Кнопка обновления
«Сделай в дашборде кнопку загрузки: я загружаю новый Excel с теми же колонками, а цифры и графики обновляются». Без этой кнопки каждая новая неделя - снова разговор с агентом.
Публикация, вход и данные
«Хочу, чтобы члены моей команды заходили в этот дашборд по паролю: смотреть данные и загружать обновления. Предложи, где его опубликовать, и объясни, что нужно от меня. Если в данных или в учётных записях будут персональные данные, предложи вариант на сервере в России».
Диалог до готовности
Агент предложит площадки и попросит завести аккаунты. На занятии он на такой запрос предложил Vercel для самой страницы и Supabase для пользователей и закрытого хранилища. Это вариант для данных без персональных данных. Если в выгрузке есть данные людей, нужен российский хостинг, как в разделе ниже. Учётные записи коллег с их рабочими почтами - тоже персональные данные. Дальше отвечай на вопросы агента и проверяй каждый шаг.
Такой диалог получается длинным, и к концу агент начинает терять детали. Следи за заполнением контекста и вовремя переходи в новый чат с короткой выжимкой, как в статье гигиена контекстного окна.
Пароль закрывает вход, но не всё остальное. Чем закрытый вход отличается от приватного кода и почему «ссылку никто не знает» - не защита, разобрано в статье приватный репозиторий не закрывает сайт.
Персональные данные и чужие отчёты: где граница
Закон 152-ФЗ запрещает при сборе персональных данных граждан России, в том числе через интернет, записывать и хранить их в базах за пределами страны, исключения перечислены в самом законе (часть 5 статьи 18). Vercel и Railway подходят для страниц без персональных данных. Для отчёта, где есть клиенты, покупатели или сотрудники с контактами, нужен сервер в России, например Amvera или TimeWeb. Самый простой выход - убрать персональные данные из выгрузки ещё до сборки дашборда.
Вторая граница - чей это отчёт. Если он собран по данным клиента, отправить клиенту файл - нормально. Выложить его на хостинг, даже с паролем, - это уже решение, которое стоит согласовать.
И третья: сервисы «загрузи HTML и получи ссылку» делают файл публичным. Для черновика с выдуманными цифрами - пожалуйста. Для отчёта клиента - нет.
Подробно про хостинг, согласие и уведомление регулятора - в статье прототип собрали, что дальше.
Публикация с входом по паролю - это уже маленький проект: выбрать площадку под данные, настроить вход и обновление. Если хочешь, чтобы сотрудники делали такое сами, посмотри обучение работе с ИИ-агентами. В программе есть отдельное занятие «Публикация в интернете»: на нём выбирают сервер под задачу, хранят код в GitHub и настраивают автообновление, чтобы инструмент открывался по ссылке у тебя и у команды.
Частые вопросы
Частые вопросы
Главный вывод
Практический шаг перед следующей отправкой: отправь дашборд себе в мессенджер и открой на телефоне. Потом на компьютере выключи Wi-Fi и открой файл ещё раз. Если в обоих случаях графики на месте, его можно отдавать.