Агенты

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

Назначение

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

• Получает запросы от пользователей

• Анализирует их с помощью 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. Добавьте пользователя или очистите список (доступ для всех)

Далее

Инструменты