> For the complete documentation index, see [llms.txt](https://docs.onerpa.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onerpa.ru/ai-platforma-oneapa/razrabotka-agentov/nastrojka-triggerov.md).

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

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

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

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

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

### Описание

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

### Настройка

1. Создайте триггер с типом "Чат"
2. Условие не требуется
3. Привяжите к агенту

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

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

1. LLM анализирует сообщение
2. Сравнивает с описаниями агентов
3. Выбирает наиболее подходящего

## Триггер "EMail"

### Описание

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

### Настройка

```json
{
  "to": "support@company.ru",
  "subject_contains": "Заявка"
}
```

### Параметры

| Параметр          | Описание          |
| ----------------- | ----------------- |
| to                | Адрес получателя  |
| from              | Адрес отправителя |
| subject\_contains | Текст в теме      |

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

```
Триггер: Обращения в HR
Условие: {"to": "hr@company.ru"}

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

## Триггер "API"

### Описание

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

### Настройка

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

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

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

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

### Описание

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

### Настройка

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

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

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

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

### Описание

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

### Настройка

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

### Параметры

| Параметр     | Описание                          |
| ------------ | --------------------------------- |
| object\_type | Тип объекта                       |
| event        | Событие (ПриЗаписи, ПередЗаписью) |
| new\_only    | Только новые объекты              |

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

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

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

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

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

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

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

## Далее

{% content-ref url="/pages/fasceG3H4bqEEEJ7jWKb" %}
[Лучшие практики](/ai-platforma-oneapa/razrabotka-agentov/luchshie-praktiki.md)
{% endcontent-ref %}