Первый агент

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

Цель

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

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

• Установлена конфигурация OneAPA

• Запущен Proxy-сервер

• Создана модель LLM (см. Установка)

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

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

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

• Меню "Панель навигации" → "Агенты"

• Или через поиск: "Агенты"

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

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

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

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

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

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

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

1.4 Сохранение

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

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

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

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

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

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

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

При каждом изменении агентов, инструментов или моделей необходимо выполнять синхронизацию с Proxy.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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. Добавьте пользователей, которые могут использовать этого агента

Если табличная часть "Пользователи" пуста — агент доступен всем.

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

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

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

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

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

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

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

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

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

• Создавать более сложных агентов

• Добавлять разнообразные инструменты

• Настраивать триггеры для автоматического запуска

Далее

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

Проверка работоспособности

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