Руководство пользователя

Агенты и режимы

Руководство

Агент — это настроенный конвейер: группа каналов-источников, режим обработки и правила или инструкции, определяющие, что попадёт в ваш Backstage. Krabli может одновременно запускать несколько агентов — каждый с разными источниками, режимом и редакционной задачей.

Одно и то же вымышленное сообщение о перекрытии дороги показано в трёх режимах потока. Relay применяет ваши правила без ИИ и передаёт пост. Filter с помощью ИИ проверяет соответствие теме: «Да» — исходный пост идёт на просмотр; «Нет» — пост отброшен. Editor с помощью ИИ отбирает и переписывает пост по вашим инструкциям. Оставленные посты поступают в Backstage на просмотр; режим не означает публикацию.
Открыть схему в полном размере
Описание схемы

Одно и то же вымышленное сообщение о перекрытии дороги показано в трёх режимах потока. Relay применяет ваши правила без ИИ и передаёт пост. Filter с помощью ИИ проверяет соответствие теме: «Да» — исходный пост идёт на просмотр; «Нет» — пост отброшен. Editor с помощью ИИ отбирает и переписывает пост по вашим инструкциям. Оставленные посты поступают в Backstage на просмотр; режим не означает публикацию.


Язык рабочего пространства

В верхней части страницы Агенты находится карточка Язык. Это единственная языковая настройка для всего рабочего пространства — она определяет:

  • На каком языке агенты пишут посты (в режиме Editor)
  • Исходный язык, с которого зонтичные каналы делают переводы

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

Отдельный язык для каждого агента не поддерживается. Если вам нужен контент на двух языках, используйте зонтичные каналы — они автоматически переводят выходной поток на дополнительные языки.

Язык, который уже занят одним из зонтичных каналов, нельзя выбрать в качестве языка рабочего пространства (это означало бы перевод с и на один и тот же язык). Сначала удалите конфликтующий зонтичный канал.


Три режима

Relay — без AI, на основе правил

Режим Relay пропускает всё, что соответствует вашим правилам. AI не задействован. Работает быстро и не требует дополнительных расходов (кроме подписки на Krabli) и AI-ключа.

Доступные правила:

  • Фильтры по ключевым словам — пропускать только посты, содержащие (или не содержащие) определённые слова
  • Медиафильтры — пропускать только посты с фото, видео или без медиа
  • Правила на уровне источника — обрабатывать разные источники по-разному в рамках одного агента

Подходит для: Высокочастотных источников с чёткими предсказуемыми критериями. Ленты срочных новостей, официальные каналы ведомств, спортивные результаты.

Filter — AI-фильтр релевантности

Режим Filter использует AI для чтения каждого поста и ответа на ваш вопрос «да/нет». Прошедшие посты идут в Backstage, отклонённые — в dropped-канал.

При настройке агента Filter вы пишете вопрос-фильтр, например:

  • «Касается ли этот пост общественного транспорта Тель-Авива?»
  • «Анонсирует ли пост запуск продукта крупной технологической компанией?»
  • «Будет ли это интересно владельцам малого бизнеса в России?»

AI отвечает «да» или «нет». Перепись постов не происходит — только фильтрация. За счёт этого Filter значительно дешевле Editor.

Требует AI-ключ OpenRouter.

Подходит для: Источников, где полезные и нерелевантные посты смешаны, и нужен умный фильтр — но переписывать посты не нужно.

Editor — полноценный AI с инструкциями

Режим Editor использует AI для чтения, отбора и переписи постов в соответствии с вашими инструкциями. Каждый прошедший пост переписывается в вашем стиле и голосе — и только потом попадает в Backstage.

При настройке агента Editor вы пишете редакционный устав — набор инструкций, объясняющих AI, какие темы освещать, как писать, что включать и исключать.

Пример фрагмента устава:

«Освещай только посты о велосипедной инфраструктуре в европейских городах. Пиши нейтрально и фактологично. Переводи на русский, если оригинал на другом языке. Объём — не более 200 слов. Упоминай город и страну в первом предложении.»

Требует AI-ключ OpenRouter.

Подходит для: Кураторских каналов, где важны качество и авторский голос. Тематические дайджесты, переводные ленты, нишевые рассылки.


Сравнение режимов

RelayFilterEditor
Нужен AIНетДаДа
Перепись постовНетНетДа
СтоимостьНетНизкаяВыше
Трудоёмкость настройкиНизкаяСредняяВыше
Качество выводаИсходныйОтфильтрованныйКураторский
Подходит дляБольшой объём, точные правилаСмешанные источники, умный фильтрАвторский канал

Создание агента

  1. На странице Агенты нажмите Новый агент.
  2. Дайте название — что-то понятное («Новости города», «Ежедневный техдайджест»).
  3. Выберите источники — из каналов, на которые вы подписались.
  4. Выберите режим — Relay, Filter или Editor.
  5. Напишите правила или инструкции — ключевые слова и медиафильтры для Relay; вопрос-фильтр для Filter; редакционный устав для Editor.
  6. Нажмите Сохранить.

Агент сохраняется в состоянии на паузе. Перед запуском проведите тестовый прогон.


Тестовый прогон

Перед запуском агента нажмите Тест на реальных постах на его странице. Krabli возьмёт последние посты из каналов-источников и прогонит их через режим и правила агента.

Вы увидите:

  • Какие посты попали бы в Backstage
  • Какие были бы отклонены и почему
  • Переписанную версию (в режиме Editor)

Тест использует AI-ключ (в режимах Filter и Editor), но ничего не записывает: посты в Backstage не поступают, ничего не публикуется. Скорректируйте вопрос или устав и запустите снова.

Что тест не проверяет
Тест не применяет дневной лимит публикаций, не убирает повторяющиеся тексты и не сохраняет богатое форматирование. В реальной работе всё это функционирует — просто не входит в тест.


Запуск и пауза

На странице агента нажмите Запустить. Посты из источников начнут поступать в Backstage по мере появления.

Чтобы поставить агента на паузу, нажмите Пауза. Новые посты не будут доставляться. Имеющиеся предложения в Backstage остаются — они никуда не исчезают.


Редактирование агента

Откройте агента и нажмите Редактировать. Изменения в правилах, источниках или инструкциях применяются немедленно для новых постов. Уже доставленные предложения в Backstage не затрагиваются.

Сменить режим агента (например, с Filter на Editor) можно через редактор контракта. Для этого агент нужно сначала поставить на паузу.


Редактор контракта

Настройки каждого агента хранятся в виде версионированного YAML-контракта. Для большинства пользователей стандартной формы достаточно. Для тонкой настройки нажмите Дополнительно — откроется редактор контракта.

В редакторе доступны:

  • Форма настроек — все параметры контракта в сгруппированном виде с подписями
  • YAML-режим — контракт в виде текста для точного редактирования
  • История — список всех сохранённых версий с просмотром изменений
  • Откат — восстановление любой предыдущей версии (Krabli объяснит, что именно изменится, до подтверждения)

Каждое сохранение создаёт новую версию — ничего не перезаписывается. Если изменение ухудшило результаты, всегда можно откатиться назад.

Что можно изменять: источники, правила, вопрос-фильтр, инструкции, форматирование постов, пороги и чувствительность, автоматические отклонения, работа с медиа.

Что заблокировано: режим (Relay/Filter/Editor), конфигурация моделей и провайдеров, дневной бюджет токенов и некоторые системные настройки. Их может изменять только команда Krabli.


Удаление агента

Откройте агента → нажмите Удалить. Удаление не затрагивает каналы-источники (они остаются в подписках) и настройки каналов (Backstage, главный, dropped). Предложения из этого агента, уже находящиеся в Backstage, остаются там.

Удаление необратимо.