Markdown для агентов

Обзор

Markdown для агентов создает удобные для AI markdown-версии опубликованного контента. Модуль полезен командам, которым нужен более чистый markdown-вывод для AI-краулеров, агентных сценариев и экспорта базы знаний.

Путь в админке: Airygen SEO -> Настройки -> Markdown для агентов.

Модуль позволяет управлять markdown-выводом, выбирать типы записей для экспорта, пересобирать снапшоты, проверять предпросмотр по ID записи и добавлять подсказки для агентов на уровне отдельной записи прямо в редакторе.

Настройки

Страница разделена на вкладки Настройки, Снапшоты и Предпросмотр.

Вкладка Настройки

• Включить вывод Markdown включает или отключает экспорт markdown.
• Промпты для агентов добавляет в редактор панель, где можно сохранить описания, инструкции и промпты для LLM-агентов.
• Включить YAML front matter добавляет в начало markdown метаданные, такие как заголовок, автор, дата публикации, canonical URL и ключевая фраза.
• Типы записей для включения определяет, какие типы контента будут экспортироваться в markdown.

Вкладка Снапшоты

• Пересоздать заново генерирует markdown-снапшоты в фоновом режиме.
• Фильтр типа записи сужает таблицу снапшотов до выбранного типа записи из области охвата.
• Таблица снапшотов показывает столбцы ID записи, Заголовок, Тип записи и Последняя синхронизация.
• Действие Просмотр открывает markdown-версию выбранной записи.
• Элементы пагинации помогают переходить между страницами снапшотов.

Вкладка Предпросмотр

• Поле ID записи позволяет загрузить markdown-предпросмотр для конкретной опубликованной записи.
• Кнопка Предпросмотр запускает проверку с текущими настройками модуля.
• Область Вывод показывает сгенерированный markdown в режиме только для чтения.

Панель редактора

Когда включен параметр Промпты для агентов, в редакторе появляется поле Промпты для агентов для каждой записи.

• Используйте это поле, чтобы добавлять описания, инструкции и промпты для LLM-агентов.
• Эта панель особенно полезна, когда странице нужен дополнительный контекст помимо обычного видимого контента.

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

1. Откройте Airygen SEO -> Настройки -> Markdown для агентов.
2. Включите Включить вывод Markdown, чтобы модуль начал создавать markdown-версии контента.
3. Решите, нужна ли вашей команде панель Промпты для агентов в редакторе, и включите её только при необходимости.
4. Включите Включить YAML front matter, если хотите добавлять в экспорт служебные метаданные в начале файла.
5. В поле Типы записей для включения выберите те типы контента, для которых должен быть доступен markdown-экспорт.
6. Откройте вкладку Снапшоты и нажмите Пересоздать, если хотите сразу пересобрать markdown для уже опубликованных материалов.
7. Используйте Фильтр типа записи и таблицу снапшотов, чтобы проверить, для каких материалов экспорт уже создан и когда он обновлялся в последний раз.
8. Перейдите во вкладку Предпросмотр, введите опубликованный ID записи и нажмите Предпросмотр, чтобы проверить итоговый markdown до живой публикации.
9. Если вы включили Промпты для агентов, откройте нужную запись в редакторе и добавьте в поле Промпты для агентов инструкции, которые должны сопровождать именно эту страницу.
10. Откройте снапшот через Просмотр или добавьте ?format=md к URL поддерживаемой записи, чтобы подтвердить публичный markdown-вывод.

Проверьте эти пункты после сохранения:

• Markdown-вывод включён только для тех типов записей, которые вы действительно хотите открывать для такого формата.
• Блок front matter появляется только тогда, когда включен параметр Включить YAML front matter.
• После пересоздания в снапшотах отображается актуальное время синхронизации.
• В markdown-вывод попадают только те подсказки для агентов, которые вы намеренно добавили.

Преимущества SEO

Этот модуль не меняет позиции напрямую, но помогает выпускать более чистую машиночитаемую версию контента. Благодаря этому AI-ориентированные и markdown-сценарии становятся более последовательными, а поддержка экспортов и повторного использования контента упрощается.

Сценарии использования

Команды, публикующие базу знаний для AI-систем

До: Компания хочет, чтобы документацию было проще использовать в AI-инструментах, но обычный HTML-вывод содержит лишние элементы страницы и не очень удобен для markdown-процессов.

После: Markdown для агентов дает более чистую markdown-версию, которую проще проверять, экспортировать и использовать повторно.

Агентства, которым нужны инструкции для каждой страницы

До: Для части страниц нужен дополнительный контекст для AI-агентов, но в обычном редакционном процессе нет отдельного места для таких указаний.

После: Панель Промпты для агентов позволяет добавлять инструкции для конкретной страницы без переписывания видимого текста статьи.

Часто задаваемые вопросы

Меняет ли этот модуль обычную HTML-страницу, которую видят посетители?

Нет. Он добавляет markdown-вывод для поддерживаемых сценариев, но не заменяет обычное отображение страницы.

Что добавляет параметр Включить YAML front matter?

Он добавляет в начало файла метаданные, такие как заголовок, автор, дата публикации, canonical URL и сведения о ключевой фразе.

Можно ли проверить одну запись до включения полного рабочего процесса?

Да. Используйте вкладку Предпросмотр, укажите опубликованный ID записи и проверьте сгенерированный markdown до расширения процесса на другие материалы.

Обязательно ли включать Промпты для агентов, чтобы использовать markdown-экспорт?

Нет. Markdown-экспорт работает и без этой панели, а Промпты для агентов нужны только тогда, когда вы хотите добавлять отдельные инструкции для LLM-агентов на уровне записи.