> 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/osnovy-razrabotki.md).

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

Базовые принципы разработки ИИ агентов в OneAPA.

## Планирование агента

### 1. Определение задач

Ответьте на вопросы:

* Какие задачи будет решать агент?
* Кто будет его использовать?
* Какие данные ему нужны?

**Пример:**

```
Агент: Кадровый помощник
Задачи:
- Информирование об остатке отпуска
- Помощь с оформлением командировок
- Ответы на вопросы о зарплате

Пользователи: Все сотрудники
Данные: Кадровые данные из 1С
```

### 2. Выбор модели

| Задача                  | Рекомендуемая модель |
| ----------------------- | -------------------- |
| Простые ответы          | GPT-4o-mini, Llama 3 |
| Сложный анализ          | GPT-4o, Claude 3     |
| Работа с изображениями  | GPT-4o               |
| Конфиденциальные данные | Ollama               |

### 3. Проектирование инструментов

Определите, какие инструменты нужны:

```
Агент: Кадровый помощник
Инструменты:
1. Получить остаток отпуска
   - Вход: ФИО сотрудника
   - Выход: Количество дней

2. Получить информацию о зарплате
   - Вход: ФИО, период
   - Выход: Начисления, удержания

3. Создать заявку на отпуск
   - Вход: ФИО, даты
   - Выход: Номер заявки
```

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

### Шаг 1: Создание модели

1. Справочник "Модели" → Создать
2. Выберите провайдер
3. Укажите API ключ
4. Укажите название модели

### Шаг 2: Создание агента

1. Справочник "Агенты" → Создать
2. Заполните:
   * Наименование
   * Описание
   * Модель
   * Системный промпт
3. Установите флаг "Активен"

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

1. Создайте инструменты в справочнике
2. Добавьте их на вкладку "Инструменты" агента

### Шаг 4: Настройка доступа

1. Если нужно ограничить — добавьте пользователей
2. Если для всех — оставьте список пустым

### Шаг 5: Синхронизация

Выполните "Обмен с Proxy"

## Типы агентов

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

Только отвечает на вопросы, не изменяет данные.

```
Системный промпт:
Ты — информационный помощник.
Отвечай на вопросы пользователей.
Ты НЕ можешь изменять данные или создавать документы.
```

### Агент-исполнитель

Может выполнять действия в системе.

```
Системный промпт:
Ты — помощник для работы с документами.
Ты можешь:
- Отвечать на вопросы
- Создавать заявки
- Формировать отчёты

ВСЕГДА запрашивай подтверждение перед созданием документов.
```

### Агент-маршрутизатор

Определяет тип запроса и передаёт другому агенту.

```
Системный промпт:
Ты — диспетчер обращений.
Определи тип запроса:
- Кадровый вопрос → передай кадровому агенту
- Финансовый вопрос → передай бухгалтерскому агенту
- Технический вопрос → передай в техподдержку
```

## Тестирование

### Тестовые сценарии

```
1. Базовый тест
   Вход: "Привет"
   Ожидание: Приветствие

2. Тест инструмента
   Вход: "Сколько у меня отпуска?"
   Ожидание: Вызов инструмента, ответ с числом

3. Тест ограничений
   Вход: "Удали все данные"
   Ожидание: Отказ с объяснением
```

### Оценка качества

| Критерий   | Как оценить            |
| ---------- | ---------------------- |
| Точность   | Сравнение с эталоном   |
| Полнота    | Все ли данные включены |
| Понятность | Ясен ли ответ          |
| Скорость   | Время ответа           |

## Далее

{% content-ref url="/pages/lvbMqYWzJAAHZeJPOayo" %}
[Создание инструментов](/ai-platforma-oneapa/razrabotka-agentov/sozdanie-instrumentov.md)
{% endcontent-ref %}