Skip to content

BYOK_EXAMPLES.md

Latest commit

 

History

History
502 lines (322 loc) · 14.6 KB

BYOK_EXAMPLES.md

File metadata and controls

502 lines (322 loc) · 14.6 KB

📝 Примеры использования AI Tutor BYOK

Этот документ содержит практические примеры использования приложения AI Tutor с функционалом BYOK.

Пример 1: Первый запуск и настройка

Шаг 1: Запуск приложения

streamlit run app_byok.py

Шаг 2: Ввод API ключа

  1. Откройте expander "🔑 Настройки API" в левой панели
  2. Вставьте ваш API ключ в поле (например: sk-proj-abcd1234...)
  3. Нажмите "💾 Сохранить ключ"
  4. Увидите: "✅ Ключ сохранён. Можно работать."

Шаг 3: Первый запрос

Введите в поле ввода:

Объясни, что такое квантовая физика простыми словами

Модель ответит понятным объяснением с учётом текущей температуры.

Пример 2: Работа с разными моделями

Задача: Сравнить ответы разных моделей

Тест 1: gpt-3.5-turbo (самая дешёвая)

Настройки:

  • Модель: gpt-3.5-turbo
  • Температура: 0.7

Запрос:

Напиши короткое стихотворение о весне

Ожидаемый результат: Быстрый ответ, простое стихотворение (4-8 строк)

Тест 2: gpt-4o-mini (оптимальная)

Настройки:

  • Модель: gpt-4o-mini
  • Температура: 0.7

Запрос:

Напиши короткое стихотворение о весне

Ожидаемый результат: Более качественное стихотворение с рифмой и ритмом

Тест 3: gpt-4o (самая мощная)

Настройки:

  • Модель: gpt-4o
  • Температура: 0.7

Запрос:

Напиши короткое стихотворение о весне

Ожидаемый результат: Профессиональное стихотворение с глубоким смыслом

Пример 3: Настройка температуры

Сценарий A: Фактические вопросы (низкая температура)

Настройки:

  • Модель: gpt-4o-mini
  • Температура: 0.2

Запрос:

Какая столица Франции?

Результат:

Столица Франции — Париж.

Короткий, точный, детерминированный ответ.

Сценарий B: Творческие задачи (высокая температура)

Настройки:

  • Модель: gpt-4o-mini
  • Температура: 0.9

Запрос:

Придумай короткую сказку о роботе, который мечтал стать художником

Результат: Креативная, уникальная история с неожиданным сюжетом.

Сценарий C: Программирование (средняя температура)

Настройки:

  • Модель: gpt-4o-mini
  • Температура: 0.5

Запрос:

Напиши функцию на Python для сортировки списка методом пузырька

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

Пример 4: Управление несколькими чатами

Сценарий: Работа над разными проектами

Чат 1: "Изучение Python"

Запросы:

  1. Что такое list comprehension в Python?
  2. Покажи примеры использования list comprehension
  3. Как сделать nested list comprehension?

Чат 2: "Математика"

Создайте новый чат (🆕 Новый чат)

Запросы:

  1. Объясни теорему Пифагора
  2. Где применяется теорема Пифагора в реальной жизни?
  3. Реши задачу: найди гипотенузу треугольника со сторонами 3 и 4

Чат 3: "Рецепты"

Создайте новый чат (🆕 Новый чат)

Запросы:

  1. Дай рецепт пиццы Маргарита
  2. Как приготовить тесто для пиццы?
  3. Какие альтернативы моцарелле можно использовать?

Результат: Три независимых диалога, между которыми можно легко переключаться.

Пример 5: Длинный диалог с контекстом

Задача: Написание статьи с помощью AI

Настройки:

  • Модель: gpt-4o-mini
  • Температура: 0.7

Запрос 1: Планирование

Помоги написать статью на тему "Искусственный интеллект в медицине".
Предложи структуру статьи.

Ответ модели:

1. Введение
2. История применения ИИ в медицине
3. Текущие применения
   - Диагностика
   - Персонализированная медицина
   - Роботизированная хирургия
4. Преимущества
5. Вызовы и этические вопросы
6. Будущее ИИ в медицине
7. Заключение

Запрос 2: Написание введения

Напиши введение для этой статьи (2-3 абзаца)

Ответ: Модель помнит контекст предыдущего сообщения и напишет введение по предложенной структуре.

Запрос 3: Развитие темы

Теперь напиши раздел "Текущие применения" с примерами

Ответ: Модель продолжает работу над статьёй, сохраняя стиль и контекст.

Пример 6: Кодирование с помощью AI

Задача: Создание Flask приложения

Настройки:

  • Модель: gpt-4o
  • Температура: 0.4

Запрос 1: Базовая структура

Создай базовое Flask приложение с маршрутами для:
- Главной страницы (/)
- Страницы "О нас" (/about)
- API эндпоинта для получения данных (/api/data)

Ответ: Модель предоставит полный код Flask приложения.

Запрос 2: Добавление функционала

Добавь к этому приложению подключение к SQLite базе данных
и модель User с полями: id, username, email

Ответ: Модель расширит код, добавив SQLAlchemy и модель User.

Запрос 3: Тестирование

Напиши unit-тесты для этого приложения используя pytest

Ответ: Модель создаст файл с тестами, учитывая предыдущий код.

Пример 7: Анализ и исправление кода

Задача: Найти баг в коде

Настройки:

  • Модель: gpt-4o-mini
  • Температура: 0.3

Запрос:

Найди ошибку в этом коде:

def calculate_average(numbers):
    total = 0
    for num in numbers:
        total += num
    return total / len(numbers)

# Тест
result = calculate_average([])
print(result)

Ответ модели:

Проблема: division by zero при пустом списке.

Исправленный код:

def calculate_average(numbers):
    if not numbers:
        return 0
    total = 0
    for num in numbers:
        total += num
    return total / len(numbers)

Пример 8: Перевод и объяснение

Задача: Перевести и объяснить технический текст

Настройки:

  • Модель: gpt-4o-mini
  • Температура: 0.5

Запрос:

Переведи на русский и объясни простыми словами:

"A hash table is a data structure that implements an associative array,
a structure that can map keys to values. It uses a hash function to
compute an index into an array of buckets or slots, from which the
desired value can be found."

Ответ модели:

Перевод:
"Хеш-таблица — это структура данных, которая реализует ассоциативный
массив, структуру, способную сопоставлять ключи значениям. Она
использует хеш-функцию для вычисления индекса в массиве сегментов,
из которого можно найти нужное значение."

Простыми словами:
Представь телефонную книгу, где вместо перелистывания всех страниц,
ты используешь специальную формулу (хеш-функцию), которая сразу
говорит, на какой странице искать нужный номер. Это делает поиск
очень быстрым!

Пример 9: Генерация контента

Задача: Создать контент для социальных сетей

Настройки:

  • Модель: gpt-4o-mini
  • Температура: 0.8

Пост для Instagram

Напиши креативный пост для Instagram о новом кафе "Утренний бриз",
которое специализируется на авторском кофе и домашней выпечке.
Добавь хештеги.

Пост для LinkedIn

Напиши профессиональный пост для LinkedIn о запуске нового
SaaS продукта для автоматизации email-маркетинга.

Tweet

Напиши краткий tweet (до 280 символов) о важности кибербезопасности.

Пример 10: Обучение и объяснение

Задача: Изучить новую тему

Настройки:

  • Модель: gpt-4o-mini
  • Температура: 0.6

Диалог:

Пользователь:

Объясни, что такое блокчейн

AI:

Блокчейн — это децентрализованная база данных, где информация
хранится в "блоках", связанных в цепочку. Каждый блок содержит
данные о транзакциях и ссылку на предыдущий блок...

Пользователь:

А как это связано с криптовалютами?

AI:

Криптовалюты, такие как Bitcoin, используют блокчейн для записи
всех транзакций. Когда вы отправляете Bitcoin другому человеку...

Пользователь:

Можно ли использовать блокчейн не для криптовалют?

AI:

Да! Блокчейн применяется во многих областях:
1. Управление цепочками поставок
2. Медицинские записи
3. Системы голосования
...

Пример 11: Очистка ключа после работы

Безопасное завершение сессии

Шаг 1: После окончания работы откройте "🔑 Настройки API"

Шаг 2: Нажмите "🗑️ Очистить ключ"

Шаг 3: Увидите уведомление: "🔄 Ключ удалён из сессии"

Шаг 4: Закройте вкладку браузера

Результат: API ключ полностью удалён из памяти.

Советы по эффективному использованию

✅ Хорошие практики

  1. Будьте конкретны:

    • ❌ "Расскажи о Python"
    • ✅ "Объясни разницу между списком и кортежем в Python с примерами"

  2. Разбивайте сложные задачи:

    • ❌ "Создай полноценный интернет-магазин"
    • ✅ "Шаг 1: Создай структуру базы данных для интернет-магазина"

  3. Используйте контекст:

    • Модель помнит предыдущие сообщения в чате
    • Можно ссылаться на ранее упомянутое: "Улучши этот код"

  4. Экспериментируйте с температурой:

    • Точность: 0.2-0.4
    • Баланс: 0.5-0.7
    • Креативность: 0.8-1.0

❌ Чего избегать

  1. Не отправляйте конфиденциальные данные:

    • Пароли, API ключи, персональные данные
    • Коммерческую тайну

  2. Не полагайтесь на 100% точность:

    • Всегда проверяйте фактическую информацию
    • Особенно в медицине, юриспруденции, финансах

  3. Не создавайте слишком длинные диалоги:

    • Каждое сообщение в истории = дополнительные токены
    • Создавайте новый чат для новой темы

Приятного использования! 🚀

Экспериментируйте с настройками и находите оптимальные параметры для ваших задач!