Создание агента
Пошаговое руководство по созданию вашего первого ИИ-агента в Framix
Создание агента
Шаг 1. Открыть раздел
Перейдите в Личный кабинет → ИИ-агенты и нажмите кнопку «Создать агента».
В диалоге создания сверху будет галерея шаблонов:
- Поддержка клиентов
- Консультант магазина
- Квалификация лидов
- FAQ-помощник
- Запись на услугу
- SaaS-онбординг
- С чистого листа
Кликни по подходящему — системный промпт и приветственное сообщение подставятся автоматически. Подробнее о каждом — в разделе Безопасность и UX → Шаблоны.
Если ничего не подходит — выбери «С чистого листа» и заполни сам.
Шаг 2. Основные настройки
В первом блоке задаются базовые параметры:
- Активен — переключатель. Когда выключен, агент не отвечает на запросы (через виджет и API). Удобно для временной паузы без удаления.
- Название — внутреннее имя в личном кабинете (посетители его не видят, если не указали явно в виджете).
- Описание — заметка для себя, чтобы не путать агентов.
Шаг 3. Системный промпт
Это самая важная часть. Системный промпт определяет, как ваш агент общается с людьми и что он должен делать.
Хороший промпт включает:
- Роль — кто это («Ты — консультант магазина X»).
- Задачи — что должен делать («Помогай выбирать товары, отвечай на вопросы о доставке»).
- Тон — как общаться («Дружелюбно, на «вы», без лишнего официоза»).
- Ограничения — чего НЕ должен делать («Не обещай скидок, не давай юридических консультаций»).
- Действие при тупике — что сказать, если не знает («Если вопрос не из твоей области — предложи связаться с менеджером по почте sales@...»).
Пример:
Ты — Алиса, ассистент онлайн-школы английского языка SkyEnglish.
Твои задачи:
- Помогать выбрать подходящий курс по уровню (A1–C1)
- Рассказывать о ценах и форматах занятий (онлайн, групповые, индивидуальные)
- Записывать на бесплатный пробный урок (попроси email и удобное время)
- Отвечать на вопросы по школе из базы знаний
Стиль общения:
- На "ты", дружелюбно, без формализма
- Короткие сообщения (1–3 предложения), без воды
- Используй emoji умеренно (1 на сообщение максимум)
Чего НЕ делать:
- Не обещай скидок, которых нет в базе знаний
- Не выдумывай преподавателей и курсы
- Не отвечай на вопросы вне темы школы (вежливо переводи разговор)
Если не знаешь ответа — скажи "честно, не знаю, спроси у менеджера: hello@skyenglish.ru".
Шаг 4. Приветственное сообщение
Текст, который посетитель видит первым при открытии чата. Например: «Привет! Я Алиса, помогаю выбрать курс английского. Расскажи, какой у тебя уровень?»
Если оставить пустым — чат откроется без приветствия.
Шаг 5. Модель
Перейдите на вкладку «Модель». Там три карточки:
- Быстрая — дешевле и шустрее, подходит для простых вопросов и большого потока сообщений.
- Умная — качественнее и точнее, для сложных диалогов и нестандартных вопросов.
- Максимальная — топовая модель для самых сложных задач и требовательных клиентов.
Конкретные модели за каждым тиром определяет администрация Framix и иногда обновляет — для вас это прозрачно: выбрали «Умная», агент всегда будет на актуальной умной модели.
Подробнее о выборе — в разделе Модели и расходы.
Шаг 6. База знаний (опционально)
Если у вас есть FAQ, описание продукта, прайс — загрузите их во вкладке «Настройки» → блок «База знаний». Поддерживаются .txt, .md, .json, .csv и другие текстовые форматы.
Подробнее — в разделе База знаний.
Шаг 6.5. Каталог и услуги (опционально)
Если у вас есть товары или услуги в группе, в карточке агента появляется блок «Каталог». Здесь:
- настраивается видимость агента для товаров (
product_agent_visibility) и услуг (service_agent_visibility); - выбирается мерчант-аккаунт, через который пройдут оплаты в чате (см. Мерчанты).
Когда видимый каталог не пуст, агенту автоматически доступны commerce/booking-tools (search_products, create_order, search_services, book_appointment) — никаких дополнительных шагов в промпте не нужно, система сама подключит. Подробнее: Продажи через AI-агента и Запись на услуги через агента.
Шаг 7. Лимиты расходов
В блоке «Лимиты расходов» можно задать:
- Дневной лимит — например, 100 ₽/день. После достижения бот отвечает «Лимит исчерпан» до начала следующего дня.
- Недельный — например, 500 ₽/неделю.
- Месячный — например, 2000 ₽/месяц.
Все лимиты в рублях. Можно использовать любую комбинацию (или вообще без них). Защищает от внезапных расходов, если кто-то начнёт спамить бота.
Шаг 8. Режим продавца (опционально)
В блоке «Безопасность и UX» — тумблер «Режим продавца». По умолчанию включён.
Когда включён, агент не просто отвечает на вопросы, а проактивно ведёт посетителя к целевому действию: предлагает подходящий вариант, уточняет потребности (один короткий вопрос за раз), отрабатывает сомнения и заканчивает ответ одним мягким CTA («Оформить?», «Показать свободное время?»).
Когда выключить: для справочных агентов и линии поддержки, где навязчивые предложения раздражают. Например, help-bot в личном кабинете или технический FAQ.
Агент никогда не выдумывает скидки, дефицит или сроки акций — только факты из каталога и базы знаний.
Шаг 9. Инбокс диалогов
На вкладке «Диалоги» вы читаете реальную переписку агента с посетителями. Если нужно — подключаетесь к чату вручную:
- Откройте любую сессию.
- Нажмите «Подключиться к чату» — агент замолкает, вы ведёте беседу от своего имени.
- Рядом с полем ввода есть кнопка «Улучшить с ИИ» — она переписывает ваш черновик с учётом контекста разговора (DeepSeek V4 Flash). Результат подставляется в поле, клиенту ничего не отправляется автоматически — вы решаете, отправлять или нет.
- Чтобы вернуть управление агенту — нажмите «Передать боту».
Подробнее — в разделе Аналитика и диалоги.
Шаг 10. Сохранить и протестировать
Нажмите «Сохранить». Перейдите на вкладку «Тестовый чат» и пообщайтесь с агентом — это быстрый способ проверить, как он отвечает, до встраивания на сайт.
Тестовые сообщения списываются с вашего баланса так же, как реальные.
Что дальше
- Workflow-сценарии — если нужен пошаговый сбор данных вместо свободной консультации.
- Интеграции — Telegram и VK, тот же агент в трёх каналах.
- Тренировка агента — лайки/дизлайки, training examples, retrieval по embeddings.
- Виджет на сайте — встраивание на ваш сайт.
- API агента — интеграция в приложения и сторонние системы.
- Аналитика — посмотреть, кто и о чём общается с ботом.