ИИ-агенты

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

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

   

4. В поле «Тип» выберите провайдера.
5. В поле «Название» укажите имя, например «Помощник по продажам». Клиенты могут видеть это имя в некоторых каналах.
6. Необязательно: в поле «Начать с шаблона» выберите шаблон: «Администратор», «Продажи» или «Поддержка клиентов». Шаблон заполнит первые инструкции агента за вас. Вариант «Пустые инструкции» позволяет начать с чистого листа.
7. Вставьте ключ в поле «Ключ API».
8. Нажмите «Сохранить». SyBox проверит ключ у провайдера перед сохранением. Если ключ работает, агент создастся, для него автоматически выберется модель, и откроется страница агента. Если вы выбрали шаблон, его текст уже будет в поле «Ваши инструкции»: измените его под задачи вашей компании перед использованием агента.

Как проверять ответы ваших агентов

1. Перейдите в Настройки > ИИ и автоматизация > ИИ-агенты и откройте вкладку «Ответы».
2. Выберите период («Последние 7 дней», «Последние 30 дней» или «Последние 90 дней»), фильтр отображения («Все ответы», «С ответом», «Не ответил», «Плохой ответ», «Хороший ответ» или «Ещё не оценено») и, если у вас несколько агентов, одного агента или «Все агенты».
3. Над списком отображаются показатели за выбранный период, например «С ответом: 120 · Не ответил: 8 · Хорошие: 30 · Плохие: 4».
4. В каждой записи показаны имя клиента, агент, время, сообщение клиента («Клиент:») и ответ агента. Если агент не ответил на сообщение, отображается «Не ответил».
5. Нажмите «Хороший ответ» или «Плохой ответ» под ответом, чтобы оценить его, и при желании укажите причину. Это та же оценка, что и под ответом внутри диалога. Нажмите на выбранную оценку ещё раз, чтобы снять её.
6. Нажмите «Открыть диалог», чтобы просмотреть ответ в контексте диалога в новой вкладке.
7. Нажмите «Показать ещё» под списком, чтобы загрузить более старые ответы.

Вы видите только ответы из тех диалогов, которые вам разрешено просматривать. Номера телефонов клиентов здесь никогда не отображаются.

Как открыть страницу агента

1. Нажмите на карточку агента или на значок карандаша на ней.

   

2. Чтобы вернуться к списку, нажмите «ИИ-агенты» в левом верхнем углу страницы агента.

Как переименовать агента, сменить ключ или изменить модель

1. Откройте страницу агента.
2. Нажмите на карандаш (Редактировать) рядом с именем агента.

   

3. Измените «Название», если требуется.
4. «API-ключ»: оставьте пустым, чтобы не менять ключ, или вставьте новый.
5. «Модель»: выберите другую модель из списка.
6. «Мышление»: настройте глубину размышлений модели перед ответом (см. «Как настроить глубину размышлений агента» ниже).
7. Нажмите «Сохранить». Новый ключ или модель сначала проверяются на стороне провайдера.

Обратите внимание: у агентов Gemini и ChatGPT смена ключа сбрасывает базу знаний. Загрузите материалы заново после сохранения.

Как настроить глубину размышлений агента («Мышление»)

1. Откройте страницу агента и нажмите карандаш (Редактировать) рядом с его именем. Такой же список есть в окне создания копии.
2. В пункте «Мышление» выберите Выкл., Минимальное, Низкое, Среднее, Высокое, Очень высокое или Максимум. У каждого провайдера отображаются только поддерживаемые уровни.

   

3. Нажмите «Сохранить».

Более глубокое мышление помогает отвечать на сложные вопросы, но агент отвечает медленнее и тратит больше токенов. По умолчанию стоит «Низкое». У каждого агента своя настройка.

Как дублировать агента

1. Нажмите «Дублировать» (значок копирования) на карточке агента в списке либо откройте страницу агента и нажмите «Дублировать» между кнопками редактирования и удаления.

   

2. В поле «Название копии» введите имя.
3. В поле «Тип» оставьте текущего провайдера или выберите другого, чтобы перенести копию к нему. Копия сохранит инструкции агента, настройки, словарь замен и базу знаний.
4. В поле «API-ключ» выберите ключ: собственный ключ агента или ключ другого агента того же типа (отображается как «имя (…abcd)»). Либо выберите «Ввести новый ключ» и вставьте его. При смене типа на новый вставьте новый ключ.

   

5. Выберите «Модель» и уровень параметра «Мышление».
6. Нажмите «Сохранить». Ключ сначала проверяется у провайдера. Откроется страница копии, куда начнёт загружаться база знаний с индикатором выполнения.

Если появится сообщение «База знаний [name] была загружена до того, как SyBox сохранил её копию. Загрузите её ещё раз в [name], затем продублируйте.», загрузите материалы агента заново и повторите копирование.

Как удалить агента

1. Откройте страницу агента.
2. Нажмите на корзину (Удалить) рядом с именем агента.

   

3. Подтвердите действие. Появится запрос: «Удалить [name]? Его база знаний также будет удалена из [provider].»
4. Все автоматизации, использовавшие этого агента, перестанут отвечать с его помощью. Отредактируйте эти автоматизации и назначьте другого агента.

Агента нельзя удалить, пока идёт загрузка его базы знаний.

Как остановить всех ИИ-агентов сразу

1. Перейдите в раздел Настройки > ИИ-агенты.
2. Нажмите «Остановить всех ИИ-агентов» рядом с кнопкой «Новый ИИ-агент».

   

3. Подтвердите действие. Появится текст: «Все ИИ-агенты перестанут отвечать клиентам, переводить и описывать изображения, пока вы не включите их снова.» Если агенты задействованы в автоматизациях, они будут перечислены под заголовком «Они используются в следующих автоматизациях и будут пропущены:».

Все работавшие агенты будут выключены. Ничего не удаляется: базы знаний и настройки остаются нетронутыми.

Как снова включить остановленных агентов

1. Перейдите в раздел Настройки > ИИ-агенты.
2. Нажмите «Снова включить остановленных агентов».

Включатся только те агенты, которые были выключены кнопкой «Остановить всех ИИ-агентов». Агенты, отключённые вручную до этого, останутся выключенными.

Как загрузить базу знаний из файла

1. Откройте страницу агента.
2. Нажмите «Загрузить файл».

   

3. Выберите файл .pdf, .docx, .txt, .md, .csv или .json размером до 10 МБ. SyBox сам извлекает текст из файлов PDF и Word, поэтому конвертировать их не нужно. Файл .json со списком записей загружается построчно.
4. Если в базе знаний уже есть данные, появится окно «Заменить базу знаний?». Система предупредит, что текущие данные удалятся безвозвратно. Введите показанный 6-значный код и нажмите «Заменить».
5. На панели отобразится процесс, например «Загрузка… 120 из 500 (24%)» или «Загрузка… для большого файла это займёт несколько минут. Страницу можно закрыть.».
6. По завершении на панели появится надпись «Загружено записей: [number]».

Из PDF считывается только текст. Отсканированный PDF содержит только изображения, поэтому прочитать в нём нечего: загрузите исходный документ или вставьте его текст. В файле Word читается основной текст документа, а каждая строка таблицы становится отдельной строкой. Колонтитулы и комментарии не считываются. Старый формат .doc (Word 97–2003) не принимается: откройте файл в Word и сохраните его как .docx.

Как загрузить базу знаний с веб-страницы

1. Откройте страницу агента.
2. Введите или вставьте адрес страницы в поле «Или загрузите веб-страницу». Он должен начинаться с https:// и открываться без входа в аккаунт — например, страница с прайс-листом или условиями доставки.
3. Нажмите «Загрузить страницу». Если база уже загружена, подтвердите замену 6-значным кодом, как описано выше.
4. По завершении под количеством записей на панели появится строка «Загружено с» и адрес страницы.

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

Когда текст на странице обновится, нажмите «Перечитать страницу». Система заново обратится по тому же адресу и после ввода 6-значного кода заменит базу знаний актуальным содержимым страницы. Загрузка файла, вставка текста или очистка базы знаний удаляет строку «Загружено с».

Как загрузить базу знаний вставкой текста

1. Откройте страницу агента.
2. Вставьте в поле «Или вставьте текст» нужные данные: цены, сроки доставки, правила возврата и т. д.

   

3. Нажмите «Сохранить». Если база уже содержала данные, подтвердите замену 6-значным кодом, как описано выше.

Как очистить базу знаний

1. Откройте страницу агента.

   

2. Нажмите «Очистить эту базу знаний». Кнопка активна только тогда, когда в базе что-то есть.
3. Введите показанный 6-значный код и подтвердите действие.

Как ограничить число ответов агента

1. Откройте страницу агента.
2. В блоке «Максимум ответов за 24 часа» укажите число в поле «Одному клиенту» (лимит ответов одному человеку), в поле «Всем клиентам» (общий лимит ответов) или в обоих сразу. Значение 0 отключает лимит.

   

3. Числа сохраняются сразу при вводе, отдельной кнопки сохранения здесь нет.

Интервал 24 часов считается скользящим: учитываются последние 24 часа от текущего момента. При достижении лимита агент прекращает отвечать и оставляет переписку операторам, а в чате появляется серая системная заметка, например: «Помощник Мебельной фабрики достиг лимита (ответов: 20) для этого клиента за 24 часа. Пока на этот диалог отвечает ваша команда.» Агент возобновит ответы, как только за последние 24 часа счётчик станет меньше лимита. Это не передача диалога: чат никому персонально не назначается. Последний ответ агента перед достижением лимита заканчивается одной фразой о том, что общение продолжит команда.

Как настроить ожидание новых сообщений для агента

1. Откройте страницу агента.
2. В блоке «Ждать новых сообщений» укажите, сколько секунд («сек.», от 0 до 120) агент ждёт после последнего сообщения клиента, прежде чем ответить. Значение 0 означает несколько секунд, как раньше.

   

Каждое новое сообщение клиента запускает ожидание заново; в сумме ожидание длится не более трёх указанных значений и не менее 15 секунд. Кнопка «Дублировать» копирует эту настройку в нового агента.

Как загрузить словарь замен

1. Откройте страницу агента (Настройки > ИИ-агенты, затем кликните по агенту).
2. В блоке «Словарь замен» нажмите «Загрузить словарь (JSON)» и выберите файл (до 2 МБ).

   

3. Индикатор покажет количество загруженных слов.

Файл должен быть строго в формате JSON следующей структуры, иначе он будет отклонён: {"format": "sybox-words/1", "words": {"SKU-1042": {"en": "Oak dining table", "ar": "طاولة طعام من خشب البلوط"}}}. В качестве ключа указывается то, что вы пишете внутри ⟦ ⟧. Каждое название — одна строка для любого из поддерживаемых языков SyBox (en, ar, fr, es, pt, de, it, tr, ru, id, ms).

- «Размер файла превышает 2 МБ.» — файл слишком большой.

- «Словарь отклонён: …» — указание на первую обнаруженную ошибку в файле. Данные из такого файла не применятся.

- Если перевод термина на язык клиента отсутствует, он будет показан на английском. Конструкция ⟦…⟧, не найденная в словаре, выводится без скобок.

Как удалить словарь замен

1. Откройте страницу агента.
2. В блоке «Словарь замен» нажмите «Удалить словарь». Статус изменится на «Нет словаря».

   

Как задать вопрос ИИ-агенту

1. Откройте диалог и нажмите «AI» на боковой панели справа от переписки (рядом с вкладкой «Сообщения»).

   

2. Если в рабочем пространстве несколько агентов, выберите нужного в строке над полем ввода. Эта строка никуда не пропадает, так что можно задавать один и тот же вопрос разным агентам и сравнивать ответы. Если агент всего один, строки выбора нет: запрос сразу уходит ему.
3. Введите вопрос в поле «Задайте вопрос…» и отправьте его. Если отправить текст до выбора агента, в строке появится подсказка «Выберите ИИ-агента, чтобы задать вопрос», и ответ сформируется сразу после клика по агенту.

Вкладка отображается, если включён хотя бы один агент.

Как спросить ИИ о сообщении клиента

1. Откройте меню нужного сообщения (стрелка рядом с ним) и выберите «Спросить AI».

   

2. Откроется вкладка «AI», а текст сообщения уже будет вставлен как ваш вопрос. Если агентов несколько, выберите нужного в строке над полем ввода.

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

- «Слишком много вопросов за короткое время. Попробуйте снова через несколько минут.» говорит о превышении частоты запросов.

Как задать Общие инструкции (для всех агентов)

1. В разделе ИИ-агенты откройте вкладку «Настройки».

   

2. В блоке «Общие инструкции» введите правила, например: «Представляйся ассистентом компании и запрашивай номер заказа перед тем, как давать по нему информацию.» До 8 000 символов.

   

3. Нажмите «Сохранить». Чтобы сбросить правила, очистите поле и сохранитесь.

Как сочетаются наборы правил: сначала применяются базовые правила SyBox. Затем идут Общие инструкции, и если они расходятся с базовыми правилами, выигрывают Общие инструкции. Далее применяются инструкции группы агента, если они заданы. Инструкции конкретного агента применяются последними и имеют приоритет над всеми остальными.

Как объединить агентов в группы и задать группе свои инструкции

1. На экране ИИ-агенты нажмите «Добавить группу». В окне «Новая группа» введите «Название группы» и при желании «Инструкции группы»: им следуют все агенты группы, после общих инструкций и до собственных инструкций агента, которые имеют над ними приоритет. Например: «Отвечай только на вопросы о ремонте и гарантии, а вопросы о покупке передавай отделу продаж.»
2. Нажмите Сохранить. Изначально каждый агент находится в «Группе по умолчанию», у которой тоже могут быть инструкции.
3. Перетащите агента, чтобы изменить его место или группу («Перетащите агента, чтобы изменить его место или группу.»). В окне редактирования агента также есть поле «Группа».

   

4. Чтобы изменить группу, нажмите на её карандаш («Изменить группу»). Чтобы удалить группу, нажмите на её корзину: «Удалить группу «(название)»? Её агенты будут перенесены в группу по умолчанию.»

Если группа только одна, экран выглядит как раньше. В пустой группе написано «В этой группе пока нет агентов. Перетащите сюда агента.»

Как собирать запросы на отсутствующие товары и услуги («Запросы на то, чего нет»)

1. В разделе ИИ-агенты откройте вкладку «Настройки».
2. В блоке «Что фиксировать» выберите «Запросы на то, чего нет» и включите тумблер «Записывать такие запросы и присылать мне на почту».

   

3. В поле «Отправлять на» укажите один или несколько email-адресов через запятую.

   

4. В поле «Отправить из» выберите «Почта SyBox» или одну из своих подключённых почт.
5. В поле «Когда» укажите «По каждому запросу сразу» или «Раз в день, всё вместе». Для ежедневной отправки задайте час в поле «В» (и «Часовой пояс», если в вашей стране их несколько).
6. Нажмите «Сохранить». Нажмите «Отправить тест», чтобы получить пробное письмо; появится надпись «Тестовое письмо отправлено.».

   

В каждой строке письма будет кнопка «Открыть переписку», ведущая прямо к сообщению клиента.

Если появилось предупреждение «Проверьте адреса электронной почты: укажите каждый адрес полностью, через запятую.», исправьте адреса в поле «Отправлять на».

Если для рабочего пространства не задана страна, появится текст: «Для вашего рабочего пространства не указана страна, поэтому время указано в UTC.». Укажите страну в меню Настройки > Рабочее пространство > Организация.

Как отслеживать жалобы клиентов («Проблемы для решения»)

1. В разделе ИИ-агенты откройте вкладку «Настройки».
2. В блоке «Что фиксировать» выберите «Проблемы для решения».

   

3. Включите опцию «Фиксировать эти проблемы и присылать мне на почту».
4. Заполните поля «Отправлять на», «Отправить из» и «Когда» («Каждая проблема сразу при возникновении» или раз в сутки в заданный час).
5. Нажмите «Сохранить». Кнопка «Отправить тест» пришлёт пример проблемы на почту.

В тестовом чате агента при подобном ответе появится карточка «Зафиксировано в «Проблемы для решения»» с объяснением логики агента. Если рассылка этого типа отключена, в карточке добавится: «Сохранено, не отправлено по почте: отправка писем отключена на вкладке «Настройки» ИИ-агентов.».

Как отключить ИИ для конкретного клиента («Остановить ИИ для клиента»)

• Подсказка с таким названием находится под блоком «Общие инструкции» и под полем «Ваши инструкции» у каждого агента. В инструкциях можно описать правила, когда агенту следует прекратить работу: «Если клиент просит вернуть деньги, останови ИИ для этого клиента.» Агент сначала отправит свой ответ, после чего отключит ИИ-ответы в этом диалоге, и дальше переписку продолжат сотрудники. В чате появится системное сообщение: «[agent] остановил ответы ИИ для этого клиента. Дальше отвечает оператор.» Чтобы вернуть агента, нажмите «Разрешить ответы ИИ» на панели над диалогом.

  

В тестовом чате агента такое действие помечается плашкой «Ответы ИИ для этого клиента останавливаются» (или «Зафиксировано в «Запросы на то, чего нет»» для запроса), где будет указана причина.

Как протестировать агента в чате

1. Откройте страницу агента и перейдите на вкладку «Чат».

   

2. Нажмите «Новый чат» или выберите один из существующих тестовых чатов.

   

3. Напишите сообщение от лица клиента и нажмите «Отправить». Агент ответит в том виде, в каком сообщение получил бы клиент, удерживая контекст текущей ветки, как в реальной переписке. Интерфейс повторяет входящие: ваши реплики показаны как реплики клиента, а ответы агента — как сообщения оператора.
4. Если ответ должен был вызвать системное действие, под ним появится блок карточек «К чему приведёт этот ответ» с деталями: отключение агента и перевод на человека, остановка ИИ для клиента, запись в «Запросы на то, чего нет» или «Проблемы для решения», простановка ярлыка, перевод в отдел, назначение сотрудника или добавление в избранное. На каждой карточке выводится пояснение («Причина: …») или «Причина не указана». В реальности действия в системе не выполняются.
5. Если агент перевёл чат на человека, дальше он отвечать не будет — в точности как в живом диалоге. Нажмите «Вернуть ИИ», чтобы продолжить тестирование ответов.

Тестовые чаты привязаны к вашему профилю. В списке они выводятся по 15 штук («Загрузить ещё»), а длинный чат сразу показывает последние реплики («Загрузить предыдущие сообщения»). Навести порядок в списке можно кнопками «В архив» (раздел «Архив», откуда чат можно «Вернуть») или «Удалить чат» («Удалить этот чат? Его нельзя будет открыть снова.»).

В боевых чатах эти причины тоже видны: когда агент зовёт оператора, отключает ИИ или помечает диалог звёздочкой, серая заметка содержит приписку «— Причина: …», а зафиксированные запросы и проблемы сохраняют это пояснение в письме.

Как добавить голос для ИИ-агентов

1. Перейдите в Настройки > ИИ и автоматизация > ИИ-агенты и откройте вкладку «Голоса».
2. Нажмите «Новая голосовая модель». Выберите «Провайдер» и вставьте его «Ключ API».
3. Выберите «Диалект», а затем «Голос» (в разделе «Женские голоса» или «Мужские голоса»). Кнопка ▶ бесплатно воспроизводит образец от провайдера. Чтобы использовать собственный голос, выберите «Другой голос: вставьте его ID» и укажите «ID голоса».
4. Необязательно: в блоке «Голос для каждой страны» нажмите «Добавить страну» и выберите для неё голос. Клиент в WhatsApp услышит голос страны своего номера, а любой другой клиент — основной голос, выбранный выше. Так один агент сможет отвечать каждому клиенту на его диалекте.
5. Укажите «Имя» и сохраните.

На каждой карточке показаны голос, строка «Озвучивает:» со списком использующих его агентов и «Осталось времени:» на вашем аккаунте у провайдера (сумма в деньгах никогда не показывается). На карточке можно прослушать голос («Прослушать»), отключить, отредактировать или удалить его. При удалении запрашивается подтверждение; агенты, использовавшие этот голос, снова начнут отвечать текстом. Текст ответа передаётся этому провайдеру для синтеза голосового сообщения.

Как настроить ИИ-агента отвечать голосовыми сообщениями

1. Откройте страницу агента в разделе ИИ-агенты.
2. В блоке «Голосовые ответы» выберите нужный голос в поле «Говорить голосом». Вариант «Выкл. — только текст» оставляет агенту только текстовые ответы.
3. Сохраните изменения.

Когда клиент пришлёт голосовое сообщение, агент ответит голосовым сообщением выбранным голосом, а всё, что нужно скопировать или открыть по клику (ссылку, код, номер), пришлёт текстом сразу следом. Клиент может сам попросить отвечать ему голосом или текстом — об этом в диалоге появится серая служебная заметка.

Чтобы выбрать режим для одного конкретного диалога, откройте его меню ⋮: «Ответы ИИ: как пишет клиент (голосовое сообщение → голосовое сообщение)», «Ответы ИИ: всегда голосовым сообщением» или «Ответы ИИ: всегда текстом». Плашка «ИИ: голос» или «ИИ: текст» показывает выбранный режим.