137 lines
12 KiB
Markdown
137 lines
12 KiB
Markdown
## 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;
|
||
- прежние попытки автоматизации;
|
||
- кто именно принимает работу по решению;
|
||
- точный допустимый процент дублей в числах;
|
||
- детали маршрута передачи спорных случаев. |