Email-агент для Автошколы (Google Gemini 1.5 Flash)

Этот проект автоматизирует ответы на типичные вопросы учеников автошколы, используя базу знаний, созданную из истории переписки.

Структура

• src/agent.py: Основной скрипт. Читает входящие письма и отвечает на типичные вопросы.
• src/kb_builder.py: Скрипт для создания базы знаний. Анализирует историю писем и создает .md файлы в папках.
• knowledge_base/: Папка с базой знаний (создается автоматически).
• .env: Файл с настройками и ключами (создайте на основе .env.example).

Установка

1. Установите зависимости:

   pip install -r requirements.txt

2. Настройте файл .env:

   • Получите API ключ в Google AI Studio.
   • Укажите настройки IMAP/SMTP своего домена.

Использование

1. Создание базы знаний

Запустите скрипт, чтобы проанализировать историю писем (например, за последние 90 дней) и создать структуру базы знаний:

python src/kb_builder.py

После этого в папке knowledge_base/ появятся подпапки с файлами qa.md. Вы можете отредактировать их вручную, чтобы уточнить ответы.

2. Запуск агента

Запустите агента для мониторинга входящей почты:

python src/agent.py

Агент будет проверять почту каждые 3 минуты. Если вопрос типичный, он отправит ответ. Если нет — письмо останется непрочитанным (или вы можете изменить логику в коде).

Особенности

• Использует Gemini 1.5 Flash для быстрого и дешевого анализа.
• Поддерживает структурированную базу знаний в формате Markdown.
• Автоматически определяет "типовые" вопросы и умеет пропускать сложные случаи.