Медиалогия

Приложение Медиалогия подключает API мониторинга СМИ и соцмедиа. Агент работает с темами мониторинга по номеру отчёта: читает публикации и метрики, строит динамику и разрезы, преобразует поисковые формулировки и после подтверждения создаёт или изменяет темы.

Что важно знать

API Медиалогии не предоставляет список всех тем или отчётов аккаунта. Для чтения нужен номер отчёта, который уже создан в Медиалогии или получен после create_report. Сценарий «посмотреть упоминания» без номера должен начинаться с уточнения этого номера, а новая тема — с подготовки и создания отчёта.

Подключение

1. Запросите у менеджера Медиалогии логин и пароль именно для API мониторинга. Они могут отличаться от входа на сайт Медиалогии.
2. В Promto откройте приложение Медиалогия и нажмите Подключить.
3. Введите API-логин и API-пароль.
4. Дождитесь безопасной проверки через преобразование тестового поискового выражения.

Подключать и отключать интеграцию может только владелец рабочего пространства. Данные входа используются сервером в запросах к SOAP API и не передаются агенту. В настройках отображаются логин и маска пароля.

Интерфейс приложения

На главном экране доступны сценарии:

• Сводка упоминаний — публикации выбранного отчёта за период;
• Динамика и объекты — статистика по датам и объектам;
• Преобразовать запрос — перевод обычной формулировки в язык поиска Медиалогии;
• Создать тему мониторинга — создание отчёта после проверки запроса;
• Подключение — ввод API-доступа.

Карточка сценария прикрепляет промпт к чату. Данные отчёта и публикации появляются в чате, а не отдельной таблицей приложения.

Работа с агентом

Основной агент использует инструмент promto_medialogia. Это встроенный инструмент чата, а не команда терминала.

Область	Действия инструмента
Отчёт	get_report
Публикации	list_posts, list_posts_sorted, list_posts_since
Аналитика	stats_by_date, stats_by_object, get_post_metrics
Поисковый язык	convert_query, validate_blog_urls
Управление темами	create_report, create_report_by_urls, update_report, create_report_history, delete_report

Тональность берите из исходного поля Tonality: её определяет Медиалогия. Интеграция может добавить понятную подпись, но исходное числовое значение сохраняется и не пересчитывается агентом.

Практические сценарии

Сводка по теме

Передайте номер отчёта и точный период. Агент читает тему через get_report, затем постранично собирает публикации. API не сообщает надёжное общее число и курсор, поэтому выборка продолжается, пока очередная страница не станет короче заданного размера.

Динамика и ключевые источники

Агент вызывает stats_by_date и stats_by_object, а для важных публикаций — get_post_metrics. У итоговой сводки должны быть явно указаны номер отчёта и фактически обработанный интервал.

Создать тему

Сначала обычная формулировка проходит через convert_query. Агент показывает получившийся язык запроса, название и параметры темы. Только после согласия вызывается create_report с params.confirm=true.

Обновить или удалить тему

Перед update_report агент читает текущую конфигурацию: новый запрос заменяет старый целиком. delete_report удаляет не только тему, но и всю историю её публикаций; восстановить её через API нельзя.

Ограничения и безопасность

• Без номера отчёта прочитать существующую тему нельзя: метода списка отчётов в API нет.
• Общая вовлечённость или потенциальный охват не приходят готовой универсальной метрикой; агрегируйте их из полей отдельных публикаций и объясняйте формулу.
• Не смешивайте СМИ и соцмедиа без явной группировки по типу источника.
• create_report, create_report_by_urls, update_report, create_report_history и delete_report требуют подтверждения.
• Догрузка истории может тарифицироваться отдельно.
• update_report заменяет параметры целиком, а delete_report необратимо удаляет историю.
• Не передавайте API-пароль в чат, проект или промпт.

Если не работает

Симптом	Что проверить
Вход на сайт работает, API — нет	Используются ли отдельные данные API, выданные менеджером
Агент не видит темы	Передать номер отчёта; API не умеет перечислять все темы
Не все публикации	Продолжить постраничное чтение до короткой страницы и указать период
Запрос темы отклонён	Сначала выполнить convert_query и использовать полученное выражение
Странная тональность	Показать исходное Tonality, не заменяя его самостоятельной оценкой
Изменение не запускается	Проверить полный набор параметров и явное подтверждение

Связанные материалы

• Настройки рабочего пространства
• Файлы — сохранение выгрузки публикаций
• Как получать лучший результат

Готовый промпт

Через promto_medialogia собери публикации отчёта <REPORT_ID> за <ПЕРИОД>. Сначала прочитай get_report, затем проходи страницы до короткой страницы. Покажи фактический интервал, источники и исходную Tonality; не пересчитывай тональность самостоятельно. Ничего в настройках темы не меняй.