uchet-zayavok-na-podklyuchen/alem_guide.md

1. Почему Alem, а не отдельная разработка

• Процесс уже описан как агентный: забрать заявку, проверить дубли, сформировать карточку, подготовить сводку.
• Нужен внутренний контур КТ: в брифе прямо сказано, что ПДн клиентов нельзя выносить наружу.
• Есть человеческое подтверждение спорных случаев, а в Alem это поддерживается workflow-узлом «Одобрение пользователя».
• Нужны два канала результата: рабочая панель для менеджеров и Telegram-сводка для Ержана; Alem даёт агента и Published API для подключения панели.
• Ограничения платформы честные: API и точки интеграции Lotus/Excel не подтверждены, поэтому запуск зависит от доступов и ИТ-сопровождения.
• Адрес платформы: https://alem.ai-kt.kz

2. Что делает агент

Агент принимает новые заявки из Lotus и ручных записей, проверяет их на дубли и спорные совпадения, формирует карточку для рабочей панели, а также собирает короткую сводку для Telegram Ержана. Спорные случаи он не закрывает сам: такие заявки помечаются для подтверждения менеджером до финального принятия в работу.

3. Пошаговое создание в Alem

1. Создать супер-сотрудника

   • В Alem создайте нового агента через рабочий путь платформы «Создать супер-сотрудника».
   • Тип агента: агент с подтверждением пользователя, потому что по брифу спорные дубли и сложные случаи должен подтверждать менеджер.

2. Выбрать тип агента

   • Подходит связка: prompt-агент + workflow-логика.
   • Задача агента — читать входящие заявки, сравнивать их с уже известными записями, выдавать рекомендацию и готовить сводку.

3. Системный промпт

   • Вставьте такой черновик:

Ты — ИИ-агент для обработки заявок на подключение в отделе продаж филиала Алматы.

Твоя задача:
1) принимать новые заявки из Lotus sales.almaty@kt.kz и ручные записи менеджеров;
2) искать дубли и спорные совпадения по ФИО, адресу, телефону, тарифу и дате;
3) формировать карточку заявки для рабочего экрана менеджера;
4) готовить короткую сводку для Telegram Ержана Асанова;
5) передавать спорные дубли и сложные случаи человеку на подтверждение до финального принятия заявки в работу.

Источники знаний:
- Lotus-почта sales.almaty@kt.kz;
- Excel-реестр zayavki_2026.xlsx;
- сетевой диск \\ktfs01\sales\заявки;
- поля: ФИО, адрес, тариф, статус, менеджер, дата;
- процесс и правила из брифа инициативы.

Правила ответа:
- Всегда опирайся на факты из брифа и текущих данных.
- Если заявка похожа на дубль, явно укажи, по каким полям совпадение найдено.
- Если совпадение неуверенное, пометь заявку как спорную и передай менеджеру на подтверждение.
- Если данных не хватает, пиши, что это не подтверждено.
- Для сводки в Telegram давай короткий текст: новые, зависшие, спорные и дубли за день.
- Не выносить ПДн наружу и не предлагать внешнюю передачу данных.
- Не закрывать спорные случаи без подтверждения человека.
- Не придумывать API Lotus или Excel, если они не подтверждены.
- Не обещать автоматическое действие там, где нужен человек.

Что не делаешь:
- не отправляешь данные наружу;
- не принимаешь спорные дубли без подтверждения;
- не создаёшь фиктивные записи;
- не меняешь статусы без оснований из данных.

4. База знаний

   • Загрузите в KB документы и материалы, которые уже есть у владельца процесса:
     • бриф инициативы;
     • схему процесса;
     • Excel-реестр zayavki_2026.xlsx как источник структуры полей;
     • регламент или рабочие правила отдела продаж, если они есть;
     • примеры типовых заявок из Lotus, если их можно безопасно использовать внутри контура.
   • Если точные документы ещё не собраны, это нужно подтвердить до запуска.

5. Workflow в Alem

   • Соберите простой поток:
     • Agent: забрать заявку;
     • Agent: проверить дубли;
     • If/Else: дубль или спорный случай?;
     • Узел «Одобрение пользователя» для подтверждения менеджером;
     • Agent: сформировать карточку;
     • Agent: подготовить сводку;
     • выход в Telegram и в Published API для панели.
   • Для спорных случаев маршрут должен останавливаться на подтверждении человека.

6. Канал публикации

   • Для подключения панели используйте точные шаги Alem:
     • в карточке агента нажмите Опубликовать;
     • выберите интерфейс API;
     • платформа создаст API-ключ и покажет эндпоинты и документацию в окне публикации.
   • Контракт:
     • POST /gateway/app/api/v1/published/conversation — создать сессию, получить session_id;
     • POST /gateway/app/api/v1/published/{session_id}/send — отправить сообщение и получить SSE-поток ответа.
   • Именно к этому Published API подключается веб-панель менеджеров.

7. Пример запроса и ответа для панели

   • Пример кейса: новая заявка из Lotus с ФИО, адресом, тарифом и телефоном.
   • Логика агента:
     • создать сессию;
     • передать данные заявки;
     • вернуть рекомендацию: подтвердить, отклонить, доработать;
     • если дубль спорный, отправить на подтверждение менеджеру.
   • Пример ожидаемого результата:
     • карточка заявки;
     • флаг дубля, если найдено совпадение;
     • короткое объяснение, почему заявка спорная;
     • статус для панели и сводки.

8. Telegram-сводка

   • Отдельно настройте выход для Ержана Асанова:
     • новые заявки;
     • зависшие заявки;
     • спорные дубли;
     • заявки, которые уже взяты в работу.
   • Сводка должна быть короткой и без лишних деталей.

4. Примеры поведения

Вопрос: Что делать, если заявка пришла из Lotus sales.almaty@kt.kz, но ФИО написано иначе, а телефон совпадает?
Ожидаемый ответ: Пометить как спорный дубль и передать менеджеру на подтверждение до финального принятия в работу.

Вопрос: Что делать, если письмо с сайта попало в спам общего ящика?
Ожидаемый ответ: Забрать заявку в общий поток, создать карточку и показать её в рабочем списке, чтобы она не потерялась.

Вопрос: Что должно попасть в сводку Ержана утром?
Ожидаемый ответ: Короткий список новых, зависших и спорных заявок за день, без ручного сбора.

5. Как принять работу

• Подтверждён рабочий путь публикации агента в Alem.
• Подтверждён сценарий с человеческим решением для спорных дублей.
• Подтверждены источники знаний: Lotus sales.almaty@kt.kz, Excel zayavki_2026.xlsx, сетевой диск \ktfs01\sales\заявки.
• Подтверждён формат сводки для Telegram Ержана.
• Подтверждён внутренний контур КТ и запрет на внешнюю передачу данных.
• Подтверждены критерии качества: заявка берётся в работу не позже 30 минут, дубли удерживаются в пределах пары процентов.
• Подтверждён baseline по числу заявок за прошлую неделю через Динару из Excel.
• Подтверждено, кто именно и по какому правилу помечает заявку спорной и отдаёт её менеджеру.
• Подтверждено точное название и точка входа рабочего экрана для менеджеров по заявкам из Lotus и Excel.

Блокеры маршрута до запуска:

• точная цифра заявок за прошлую неделю;
• API или иные точки интеграции у Lotus и Excel;
• прежние попытки автоматизации;
• кто именно принимает работу по решению;
• точный допустимый процент дублей в числах;
• детали маршрута передачи спорных случаев.