# Использование ИИ-агентов для SEO/GEO/AEO-оптимизации базы знаний
Начиная с версии v6.1.0 в Swarmica можно создать ИИ-агента с компетенцией **SEO/GEO/AEO-оптимизация**. Агент автоматически заполняет SEO-поля и разметку JSON-LD опубликованных статей, чтобы поисковые системы и ИИ-сервисы корректно находили и ранжировали базу знаний.

## Что делает ИИ-агент

Агент работает с опубликованными статьями и для каждого языка статьи, у которого есть заголовок и текст, заполняет пустые поля:

*   `seo_title` — заголовок для поисковой выдачи и превью;
*   `seo_description` — описание до 160 символов;
*   `seo_url` — относительный адрес статьи;
*   `seo_image` — первое изображение, загруженное в статью (если оно есть);
*   `seo_keywords` — от 3 до 7 ключевых слов;
*   `seo_type` — `article`;
*   `seo_locale` — например, `ru_RU`, `en_US`;
*   `jsonld` — разметка Schema.org типа `TechArticle`.

Агент работает по следующим правилам:

*   не изменяет заголовок и текст статьи;
*   не перезаписывает уже заполненные поля — их мог заполнить сотрудник;
*   не использует внутреннюю часть статьи;
*   не заполняет поле `html_head`;
*   опирается только на содержимое статьи и не добавляет факты от себя.

Описание всех SEO-полей — в статье [Настройка SEO-полей статьи](https://support.swarmica.com/article/ru/2146).

## Требования

1.  Swarmica версии v6.1.0 или выше.
2.  Включён фича-флаг `__ai_mcp_agents` — см. [Фича-флаги FEATURES](https://support.swarmica.com/article/ru/596).
3.  Подключён ИИ-провайдер, поддерживающий ИИ-агентов: [YandexGPT](https://support.swarmica.com/article/ru/1675) или [ChatGPT](https://support.swarmica.com/article/ru/1676). Актуальный список — в статье [Возможности различных ИИ-провайдеров LLM в Swarmica](https://support.swarmica.com/article/ru/1615).
4.  Запущен сервис MCP — см. [Подключение функций Swarmica к LLM с помощью MCP](https://support.swarmica.com/article/ru/1664).
5.  Права администратора.

## Создание ИИ-агента

1.  Перейдите в **Настройки → ИИ-функции → ИИ-агенты** и нажмите **Создать**.
2.  Выберите компетенцию **SEO/GEO/AEO-оптимизация**.
3.  Укажите имя агента — оно будет отображаться в интерфейсе.
4.  Сохраните агента.

Пользователь агента и необходимые доступы создаются автоматически.

## Автоматический запуск

Раз в сутки Swarmica автоматически запускает агента для опубликованных статей, у которых не заполнено хотя бы одно из полей `seo_title`, `seo_description`, `seo_url`, `seo_keywords`, `seo_type`, `seo_locale` или `jsonld`. После заполнения полей статья больше не попадает в очередь агента.

:::tip
Каждый запуск агента расходует токены ИИ-провайдера. Если в базе знаний много статей без SEO-полей, первичная обработка займёт несколько дней.
:::

## Ручной запуск для конкретной статьи

1.  Перейдите в **Настройки → ИИ-функции → ИИ-агенты** и откройте нужного агента.
2.  Введите задание, например: `Оптимизируй статью 1234`.
3.  Нажмите **Запустить**.

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

## Проверка результата

*   Откройте вкладку **SEO** статьи и убедитесь, что поля заполнены корректно. Любое поле можно отредактировать вручную — агент не перезапишет его.
*   Проверьте разметку JSON-LD в инструментах проверки — см. [Настройка разметки Schema.org в статьях](https://support.swarmica.com/article/ru/2147).
*   При [проверке качества контента](https://support.swarmica.com/article/ru/214) (AQI) рекомендуется обращать внимание на заполненность и корректность SEO-полей.

## Связанные статьи

*   [Настройка SEO-полей статьи (Open Graph, JSON-LD)](https://support.swarmica.com/article/ru/2146)
*   [Настройка разметки Schema.org в статьях (JSON-LD, микроразметка)](https://support.swarmica.com/article/ru/2147)
*   [Карта сайта sitemap.xml и robots.txt публичной базы знаний](https://support.swarmica.com/article/ru/2149)
*   [Включение индексации публичного портала базы знаний для LLM (llms.txt)](https://support.swarmica.com/article/ru/1483)