# Как создать ИИ-агента

В SyBox это делается в Настройки > ИИ и автоматизация > ИИ-агенты. 1) Получите API-ключ на сайте выбранного провайдера (Gemini, ChatGPT, Claude, DeepSeek или OpenRouter). 2) Перейдите в Настройки > ИИ и автоматизация > ИИ-агенты. 3) Нажмите «Новый ИИ-агент». 4) В поле «Тип» выберите провайдера. 5) В поле «Название» укажите имя, например «Помощник по продажам». Клиенты могут видеть это имя в некоторых каналах. 6) Необязательно: в поле «Начать с шаблона» выберите шаблон…

## Как создать ИИ-агента

1. Получите API-ключ на сайте выбранного провайдера (Gemini, ChatGPT, Claude, DeepSeek или OpenRouter).
2. Перейдите в Настройки > ИИ и автоматизация > ИИ-агенты.
3. Нажмите «Новый ИИ-агент».
   ![Settings, AI Agents: the agents already made and the "New AI agent" button](https://www.sybox.io/res/sybox/help/ru/create-an-ai-agent-3.webp?v=1a191498)
4. В поле «Тип» выберите провайдера.
5. В поле «Название» укажите имя, например «Помощник по продажам». Клиенты могут видеть это имя в некоторых каналах.
6. Необязательно: в поле «Начать с шаблона» выберите шаблон: «Администратор», «Продажи» или «Поддержка клиентов». Шаблон заполнит первые инструкции агента за вас. Вариант «Пустые инструкции» позволяет начать с чистого листа.
7. Вставьте ключ в поле «Ключ API».
8. Нажмите «Сохранить». SyBox проверит ключ у провайдера перед сохранением. Если ключ работает, агент создастся, для него автоматически выберется модель, и откроется страница агента. Если вы выбрали шаблон, его текст уже будет в поле «Ваши инструкции»: измените его под задачи вашей компании перед использованием агента.

## Вопросы

**Q: Каких провайдеров ИИ можно подключать?**

Все они перечислены в списке «Тип» при создании («Новый ИИ-агент»): Gemini, ChatGPT, Claude, DeepSeek и OpenRouter (один ключ ко множеству моделей). Вам понадобится собственный API-ключ от выбранного сервиса.

**Q: Кто оплачивает использование ИИ?**

Вы сами напрямую вашему провайдеру по вашему ключу. SyBox отображает количество потраченных токенов на карточке агента и в таблице статистики, но не выставляет счета и не показывает цены.

**Q: Я создал агента, но он не отвечает клиентам. В чём дело?**

Агент отвечает только при срабатывании правила автоматизации. Откройте Настройки > ИИ и автоматизация > Автоматизации и создайте правило с действием «Ответить с помощью ИИ», указав вашего агента. Убедитесь, что параметр Состояние у правила — «Вкл.», а глобальный переключатель «Автоматизации работают» наверху страницы активен. Также проверьте:
- не нажата ли в переписке кнопка «Остановить ответы ИИ»
- не заблокирован ли диалог, не отправлен ли в спам или архив (временный архив не мешает работе)
- не ответил ли уже кто-то из ваших сотрудников (агент не вмешивается до закрытия чата, пока не выйдет срок «Снова отвечать через» или пока оператор не нажмёт «Передать ИИ» в панели диалога).

**Q: Может ли агент сам пообещать клиенту обратный звонок, скидку или точный день доставки?**

Сам по себе — нет. Агент никогда ничего не гарантирует от лица компании, если вы прямо не разрешили это в его инструкциях.

**Q: Появляется ошибка «[Provider] отклонил ключ: …»**

Провайдер не принял API-ключ. Убедитесь, что скопировали ключ полностью, что он активен, и что на балансе аккаунта у провайдера есть средства или активные квоты. Попробуйте снова.

**Q: Ошибка: «Этот ключ [provider] не даёт доступа ни к одной модели, которую может использовать этот агент.»**

Ваш ключ не поддерживает модели, с которыми работает SyBox. Проверьте тариф и права доступа в личном кабинете провайдера или укажите другой ключ.

**Q: На карточке горит «Последняя ошибка». Что делать?**

Это последняя ошибка от провайдера — например, закончился срок действия ключа или исчерпан лимит средств. Исправьте причину в кабинете провайдера или нажмите «Редактировать» и вставьте рабочий ключ.

**Q: Можно ли назначить разных агентов на разные номера или каналы?**

Да. Создайте нужных агентов под каждую задачу. Затем создайте отдельные правила в автоматизациях с условием «Канал», привязав к каждому нужные номера или страницы.

**Q: Если загрузить новый файл, он дополнит текущую базу?**

Нет. Загрузка файла или вставка текста полностью перезаписывает всю базу знаний агента. Собирайте всю информацию для агента в один файл перед загрузкой.

**Q: Агент ответил некорректно или среагировал там, где не должен был. Как исправить?**

Добавьте или скорректируйте данные в базе знаний или пропишите чёткое правило в блоке «Ваши инструкции». Затем протестируйте поведение на вкладке «Чат».

**Q: Умеет ли агент распределять диалоги или ставить ярлыки?**

Да, через инструкции. Используйте системные номера сущностей, указанные под полем «Ваши инструкции», например: «назначь пользователя 3» или «добавь ярлык 1».

Source: https://www.sybox.io/ru/help/create-an-ai-agent