Интерфейсы

Интерфейс — это то, что видит ваш клиент: чат с агентом или форма с полями, которая запускает workflow. Публикуется одной кнопкой: вы получаете ссылку и готовый код вставки на сайт.

В отличие от чат-виджета, интерфейс умеет не только диалог: форма собирает нужные поля (строки, списки, галочки) и отдаёт результат одним ответом.

Создавать, править и публиковать интерфейсы могут владелец и администратор организации: интерфейс — это публичное лицо компании, и его публикация выдаёт ключ доступа. Операторы видят раздел, но не меняют его.

Как создать интерфейс

1. Раздел «Интерфейсы» → «Новый интерфейс».
2. Задайте название и выберите тип:
   • Чат — диалог с агентом;
   • Форма — поля и один ответ (подходит и для агента, и для workflow).
3. Выберите, что публикуете: агента или workflow. Рядом с недоступными целями стоит пометка «не готов к публикации». Чат работает только с агентом — для workflow выбирайте «Форма».

Редактор

Слева — превью: ровно то, что увидит клиент. Справа — настройки.

• Основное — название, описание, тип, цель, проект.
• Диалог (для чата) — приветствие, подсказка в поле ввода, быстрые вопросы.
• Поля формы — подпись, ключ, тип поля (строка, текст, список, галочка, число), обязательность. Ключ используется в шаблоне запроса: {{ключ}}.
• Оформление — заголовок, подзаголовок, надпись над заголовком, акцентный цвет, светлая/тёмная тема, подпись внизу.

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

Шаблон запроса

Для формы поверх агента поля превращаются в текст запроса. Например:

Клиент: {{company}}
Задача: {{task}}
Объём: {{volume}} тонн

Если шаблон пустой, значения уйдут списком «подпись: значение». Для workflow шаблон не нужен — поля попадут во вход прогона.

Публикация

1. При необходимости укажите домены сайта, откуда интерфейс может работать (через запятую). Пусто — интерфейс доступен с любого сайта, как открытая страница.
2. Нажмите «Опубликовать».

Список доменов можно поправить и позже — кнопкой «Обновить домены»: ссылка и код вставки при этом сохраняются.

Опубликовать можно только готовую цель: агент должен быть опубликован (то есть прошёл проверку качества), workflow — активен. Это то же правило, что защищает все остальные поверхности: непроверенный агент к клиентам не выходит.

После публикации доступны:

• Публичная ссылка вида https://app.cosai.pro/i/<токен> — можно отправить клиенту или разместить в соцсетях;
• Код вставки — тег <iframe> для страницы вашего сайта.

Как снять с публикации

Кнопка «Снять с публикации» отзывает доступ немедленно: ссылка и код вставки перестают работать в тот же момент. Повторная публикация выдаёт новый адрес — старый уже не восстановить, поэтому обновите код вставки на сайте.

Ограничения публичной страницы

• Частота обращений с одного IP ограничена: по умолчанию 40 отправок и 600 проверок статуса за 15 минут (проверки статуса считаются отдельно, чтобы долгий workflow не упирался в лимит собственного ожидания).
• Расход учитывается по вашему тарифу — как и любой другой диалог с агентом; прогоны из формы уменьшают лимит прогонов workflow.
• Наружу не отдаются ни настройки агента, ни данные о вашем расходе, ни внутренние тексты ошибок. Из результата workflow посетитель видит только то, что вы указали в поле «Что показать как результат» (или текст последней ноды) — остальной выход остаётся внутри.

Если публикация нарушена

Если удалить агента, workflow или ключ интерфейса, платформа сама снимает интерфейс с публикации: ссылка перестаёт работать, а в списке появляется отметка «публикация нарушена». Это сделано специально — «опубликован» всегда означает работающую страницу. После восстановления цели опубликуйте интерфейс заново; ссылка при этом изменится, поэтому обновите код вставки на сайте.