## 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. **Системный промпт**
   - Вставьте такой черновик:

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

Твоя задача:
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;
- прежние попытки автоматизации;
- кто именно принимает работу по решению;
- точный допустимый процент дублей в числах;
- детали маршрута передачи спорных случаев.