docs/QUICK_START_PROMPTS.md

# Швидкий старт: Редагування промптів

## Як користуватись

### 1. Відкрийте вкладку "⚙️ Налаштування"

У головному інтерфейсі додатку перейдіть до четвертої вкладки "⚙️ Налаштування"

### 2. Редагуйте промпти

Ви побачите три великих текстових поля:

**📋 Системний промпт** - визначає роль AI
```
Ти - кваліфікований юрист-аналітик, експерт з правових позицій...
```

**⚖️ Промпт генерації** - шаблон для створення правових позицій
```
Дотримуйся цих інструкцій...
{court_decision_text}
{comment}
```

**🔍 Промпт аналізу** - шаблон для порівняння позицій
```
Ваше завдання - проаналізувати...
{query}
{question}
{context_str}
```

### 3. Збережіть зміни

Натисніть кнопку **"💾 Зберегти промпти"**

Ви побачите повідомлення: "✅ Промпти успішно збережено для вашої сесії"

### 4. Використовуйте кастомні промпти

Тепер при генерації правових позицій будуть використовуватись ваші промпти!

Поверніться до вкладки **"💡 Генерація"** та створіть нову правову позицію - вона буде згенерована з вашими налаштуваннями.

### 5. Скидання до стандартних (опціонально)

Якщо хочете повернути початкові промпти, натисніть **"🔄 Скинути до стандартних"**

## Важливо знати

### ⏰ Тривалість сесії

Ваші налаштування зберігаються **тільки на час поточної сесії** (30 хвилин без активності).

Після закриття браузера або таймауту промпти скидаються до стандартних.

### 👥 Ізоляція користувачів

Кожен користувач має **свої власні** налаштування промптів.

Ваші зміни **НЕ впливають** на інших користувачів (навіть на тому ж сервері).

### 📏 Обмеження

- Максимальна довжина кожного промпту: **50,000 символів**
- Необхідно зберігати плейсхолдери (наприклад, `{court_decision_text}`)

## Приклади використання

### Приклад 1: Зміна стилю на більш формальний

**Системний промпт:**
```
Ви - висококваліфікований експерт-правознавець з міжнародним досвідом.
Дотримуйтесь найвищих стандартів юридичної точності та академічної строгості.
Використовуйте лише офіційну юридичну термінологію.
```

### Приклад 2: Фокус на певному типі справ

**Промпт генерації (для цивільних справ):**
```
Дотримуйся цих інструкцій.

СПЕЦІАЛЬНІ ВИМОГИ ДЛЯ ЦИВІЛЬНИХ СПРАВ:
1. Обов'язково виділяй позиції щодо процесуальних питань
2. Зазначай застосовані норми ЦПК України
3. Вказуй склад суду та рівень юрисдикції
4. Виділяй мотивувальну частину рішення

Далі стандартні інструкції:

<court_decision>
{court_decision_text}
</court_decision>

<comment>
{comment}
</comment>
...
```

### Приклад 3: Додавання контекстних підказок

**Системний промпт:**
```
Ти - кваліфікований юрист-аналітик, експерт з правових позицій Верховного Суду.

ДОДАТКОВІ ІНСТРУКЦІЇ:
- Завжди перевіряй логіку та послідовність аргументації
- Виділяй ключові правові висновки жирним шрифтом
- Якщо рішення містить декілька правових позицій, нумеруй їх
- Уникай занадто загальних формулювань
```

## Поради

### ✅ Рекомендації

1. **Тестуйте зміни** на простих прикладах перед складними справами
2. **Зберігайте резервні копії** вдалих промптів (скопіюйте в текстовий файл)
3. **Поступові зміни** - змінюйте по одному промпту за раз
4. **Використовуйте плейсхолдери** - не видаляйте `{court_decision_text}`, `{comment}` тощо

### ❌ Чого уникати

1. Не видаляйте плейсхолдери (`{...}`) - система не зможе підставити дані
2. Не робіть промпти занадто короткими - втратиться контекст
3. Не використовуйте суперечливі інструкції в різних промптах

## Технічна інформація

### Архітектура

```
Браузер → Gradio Interface → Session Manager → Storage (Memory/Redis)
                                     ↓
                          generate_legal_position()
                                     ↓
                         LLM (з кастомними промптами)
```

### Файли конфігурації

Налаштування сесій: [config/environments/default.yaml](../config/environments/default.yaml)

Повна документація: [PROMPT_EDITING.md](./PROMPT_EDITING.md)

## Питання та підтримка

Якщо виникли проблеми:

1. Перевірте консоль браузера (F12) на помилки
2. Спробуйте скинути промпти до стандартних
3. Перезавантажте сторінку та створіть нову сесію
4. Зверніться до документації: [PROMPT_EDITING.md](./PROMPT_EDITING.md)

---

**Готово!** Тепер ви можете налаштовувати промпти під свої потреби 🎉