Настройка триггеров

Руководство по настройке триггеров запуска агентов.

Обзор триггеров

Триггер	Событие	Пример
Чат	Сообщение в чате	Пользователь пишет вопрос
EMail	Входящее письмо	Письмо на support@
API	HTTP запрос	POST /api/invoke
БуферОбмена	Копирование	Копирование ИНН
ЗаписьОбъекта	Событие 1С	Создание документа

Триггер "Чат"

Описание

Самый распространённый триггер — агент запускается при сообщении в чате.

Настройка

1. Создайте триггер с типом "Чат"

2. Условие не требуется

3. Привяжите к агенту

Автоматический выбор агента

При нескольких агентах с триггером "Чат":

1. LLM анализирует сообщение

2. Сравнивает с описаниями агентов

3. Выбирает наиболее подходящего

Триггер "EMail"

Описание

Агент запускается при получении email.

Настройка

{
  "to": "[email protected]",
  "subject_contains": "Заявка"
}

Параметры

Параметр	Описание
to	Адрес получателя
from	Адрес отправителя
subject_contains	Текст в теме

Пример использования

Триггер: Обращения в HR
Условие: {"to": "[email protected]"}

Агент автоматически:
1. Читает входящее письмо
2. Классифицирует запрос
3. Формирует ответ
4. Отправляет email

Триггер "API"

Описание

Агент запускается при HTTP запросе.

Настройка

{
  "endpoint": "/api/agent/hr",
  "method": "POST"
}

Пример вызова

curl -X POST http://server/api/agent/hr \
  -H "Content-Type: application/json" \
  -d '{"message": "Сколько отпуска у Иванова?"}'

Триггер "Буфер обмена"

Описание

Агент запускается при копировании текста.

Настройка

{
  "pattern": "^\\d{10}$"
}

Пример использования

Пользователь копирует: 7707083893 (ИНН)
Агент автоматически:
1. Распознаёт ИНН
2. Ищет контрагента
3. Показывает информацию

Триггер "Запись объекта"

Описание

Агент запускается при записи объекта в 1С.

Настройка

{
  "object_type": "Документ.ЗаявкаНаОтпуск",
  "event": "ПриЗаписи",
  "new_only": true
}

Параметры

Параметр	Описание
object_type	Тип объекта
event	Событие (ПриЗаписи, ПередЗаписью)
new_only	Только новые объекты

Пример использования

Триггер: Проверка заявки на отпуск
Условие: {
  "object_type": "Документ.ЗаявкаНаОтпуск",
  "event": "ПриЗаписи"
}

При создании заявки агент:
1. Проверяет корректность дат
2. Проверяет остаток отпуска
3. Проверяет пересечения
4. Отправляет уведомление руководителю

Комбинирование триггеров

Агент может иметь несколько триггеров:

Агент: Универсальный помощник

Триггеры:
- Чат (основной)
- API (для интеграций)
- EMail (для внешних запросов)

Далее

Лучшие практики