zaDojo
Вся документация

Навык SEO Report: HTML-отчёты для команды

Как навыки zaDojo отдают результат: один самодостаточный HTML-отчёт в проекте, который можно читать, печатать или открыть по ссылке. Без кредитов.

SEO Report это навык, через который другие навыки zaDojo передают свои результаты. Когда агент заканчивает аудит, подбор ключевых слов или анализ конкурента, этот навык объясняет ему, как оформить выводы в одну HTML-страницу и сохранить её в проект zaDojo. Страница появляется в разделе Reports проекта, где команда может читать её в приложении, на телефоне или на бумаге.

Смысл в том, чтобы готовая работа не терялась в ленте чата. У отчёта есть заголовок, дата, постоянная структура и место в проекте, поэтому вы и следующий агент найдёте его и через месяц.

Как им пользоваться

Чаще всего вызывать его не нужно. Попросите нужный сценарий, и отчёт придёт вместе с ним:

/zadojo:keyword-research Подбери ключевые слова для нашей страницы с ценами.

Вызвать его напрямую можно, когда нужен текст, который не покрывает ни один другой навык, например короткая сводка о работе за месяц или отчёт по одному из ваших сохранённых шаблонов:

С помощью seo-report напиши для клиента одностраничную сводку изменений позиций за этот месяц.

Что делает агент при сохранении отчёта

  1. Сначала вызывает list_reports. Если отчёт по той же теме и за тот же период уже есть, значит агент исправляет собственную работу, поэтому он заменяет этот отчёт, а не добавляет почти копию. Новый месяц, новый конкурент или другой навык дают новый отчёт.
  2. Пишет коротко. Сначала идёт вывод и что он значит для бизнеса. Каждая рекомендация говорит, что не так (с доказательствами), что изменить и что это может улучшить, включая степень уверенности агента. У цифр указано, получены ли они от инструмента или проверены вручную.
  3. Собирает одну самодостаточную страницу. Все стили внутри файла. Никаких веб-шрифтов, скриптов и картинок с других сайтов, поэтому страница везде выглядит одинаково и аккуратно печатается. Графики сделаны встроенным SVG или простыми столбиками, и рядом всегда написаны числа.
  4. Последний раздел, «How this report was made» (как сделан этот отчёт), называет навык, который его создал, ссылается на страницу этого навыка в документации и говорит, какие инструменты дали какие цифры и что агент проверил сам.
  5. Вместе со страницей save_report сохраняет короткое резюме, которое возвращает list_reports, чтобы следующая сессия могла продолжить работу, не открывая весь HTML.
  6. Ответ в чате остаётся коротким: не больше трёх пунктов (вывод, главная рекомендация и всё, что требует ваших действий), а затем ссылка.

Где найти отчёты

Откройте раздел Reports на боковой панели проекта. Заголовки отчётов называют тип отчёта или его тему и полную дату создания. В заголовке не указывается ваш собственный сайт, но указывается чужой домен, если отчёт о чужом сайте. Отчёт можно открыть на весь экран, в отдельной вкладке или распечатать в PDF.

У сохранённого отчёта нет истории версий. Когда агент исправляет отчёт, новая версия заменяет старую.

Каждый отчёт изначально виден только вашей организации. Чтобы поделиться им:

  • попросите агента: «сделай этот отчёт публичным и дай мне ссылку», или
  • откройте отчёт, нажмите Share и включите Public link.

Любой, у кого есть ссылка, может прочитать отчёт без аккаунта zaDojo. Ссылка всегда показывает последнюю сохранённую версию, а открытая по ней страница просит поисковые системы её не индексировать. Выключите переключатель, и ссылка перестанет работать (уже открытая у кого-то страница может загружаться ещё до минуты). Если снова включить общий доступ, появится новая ссылка.

Агент публикует отчёт, только когда вы прямо об этом просите. Просьба подготовить отчёт «для клиента» не делает его публичным.

Шаблоны отчётов

Шаблон это сохранённое описание вида отчёта: кто его читает, какие в нём разделы и в каком порядке, тон и подпись. Шаблонами можно управлять на странице Templates, на которую можно перейти из раздела Reports. Шаблоны принадлежат одному проекту. Чтобы использовать шаблон в другом проекте, попросите агента найти его в первом проекте и сохранить копию во втором.

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

Сколько это стоит

Ничего. Написание, сохранение, просмотр списка и публикация отчётов не расходуют кредиты. Исследование, которое входит в отчёт, оплачивается навыком, который его проводит.

Советы

  • Просите задачу, а не формат. «Проведи аудит example.com» даст отчёт без отдельной просьбы.
  • Скажите, для кого отчёт. Агент укажет автора и подстроит язык под читателя.
  • Если отчёт нужно исправить, попросите агента его поправить. Он обновит тот же отчёт, а не создаст второй.
  • Агенты правят отчёт по его сохранённому резюме, потому что полный HTML длинного отчёта может быть слишком большим, чтобы прочитать его обратно. Для крупных изменений старого отчёта часто проще перезапустить навык.

Исходный код

SKILL.md, включая стартовый HTML-шаблон, на котором строится каждый отчёт:

Навыки, которые отчитываются через него