Шаг 1. Войдите на https://agentflow.bailanys.kz — email admin@agentflow.kz, пароль — который задан при настройке.

Шаг 2. Перейдите в раздел Bitrix24 (левое меню) → проверьте статус подключения (должно быть ✅).

Шаг 3. Откройте раздел Агенты → проверьте что агент "Продажи" настроен и активен.

Шаг 4. Откройте Bitrix24 → напишите в любую Открытую линию → бот должен ответить автоматически.

Шаг 5. Войдите в раздел Чаты Б24 — увидите входящий диалог с ответом бота.

Установка приложения:

1. В Bitrix24: Приложения → Разработчикам → Другое → Локальное приложение
2. URL обработчика: https://agentflow.bailanys.kz/b24-app/install?ws=d8268cc9-c3c2-4042-82d3-27c4f4d1b3a3
3. URL установки (тот же). Нажмите Сохранить.
4. Откройте приложение в B24 — появится "AgentFlow установлен ✅ Бот зарегистрирован"

Если бот не отвечает:

1. Перейдите в раздел Bitrix24 в этой панели
2. Проверьте статус — должно быть "Ping: OK"
3. Если нет — нажмите "Переустановить" в B24
4. Убедитесь что в Открытой линии выбран бот "AgentFlow AI"

Bitrix24 → Контакт-центр → Открытые линии → Выберите нужную → Вкладка "Чат-бот" → Выберите "AgentFlow AI" → Сохранить.

После привязки любое сообщение в эту линию будет обработано AI-ботом.

Бот автоматически:

• Квалифицирует обращение (Брак / Повреждения / Справочное)
• Обновляет лид в CRM (NAME, PHONE, EMAIL, COMMENTS)
• Уведомляет оператора Наурыз

Агент — это AI-бот с настроенным поведением. В системе уже есть агент "Продажи" для Казахтелеком.

Создать нового:

1. Меню → Агенты → "+ Создать агента"
2. Заполните: Имя, Провайдер (OpenAI/Anthropic), Модель (gpt-4o-mini)
3. API-ключ: вставьте ключ от OpenAI (sk-proj-...)
4. Системный промт: опишите роль и поведение бота
5. Нажмите "Сохранить"

Советы по системному промту:

• Начните с "Ты — [роль] компании [название]"
• Укажите что делать и чего НЕ делать
• Добавьте примеры ответов
• Длина: 1000-5000 символов — оптимально

Меню → Тест-консоль → выберите агента в дропдауне → введите вопрос → нажмите Enter.

Вы увидите реальный ответ AI, стоимость запроса и время ответа.

Если ответ плохой — нажмите 👎 под ответом и укажите как должно быть. AI учтёт это в следующих диалогах.

Раздел "Чаты Б24" показывает все входящие диалоги из Bitrix24 в реальном времени.

Фильтры: Все / Брак / Повреждения / Справочное

Открыть чат: нажмите на строку — справа откроется история и CRM-панель с данными лида.

Кнопки управления:

• 🙋 Взять — вы берёте диалог, бот перестаёт отвечать
• ⤴ Вернуть боту — бот снова отвечает
• ⚡ AI ответ — получить подсказку от AI не отправляя клиенту

Заметки: видны только команде, не клиенту. Добавляйте пометки для передачи дел.

После каждого ответа AI в Тест-консоли вы видите кнопки 👍 и 👎.

Как учить AI:

1. Откройте Тест-консоль, задайте вопрос
2. Если ответ плохой — нажмите 👎
3. В диалоге укажите: категорию проблемы и как должен был ответить AI
4. Нажмите "Сохранить коррекцию"
5. Правило сразу добавляется в системный промт агента

Управление правилами: Меню → RLHF Обучение → список активных правил с возможностью архивации.

Рекомендуем создать 10-20 правил за первую неделю работы — это значительно улучшит качество ответов.

База знаний позволяет AI искать информацию в ваших документах при ответах.

Добавление документов:

1. Меню → База знаний → "＋ Коллекция" (создайте группу документов)
2. Выберите созданную коллекцию
3. Нажмите "📁 Выбрать файл" — поддерживается PDF, DOCX, TXT, MD (до 25 МБ)
4. Документ загружается и индексируется (1-2 минуты)
5. Нажмите "Привязать агент" — выберите агента из списка

Проверка: В тест-консоли задайте вопрос из загруженного документа — AI ответит используя его.

Добавить сотрудника:

1. Меню → Пользователи → "+ Добавить сотрудника"
2. Заполните: Имя, Email, Пароль (мин. 4 символа), Роль
3. Нажмите "Создать"
4. Сотрудник получит доступ с этим email/паролем

Роли:

• Администратор — полный доступ, управление пользователями
• Менеджер — работа с агентами, чатами, базой знаний
• Оператор — только просмотр чатов и работа с клиентами
• Наблюдатель — только чтение данных

Сменить пароль: нажмите на своё имя внизу меню → "Сменить пароль".

Выйти из системы: нажмите на своё имя → "Выйти".

AI настройки:

• Дефолтная модель — gpt-4o (лучше) или gpt-4o-mini (дешевле)
• Температура — 0.7 оптимально. 0 = строгие ответы, 1 = творческие
• Макс. токенов — длина ответа. 1500 обычно достаточно

Webhook URL для B24:

Этот адрес нужно указать в настройках Bitrix24 Open Lines как URL обработчика событий.