> 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/bystryj-start/pervyj-agent.md).

# Первый агент

В этом разделе вы создадите своего первого ИИ агента и протестируете его работу.

## Цель

Создать простого агента-помощника, который сможет отвечать на вопросы пользователей.

## Предварительные требования

* Установлена конфигурация OneAPA
* Запущен Proxy-сервер
* Создана модель LLM (см. [Установка](/ai-platforma-oneapa/bystryj-start/ustanovka.md))

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

### 1.1 Открытие справочника

В 1С откройте справочник "Агенты":

* Меню "Панель навигации" → "Агенты"
* Или через поиск: "Агенты"

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

Нажмите "Создать" и заполните форму:

| Поле             | Значение                                      |
| ---------------- | --------------------------------------------- |
| **Наименование** | Помощник                                      |
| **Активен**      | ✓ (установить флаг)                           |
| **Описание**     | Универсальный помощник для ответов на вопросы |
| **Модель**       | Выберите созданную ранее модель               |
| **Триггер**      | Чат                                           |

### 1.3 Системный промпт

В поле "Системный промпт" введите:

```
Ты — дружелюбный помощник компании. Твоя задача — отвечать на вопросы пользователей.

Правила:
1. Отвечай кратко и по существу
2. Если не знаешь ответ — честно скажи об этом
3. Используй вежливый тон
4. Отвечай на русском языке
```

### 1.4 Сохранение

Нажмите "Записать и закрыть".

## Шаг 2: Синхронизация с Proxy

### 2.1 Выполнение обмена

Выполните синхронизацию агентов с Proxy-сервером:

* Меню "Панель действий" → "Выполнить обмен с Proxy"

### 2.2 Проверка результата

Должно появиться сообщение об успешной загрузке агентов.

{% hint style="info" %}
При каждом изменении агентов, инструментов или моделей необходимо выполнять синхронизацию с Proxy.
{% endhint %}

## Шаг 3: Тестирование в чате

### 3.1 Открытие чата

Откройте чат OneAPA:

* Меню "Панель навигации" → "Чат"

### 3.2 Отправка тестового сообщения

Введите в чат простое сообщение:

```
Привет! Как дела?
```

### 3.3 Получение ответа

Агент должен ответить примерно так:

```
Здравствуйте! У меня всё отлично, спасибо что спросили! 
Чем могу вам помочь?
```

## Шаг 4: Добавление инструмента (опционально)

Для более полезного агента добавим простой инструмент.

### 4.1 Создание инструмента

Откройте справочник "Инструменты" и создайте новый элемент:

| Поле             | Значение                                |
| ---------------- | --------------------------------------- |
| **Наименование** | Текущая дата и время                    |
| **Описание**     | Возвращает текущую дату и время сервера |

В поле "Запрос/Код" введите код на языке 1С:

```bsl
Результат = Строка(ТекущаяДата());
```

### 4.2 Параметры инструмента

Для этого инструмента параметры не требуются. Табличную часть "Параметры" оставьте пустой.

### 4.3 Добавление инструмента к агенту

1. Откройте созданного агента "Помощник"
2. Перейдите на вкладку "Инструменты"
3. Добавьте инструмент "Текущая дата и время"
4. Сохраните агента

### 4.4 Синхронизация

Выполните обмен с Proxy повторно.

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

В чате спросите:

```
Который сейчас час?
```

Агент должен:

1. Определить, что нужно использовать инструмент
2. Вызвать инструмент "Текущая дата и время"
3. Получить результат
4. Сформировать ответ

Пример ответа:

```
Сейчас 23.01.2026 14:35:00.
```

## Расширенная конфигурация агента

### Пример более сложного промпта

```
Ты — ИИ-ассистент компании "Рога и копыта".

Твои возможности:
- Отвечать на общие вопросы
- Сообщать текущую дату и время
- Помогать с простыми задачами

Твои ограничения:
- Ты не имеешь доступа к персональным данным сотрудников
- Ты не можешь выполнять финансовые операции
- Ты не можешь изменять данные в системе

При каждом ответе:
1. Будь вежлив и профессионален
2. Если запрос выходит за рамки твоих возможностей — 
   вежливо объясни это
3. При необходимости уточняй детали запроса
```

### Добавление пользователей

Если нужно ограничить доступ к агенту:

1. Откройте агента
2. Перейдите на вкладку "Пользователи"
3. Добавьте пользователей, которые могут использовать этого агента

{% hint style="info" %}
Если табличная часть "Пользователи" пуста — агент доступен всем.
{% endhint %}

## Типичные проблемы

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

| Причина                   | Решение                           |
| ------------------------- | --------------------------------- |
| Не выполнен обмен с Proxy | Выполните команду "Обмен с Proxy" |
| Proxy не запущен          | Проверьте статус Proxy сервера    |
| Неверный API ключ         | Проверьте настройки модели        |

### Ответ приходит очень долго

| Причина          | Решение                                       |
| ---------------- | --------------------------------------------- |
| Медленная модель | Попробуйте более быструю модель (gpt-4o-mini) |
| Сетевые задержки | Проверьте подключение к LLM провайдеру        |
| Сложный промпт   | Упростите системный промпт                    |

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

| Причина                  | Решение                         |
| ------------------------ | ------------------------------- |
| Инструменты не добавлены | Добавьте инструменты в агента   |
| Не выполнен обмен        | Повторите синхронизацию с Proxy |
| Неясное описание         | Уточните описание инструмента   |

## Поздравляем!

Вы создали своего первого ИИ агента! Теперь вы можете:

* Создавать более сложных агентов
* Добавлять разнообразные инструменты
* Настраивать триггеры для автоматического запуска

## Далее

Проверьте работоспособность системы:

{% content-ref url="/pages/ktAJhxhoefYp0OGw7jw0" %}
[Проверка работоспособности](/ai-platforma-oneapa/bystryj-start/proverka-rabotosposobnosti.md)
{% endcontent-ref %}

Изучите примеры агентов:

{% content-ref url="/pages/CJ9yzUSQRFkfvGB4Spfm" %}
[Broken mention](broken://pages/CJ9yzUSQRFkfvGB4Spfm)
{% endcontent-ref %}