Настройка AI-консультанта

📋 Что нужно для запуска

1. OpenAI API ключ - получить на https://platform.openai.com/api-keys
2. Cloudflare Workers (бесплатный план) - для прокси API запросов
3. Конфигурационный файл с промптами

🚀 Пошаговая инструкция

Шаг 1: Получить OpenAI API ключ

1. Зарегистрируйтесь на https://platform.openai.com/
2. Перейдите в раздел API Keys
3. Создайте новый ключ (Secret Key)
4. Скопируйте ключ (он показывается только один раз!)

Стоимость:

• GPT-3.5-turbo: ~$0.002 за 1000 токенов (дёшево)
• GPT-4-turbo: ~$0.01 за 1000 токенов (дороже, но умнее)

Шаг 2: Настроить Cloudflare Worker

Cloudflare Worker нужен для:

• Скрытия API ключа от клиентов
• Защиты от злоупотреблений (rate limiting)
• Кеширования ответов

Инструкция:

1. Зарегистрируйтесь на https://dash.cloudflare.com/
2. Перейдите в Workers & Pages
3. Создайте новый Worker
4. Скопируйте код из /cloudflare-worker/worker.js
5. Замените YOUR_OPENAI_API_KEY на ваш ключ
6. Деплойте Worker
7. Скопируйте URL Worker (например: https://ai-chat.your-name.workers.dev)

Шаг 3: Настроить конфиг на сайте

1. Скопируйте ai-config.template.js в ai-config.js:

   cp assets/js/ai-config.template.js assets/js/ai-config.js
   

2. Откройте ai-config.js и заполните:

   apiKey: 'sk-...' // Ваш OpenAI ключ
   

3. В файле assets/js/ai-chat.js замените:

   const WORKER_URL = 'https://ai-chat.your-name.workers.dev';
   

Шаг 4: Проверить работу

1. Откройте сайт
2. Кликните на кнопку чата
3. Напишите тестовое сообщение
4. Проверьте ответ AI

🔒 Безопасность

✅ Что сделано:

1. ai-config.js в .gitignore - файл с ключами не попадёт в Git
2. Cloudflare Worker - API ключ скрыт на сервере
3. Rate Limiting - ограничение запросов (10/мин, 50/час)
4. Валидация - проверка длины сообщений (макс 500 символов)

⚠️ Важно:

• НИКОГДА не коммитьте ai-config.js с реальным ключом
• Используйте только ai-config.template.js для Git
• Храните ключи в переменных окружения на сервере
• Мониторьте расходы на OpenAI Dashboard

💰 Оптимизация расходов

Рекомендации:

1. Используйте GPT-3.5-turbo для начала (в 5 раз дешевле GPT-4)
2. Ограничьте maxTokens до 500 (короткие ответы)
3. Кешируйте частые вопросы в Worker
4. Установите лимиты на количество запросов
5. Мониторьте расходы в OpenAI Dashboard

Примерные расходы:

При 100 запросах в день с GPT-3.5-turbo:

• ~30,000 токенов в день
• ~$0.06 в день
• ~$1.80 в месяц

📊 Мониторинг

Что отслеживать:

1. OpenAI Dashboard - расходы и использование
2. Cloudflare Analytics - количество запросов
3. Browser Console - ошибки на клиенте
4. Worker Logs - ошибки на сервере

🛠️ Troubleshooting

Проблема: “Ошибка сервера”

Решение:

1. Проверьте API ключ в Worker
2. Проверьте баланс на OpenAI
3. Проверьте WORKER_URL в ai-chat.js

Проблема: “429 Too Many Requests”

Решение:

1. Увеличьте лимиты в Worker
2. Добавьте кеширование
3. Проверьте не спамит ли кто-то

Проблема: AI отвечает не по теме

Решение:

1. Улучшите systemPrompt в ai-config.js
2. Добавьте больше примеров
3. Увеличьте temperature для креативности

📝 Кастомизация промптов

Как улучшить ответы AI:

1. Добавьте больше примеров в systemPrompt
2. Укажите конкретные цены и характеристики
3. Добавьте FAQ в contextPrompts
4. Используйте quickAnswers для частых вопросов

Пример улучшения:

systemPrompt: `
...
ПРИМЕРЫ ОТВЕТОВ:

Вопрос: "Сколько стоит резка стали?"
Ответ: "Резка стали от 80₽/пог.м. Точная цена зависит от толщины и сложности. Воспользуйтесь калькулятором 📐"
...
`

🎯 Следующие шаги

1. ✅ Получить OpenAI API ключ
2. ✅ Настроить Cloudflare Worker
3. ✅ Заполнить ai-config.js
4. ✅ Протестировать чат
5. ⬜ Мониторить расходы
6. ⬜ Оптимизировать промпты
7. ⬜ Добавить аналитику

📞 Поддержка

Если возникли проблемы:

1. Проверьте консоль браузера (F12)
2. Проверьте логи Cloudflare Worker
3. Проверьте баланс OpenAI
4. Напишите в поддержку OpenAI

Важно: Этот AI-консультант работает 24/7 и может обрабатывать базовые вопросы. Для сложных случаев он предложит позвонить или оставить заявку.