> 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/spravochniki/agenty.md).

# Агенты

Справочник `APA_Агенты` — центральный объект системы, определяющий настройки ИИ агентов.

<figure><img src="/files/1KEOr2IWRxMk4tPVjUV7" alt=""><figcaption></figcaption></figure>

## Назначение

Агент — это автономная сущность, которая:

* Получает запросы от пользователей
* Анализирует их с помощью LLM
* Использует инструменты для получения данных
* Формирует и возвращает ответы

## Характеристики справочника

| Параметр      | Значение    |
| ------------- | ----------- |
| Имя           | APA\_Агенты |
| Иерархический | Да          |
| Владельцы     | Нет         |

## Реквизиты

### Основные реквизиты

| Реквизит                   | Тип                      | Обязательный | Описание                   |
| -------------------------- | ------------------------ | ------------ | -------------------------- |
| **Код**                    | Строка(9)                | Да           | Уникальный код             |
| **Наименование**           | Строка(150)              | Да           | Название агента            |
| **Активен**                | Булево                   | Нет          | Включён ли агент           |
| **Описание**               | Строка(0)                | Нет          | Описание для выбора агента |
| **Модель**                 | Справочник.APA\_Модели   | Да           | LLM модель                 |
| **Триггер**                | Справочник.APA\_Триггеры | Нет          | Событие запуска            |
| **СистемныйПромпт**        | Строка(0)                | Нет          | Инструкция для LLM         |
| **ПользовательскийПромпт** | Строка(0)                | Нет          | Шаблон обработки           |
| **СледующийАгент**         | Справочник.APA\_Агенты   | Нет          | Передача управления        |

### Табличные части

#### Инструменты

| Колонка    | Тип                         | Описание             |
| ---------- | --------------------------- | -------------------- |
| Инструмент | Справочник.APA\_Инструменты | Ссылка на инструмент |

#### Пользователи

| Колонка      | Тип                          | Описание                      |
| ------------ | ---------------------------- | ----------------------------- |
| Пользователь | Справочник.APA\_Пользователи | Кто может использовать агента |

#### MCPСерверы

| Колонка   | Тип                        | Описание           |
| --------- | -------------------------- | ------------------ |
| MCPСервер | Справочник.APA\_MCPСерверы | Внешний MCP сервер |

## Форма элемента

```
┌─────────────────────────────────────────────────────────────────────────┐
│  Агент: Кадровый специалист                          [Записать] [Закрыть]│
├─────────────────────────────────────────────────────────────────────────┤
│  [Основное]  [Инструменты]  [MCP серверы]  [Пользователи]              │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  ☑ Активен                                                              │
│                                                                          │
│  Код: [000000001]                                                        │
│  Наименование: [Кадровый специалист                              ]      │
│                                                                          │
│  Описание:                                                               │
│  ┌────────────────────────────────────────────────────────────────────┐ │
│  │ Помогает сотрудникам с кадровыми вопросами: отпуска, командировки, │ │
│  │ справки, информация о зарплате.                                    │ │
│  └────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
│  Модель:   [OpenAI GPT-4o                                         ▼]   │
│  Триггер:  [Чат                                                   ▼]   │
│                                                                          │
│  Системный промпт:                                                       │
│  ┌────────────────────────────────────────────────────────────────────┐ │
│  │ Ты — кадровый специалист компании.                                 │ │
│  │                                                                     │ │
│  │ Твои задачи:                                                        │ │
│  │ - Отвечать на вопросы об отпусках                                  │ │
│  │ - Помогать с оформлением командировок                              │ │
│  │ - Предоставлять информацию о зарплате                              │ │
│  │                                                                     │ │
│  │ Правила:                                                            │ │
│  │ - Будь вежлив и профессионален                                     │ │
│  │ - Используй инструменты для получения данных                       │ │
│  │ - Не разглашай данные других сотрудников                           │ │
│  └────────────────────────────────────────────────────────────────────┘ │
│                                                                          │
│  Следующий агент: [                                               ▼]   │
│                                                                          │
└─────────────────────────────────────────────────────────────────────────┘
```

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

### Шаг 1: Базовые настройки

1. Откройте справочник "Агенты"
2. Нажмите "Создать"
3. Введите **Наименование** — понятное название
4. Введите **Описание** — краткое описание задач агента
5. Установите флаг **Активен**

### Шаг 2: Выбор модели

Выберите модель LLM в поле **Модель**:

* Для сложных задач: GPT-4o, Claude 3
* Для простых: GPT-4o-mini, Llama 3
* Для конфиденциальных: Ollama

### Шаг 3: Системный промпт

Напишите **Системный промпт** — инструкцию для агента:

```
Ты — [роль агента].

Твои задачи:
- [Задача 1]
- [Задача 2]
- [Задача 3]

Правила:
- [Правило 1]
- [Правило 2]

При ответе:
- [Формат ответа]
```

### Шаг 4: Добавление инструментов

1. Перейдите на вкладку "Инструменты"
2. Нажмите "Добавить"
3. Выберите инструменты из справочника

### Шаг 5: Ограничение доступа (опционально)

1. Перейдите на вкладку "Пользователи"
2. Добавьте пользователей, которым разрешён доступ
3. Если список пуст — доступ для всех

### Шаг 6: Сохранение

1. Нажмите "Записать"
2. Выполните синхронизацию с Proxy

## Примеры конфигурации

### Информационный агент

```
Наименование: Справочный бот
Описание: Отвечает на общие вопросы о компании
Модель: GPT-4o-mini
Триггер: Чат

Системный промпт:
Ты — справочный бот компании "Рога и копыта".
Отвечай на вопросы о компании, её продуктах и услугах.
Если не знаешь ответ — предложи обратиться к менеджеру.

Инструменты:
- Поиск в базе знаний
```

### Агент с действиями

```
Наименование: Бухгалтер
Описание: Помогает с финансовыми операциями
Модель: GPT-4o
Триггер: Чат

Системный промпт:
Ты — бухгалтер компании.
Можешь проверять остатки на счетах и создавать заявки на оплату.
Всегда запрашивай подтверждение перед созданием документов.

Инструменты:
- Остаток на счёте
- Создать заявку на оплату
- Список неоплаченных счетов

Пользователи:
- Главный бухгалтер
- Финансовый директор
```

### Цепочка агентов

```
Агент 1: Классификатор
Описание: Определяет тип обращения
Следующий агент: (зависит от классификации)

Агент 2: Кадровый агент
Описание: Обрабатывает кадровые вопросы

Агент 3: Технический агент
Описание: Обрабатывает технические вопросы
```

## Поле "Описание"

Поле **Описание** используется для автоматического выбора агента:

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

**Пример хорошего описания:**

```
Помогает сотрудникам с вопросами об отпусках, командировках, 
больничных, справках 2-НДФЛ, информации о зарплате и премиях.
```

**Пример плохого описания:**

```
Кадровый агент
```

## Поле "Следующий агент"

Позволяет передать управление другому агенту после завершения работы:

```
Агент "Приёмщик обращений"
    ↓ (после классификации)
Агент "Техническая поддержка"
```

## Устранение проблем

### Агент не отвечает

1. Проверьте флаг "Активен"
2. Проверьте настройки модели
3. Выполните синхронизацию с Proxy

### Агент не использует инструменты

1. Убедитесь, что инструменты добавлены на вкладке "Инструменты"
2. Проверьте описания инструментов
3. Укажите в промпте, когда использовать инструменты

### Агент недоступен пользователю

1. Проверьте вкладку "Пользователи"
2. Добавьте пользователя или очистите список (доступ для всех)

## Далее

{% content-ref url="/pages/8dJrIdmLGPYsEfymvTE5" %}
[Инструменты](/ai-platforma-oneapa/spravochniki/instrumenty.md)
{% endcontent-ref %}