Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Первый агент

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

Цель

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

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

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

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

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

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

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

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

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

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

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

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

Поле
Значение

Наименование

Помощник

Активен

✓ (установить флаг)

Описание

Универсальный помощник для ответов на вопросы

Модель

Выберите созданную ранее модель

Триггер

Чат

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

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

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. Сформировать ответ

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

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

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

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

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

  1. Откройте агента

  2. Перейдите на вкладку "Пользователи"

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

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

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

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

Причина
Решение

Не выполнен обмен с Proxy

Выполните команду "Обмен с Proxy"

Proxy не запущен

Проверьте статус Proxy сервера

Неверный API ключ

Проверьте настройки модели

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

Причина
Решение

Медленная модель

Попробуйте более быструю модель (gpt-4o-mini)

Сетевые задержки

Проверьте подключение к LLM провайдеру

Сложный промпт

Упростите системный промпт

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

Причина
Решение

Инструменты не добавлены

Добавьте инструменты в агента

Не выполнен обмен

Повторите синхронизацию с Proxy

Неясное описание

Уточните описание инструмента

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

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

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

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

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

Далее

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

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

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

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

Last updated