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

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

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

| Триггер       | Событие          | Пример                    |
| ------------- | ---------------- | ------------------------- |
| Чат           | Сообщение в чате | Пользователь пишет вопрос |
| 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onerpa.ru/ai-platforma-oneapa/razrabotka-agentov/nastrojka-triggerov.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.