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

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

## Цель

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

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

* Установлена конфигурация 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 %}


---

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