# Агенты

Справочник `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 %}


---

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