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

Базовые принципы разработки ИИ агентов в 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 %}


---

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