Перейти к содержимому
CleroСправочный центр

Поиск по документации

Введите тему или задачу

↑ ↓ Выбор результата · Enter Открыть · Esc Закрыть

English
Русский · Черновик
Предварительная документацияЧерновик для проверки · Русский

Выбор каналов или триггеров

Подключите постоянный разговор или задайте процесс для подходящих входящих событий.

Проверено частично Основания и ограничения

Селектор Add Channel и интерфейс рабочих процессов просмотрены; настройка, маршрутизация, разрешения и жизненный цикл каналов и триггеров подтверждены кодовой базой. Это черновик руководства; проверяйте права доступа и сохранённые результаты в текущем рабочем пространстве.

На этой странице

Канал проекта — точка обмена сообщениями, направляемыми назначенному агенту проекта. Триггер определяет работу, которая запускается, когда подходящие входные данные соответствуют его настройкам.

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

Концептуальное сравнение маршрутизации каналов проекта, процессов с событийными триггерами и повторяемой работы по расписанию.Концептуальная иллюстрация, а не интерфейс продукта. Область входных данных, разрешения агента и место назначения результата настраиваются отдельно; каналу проекта не требуется триггер.Увеличить ↗

Сравните механизмы

МеханизмЧто делаетПример
Канал проектаНаправляет сообщения назначенному руководителю проекта (PM) или агенту командыЗадавать вопросы о проекте из выбранного группового разговора
ТриггерПрименяет настроенные инструкции или шаги процесса к подходящим входным даннымКлассифицировать каждый запрос в поддержку и добавить строку в таблицу учёта
Повторяющееся расписаниеЗапускает повторяемую работу по времениПроверять блокеры каждый будний день
Разовая задача по расписаниюЗапускает одно конкретное действие в будущемПроверить контрольный список запуска в выбранную дату

Каналу не требуется триггер. Создание одного не должно незаметно создавать другой. Триггер также может сохранять контекст разговора; различие состоит в маршрутизации и заданном рабочем процессе, а не в «наличии памяти» и «отсутствии памяти».

Подключение — только первый уровень

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

Само по себе подключение бота или вебхука не доказывает, что конкретная группа связана с проектом или что триггер существует. Исходящее сообщение от бота не доказывает, что входящее сообщение получено и обработано.

В работающем демонстрационном интерфейсе путь Data → New resource → Add existing → Channel (Данные → Новый ресурс → Добавить существующий → Канал) открывал селектор, но канал не был добавлен.

Селектор Add Channel (Добавить канал) при добавлении ресурса проекта.Фрагмент снимка экранаПросмотрен только селектор. Подключение сервиса, добавление канала, входящее сообщение и ответ не проверялись.Увеличить ↗

Попросите агента подключить разговор к проекту

Из нужного проекта укажите учётную запись, точный чат, обработчика и разрешённое поведение:

Подключи только нашу группу Product updates (Обновления продукта) из выбранного подключения Telegram как канал этого проекта. Пусть руководитель проекта получает сообщения и отвечает там. Не включай другие группы или личные сообщения и не создавай процесс с триггером.

Текущий инструмент настройки, подтверждённый кодовой базой, — configure_current_project_channel. Он создаёт или обновляет видимый ресурс проекта Channel (Канал) и его маршрутизацию. Обработчик нового канала по умолчанию — руководитель проекта; вместо него можно выбрать подходящего действующего агента команды.

Просмотренная реализация прямой настройки поддерживает Telegram, MAX, LINE и AgentMail с типами целевых объектов и требованиями подтверждения владения, специфичными для каждого сервиса. Это не подтверждает, что каждый перечисленный сервис включён для вашей учётной записи или что другой сервис использует ту же процедуру.

Если нужный чат недоступен, следуйте инструкциям продукта по подключению или подтверждению владения. Не вставляйте токены бота в чат и не расширяйте запрос на одну группу до всех групп ради завершения настройки. Проверьте выбранный объект и сохранённый маршрут перед контролируемым тестом входящего сообщения.

Измените обработчика или разрешённое направление

Можно попросить:

Переключи Product updates (Обновления продукта) на агента Research (Исследования), сохранив существующий канал и разговоры. Подтверди нового обработчика.

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

Режимы доступа канала имеют конкретные значения:

  • Both (В обоих направлениях): получать входящие сообщения и отправлять ответы.
  • Read only (Только чтение): получать сообщения и вызывать назначенного агента, но не публиковать сообщения.
  • Write only (Только запись): разрешать публикацию; входящие сообщения не вызывают агента и не становятся доступным для чтения контекстом канала через этот маршрут.

Read only (Только чтение) не приостанавливает работу. Запросите нужное поведение и проверьте сохранённый режим.

Запросите процесс с триггером

Откройте проект и опишите входные данные и повторяемую процедуру:

Создай приостановленный триггер Support intake (Приём обращений) только для новых сообщений в выбранном ящике поддержки. Пусть агент поддержки классифицирует каждый запрос, добавляет строку в таблицу поддержки и готовит черновик ответа для проверки. Не отправляй ответ автоматически. До активации покажи сохранённого агента, область источников, инструкции и неактивное состояние.

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

Путь через агента использует create_automation_trigger; для последующего управления есть инструменты получения списка, обновления и удаления. Триггеру нужны подходящий назначенный агент и проект. Политики каналов триггера выбирают источники, которые могут его запускать; сами эти политики не являются отдельным ресурсом проекта Channel (Канал).

Разделяйте получение, чтение и ответы

У политик триггера разные разрешения:

  • can_invoke: подходящие входящие данные могут запустить выполнение.
  • can_read: источник или канал можно читать.
  • can_write: агент может публиковать сообщения или отвечать через этот маршрут.

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

Место назначения отчётов по расписанию и канал запроса одобрения — тоже отдельные значения слова «канал». Настройка одного не настраивает остальные.

Проверьте, измените или остановите процесс

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

Приостанови Support intake (Приём обращений), чтобы новые сообщения больше не запускали этот процесс. Сообщи, если выполнение уже идёт.

Деактивация запрещает новым подходящим входным данным запускать этот триггер. Остановка уже идущего выполнения — отдельное действие с текущим запуском. Удаление триггера удаляет его определение; оно не отзывает уже отправленные сообщения и не отменяет завершённую работу.

Для остановки маршрутизации канала проекта текущая кодовая база удаляет ресурс Channel (Канал) или отвязывает его и деактивирует этот маршрут. Точное поведение подтверждения удаления канала и истории не проверялось, поэтому изучите его перед удалением. Не предполагайте, что это также отключит несвязанный триггер или всю учётную запись сервиса.

Если настройка заблокирована

Административная страница участника Member Create Trigger (Создать триггер) может быть ограничена, хотя разрешённый путь создания через агента остаётся доступным. Обратитесь к агенту проекта и устраните конкретную проблему с инструментом, проектом или подключением. Отклонённый запрос возможности не разрешает менять область действия или обходить одобрение.

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