Как создать ИИ-агента
Обновлено:
В SyBox это делается в Настройки > ИИ и автоматизация > ИИ-агенты.
- Получите API-ключ на сайте выбранного провайдера (Gemini, ChatGPT, Claude, DeepSeek или OpenRouter).
- Перейдите в Настройки > ИИ и автоматизация > ИИ-агенты.
- Нажмите «Новый ИИ-агент».
- В поле «Тип» выберите провайдера.
- В поле «Название» укажите имя, например «Помощник по продажам». Клиенты могут видеть это имя в некоторых каналах.
- Необязательно: в поле «Начать с шаблона» выберите шаблон: «Администратор», «Продажи» или «Поддержка клиентов». Шаблон заполнит первые инструкции агента за вас. Вариант «Пустые инструкции» позволяет начать с чистого листа.
- Вставьте ключ в поле «Ключ API».
- Нажмите «Сохранить». SyBox проверит ключ у провайдера перед сохранением. Если ключ работает, агент создастся, для него автоматически выберется модель, и откроется страница агента. Если вы выбрали шаблон, его текст уже будет в поле «Ваши инструкции»: измените его под задачи вашей компании перед использованием агента.
Вопросы
Каких провайдеров ИИ можно подключать?
Все они перечислены в списке «Тип» при создании («Новый ИИ-агент»): Gemini, ChatGPT, Claude, DeepSeek и OpenRouter (один ключ ко множеству моделей). Вам понадобится собственный API-ключ от выбранного сервиса.
Кто оплачивает использование ИИ?
Вы сами напрямую вашему провайдеру по вашему ключу. SyBox отображает количество потраченных токенов на карточке агента и в таблице статистики, но не выставляет счета и не показывает цены.
Я создал агента, но он не отвечает клиентам. В чём дело?
Агент отвечает только при срабатывании правила автоматизации. Откройте Настройки > ИИ и автоматизация > Автоматизации и создайте правило с действием «Ответить с помощью ИИ», указав вашего агента. Убедитесь, что параметр Состояние у правила — «Вкл.», а глобальный переключатель «Автоматизации работают» наверху страницы активен. Также проверьте:
- не нажата ли в переписке кнопка «Остановить ответы ИИ»
- не заблокирован ли диалог, не отправлен ли в спам или архив (временный архив не мешает работе)
- не ответил ли уже кто-то из ваших сотрудников (агент не вмешивается до закрытия чата, пока не выйдет срок «Снова отвечать через» или пока оператор не нажмёт «Передать ИИ» в панели диалога).
Может ли агент сам пообещать клиенту обратный звонок, скидку или точный день доставки?
Сам по себе — нет. Агент никогда ничего не гарантирует от лица компании, если вы прямо не разрешили это в его инструкциях.
Появляется ошибка «[Provider] отклонил ключ: …»
Провайдер не принял API-ключ. Убедитесь, что скопировали ключ полностью, что он активен, и что на балансе аккаунта у провайдера есть средства или активные квоты. Попробуйте снова.
Ошибка: «Этот ключ [provider] не даёт доступа ни к одной модели, которую может использовать этот агент.»
Ваш ключ не поддерживает модели, с которыми работает SyBox. Проверьте тариф и права доступа в личном кабинете провайдера или укажите другой ключ.
На карточке горит «Последняя ошибка». Что делать?
Это последняя ошибка от провайдера — например, закончился срок действия ключа или исчерпан лимит средств. Исправьте причину в кабинете провайдера или нажмите «Редактировать» и вставьте рабочий ключ.
Можно ли назначить разных агентов на разные номера или каналы?
Да. Создайте нужных агентов под каждую задачу. Затем создайте отдельные правила в автоматизациях с условием «Канал», привязав к каждому нужные номера или страницы.
Если загрузить новый файл, он дополнит текущую базу?
Нет. Загрузка файла или вставка текста полностью перезаписывает всю базу знаний агента. Собирайте всю информацию для агента в один файл перед загрузкой.
Агент ответил некорректно или среагировал там, где не должен был. Как исправить?
Добавьте или скорректируйте данные в базе знаний или пропишите чёткое правило в блоке «Ваши инструкции». Затем протестируйте поведение на вкладке «Чат».
Умеет ли агент распределять диалоги или ставить ярлыки?
Да, через инструкции. Используйте системные номера сущностей, указанные под полем «Ваши инструкции», например: «назначь пользователя 3» или «добавь ярлык 1».
Подробнее о ИИ-агенты.