Паспорт проекта «РМ-Консультант»
Курсовой проект: агентская система поддержки клиентов интернет-магазина restomoda.ru. Паспорт только дополняется новыми разделами, уже сданные разделы по смыслу не переписываются.
Пометка
[уточнить]— черновик: цифру или формулировку должен подтвердить владелец.
Раздел 0. О проекте
| # | Вопрос | Ответ |
|---|---|---|
| 1 | Как называется проект | РМ-Консультант: агент поддержки клиентов restomoda.ru в Telegram |
| 2 | Что он делает, одной фразой | Отвечает покупателям в Telegram по базе магазина: условия доставки, оплаты и гарантии, наличие и цены оборудования, подбор моделей по параметрам и аналогов из наличия. Сложные и спорные вопросы передаёт менеджеру. |
| 3 | Кто им будет пользоваться, кроме вас | Покупатели restomoda.ru: рестораны, кафе, столовые, пекарни и частные клиенты, которые пишут в Telegram. Менеджеры магазина, которые получают от агента переданные диалоги с кратким резюме вопроса. |
| 4 | Какую задачу он снимает и сколько времени она отнимает сейчас | Менеджеры вручную отвечают на однотипные вопросы: «сколько стоит доставка в …», «есть ли в наличии артикул …», «чем заменить …», «какая гарантия». Сейчас это примерно [уточнить: N обращений в день × M минут ≈ X часов в неделю]. Вечером и в выходные клиент ждёт ответа до следующего рабочего дня и часть заявок теряется [уточнить]. |
| 5 | Как вы поймёте, что он работает | 1) На тестовом наборе из 50 реальных вопросов клиентов агент верно отвечает минимум на 85 % вопросов по правилам магазина и наличию. 2) Агент ни разу не выдумывает модель, цену, наличие или характеристику: только данные из базы, иначе передаёт человеку. 3) Сложные вопросы уходят менеджеру с резюме, а клиент получает понятное сообщение о сроке ответа. 4) В пилоте агент закрывает без человека не меньше [уточнить: 40–50 %] обращений. |
Раздел 1. Рабочее место и план
Структура раздела составлена по пунктам задания (шаги 2–8), шаблон курса ещё не получен [уточнить по шаблону].
1.1 Рабочее место
- Claude Code и VS Code на VPS владельца, у агента отдельный пользователь Linux. Сделано.
- У проекта своя папка
rm_agentсCLAUDE.md,.claude/settings.jsonи документацией вdocs/.
1.2 Из чего состоит система (план)
| Часть | Что это | Откуда данные |
|---|---|---|
| Чат (видимая часть) | Telegram-бот магазина | — |
| Агент (думающая часть) | LLM-агент с инструментами: поиск по базе знаний, поиск товара, подбор аналогов, передача человеку | — |
| База знаний о правилах | Доставка (сроки, стоимость, география), оплата, гарантия, возврат, типовые ответы | Страницы restomoda.ru и материалы владельца |
| Цены и наличие | Только чтение | Portal_new (портал цен, этот сервер) |
| Знания о товаре | Характеристики и описания товаров, только чтение | Контент-ферма (content_farm, сервер srv5) |
| Передача человеку | Уведомление менеджеру с резюме диалога, сообщение клиенту о рабочем времени | — |
1.3 CLAUDE.md
Файл CLAUDE.md в корне проекта. В нём описано: что за проект, источники данных и их адреса, главное правило агента («отвечать только по базе, не выдумывать») и порядок работы по шагам курса.
1.4 Права агента (.claude/settings.json)
- Без спроса: читать и править файлы проекта, смотреть файлы Portal_new и restomoda-shared, безопасные команды (
ls,grep,git status/diff/log), запускать тесты. - Со спросом: любой вход на серверы по
ssh,git push, запуск контейнеров,sudo, установка пакетов. - Никогда: читать
.envи ключи; править код Portal_new; трогать папки второго агента на сервере (Codex);rm -rf; удалять тома Docker;docker compose down -v;git push --force.
1.5 Скилл, внешний инструмент, субагент
Отложено (шаги 5–7). Кандидаты, когда появится код: - скилл: «прогнать тестовый набор вопросов и показать, где агент ошибся»; - внешний инструмент: доступ на чтение к данным товаров (наличие и цены из Portal_new, характеристики из content_farm); - субагент: разбор длинных логов диалогов и выгрузок каталога.
1.6 План проекта (шаг 8)
- База знаний по правилам магазина: собрать и согласовать тексты (доставка, оплата, гарантия, возврат, регионы). ← начинаем отсюда
- Данные о товарах: договориться, как агент читает наличие и цены (Portal_new) и характеристики (content_farm). Только чтение.
- Тестовый набор: 50 реальных вопросов клиентов с эталонными ответами и пометкой «передать человеку».
- Ядро агента: ответы по правилам, поиск по артикулу и модели, подбор по параметрам и аналогов из наличия; прогон по тестовому набору.
- Передача человеку: критерии «спорного», уведомление менеджеру, ответ клиенту про рабочее время.
- Telegram-бот: подключение, история диалога, журнал.
- Пилот: запуск на ограниченной группе, разбор диалогов, доработка, замер метрик из раздела 0.
- (позже) Оформление заказа через бота.