================================================================================
  КАК ОБЩАТЬСЯ С ИИ В ALEXSOFTCLUB - ДЛЯ ЧАЙНИКОВ
  Задача 23 "ИИ диалог аккаунтов"
================================================================================

Это не ChatGPT в браузере. Здесь вы НЕ пишете ИИ в чате программы.
Вы настраиваете ТЕКСТОВЫЕ ФАЙЛЫ в папке Data/AI/ - и софт сам шлёт реплики
в Telegram от ваших аккаунтов.

Думайте так: вы пишете инструкцию актёрам, а не разговариваете с ними лично.


--------------------------------------------------------------------------------
ШАГ 0. ЧТО НУЖНО ПЕРЕД СТАРТОМ
--------------------------------------------------------------------------------

1) LLM API - в настройках задачи 23 заполните:
   - URL API агрегатора
   - LLM API ключ
   - LLM модель
   (подробно: docs/Руководство/13_Настройка_LLM_API.md)

2) Группа в Telegram - НЕ канал. Аккаунты должны быть в группе и уметь писать.

3) Аккаунты "освобождены" - задача 22, кнопка "Освободить".

4) В настройках задачи 23:
   - Ссылка на чат = @ваша_группа
   - Тема диалога = одна фраза, о чём разговор
   - Включить дугу = Да (если нужен сценарий по шагам)
   - Включить оркестр = Да (если аккаунтов 3-4 и нужны разные роли)


--------------------------------------------------------------------------------
ШАГ 1. ТРИ СЛОЯ - КАК У СПЕКТАКЛЯ
--------------------------------------------------------------------------------

Слой 1 - system_prompt.txt
  "Правила для ВСЕХ". Язык, длина, что нельзя (ссылки, @, спам).

Слой 2 - roles/*.txt
  "Кто ты". Новичок, эксперт, скептик - характер одного аккаунта.

Слой 3 - knowledge/*.txt
  "Шпаргалка с фактами". Цены, условия, ответы на частые вопросы.
  Только правда - ИИ не должен выдумывать цифры.

Плюс в настройках программы:
  Тема диалога = одна строка, рамка всего чата.


--------------------------------------------------------------------------------
ШАГ 2. КАК ПИСАТЬ, ЧТОБЫ ИИ ПОНЯЛ (ГЛАВНОЕ ДЛЯ ЧАЙНИКОВ)
--------------------------------------------------------------------------------

ПЛОХО (ИИ будет нести воду):
  "Будь полезным и пиши хорошо"

ХОРОШО:
  "Максимум 2 предложения. Не больше 200 символов. Без ссылок и @ в чате."

ПЛОХО:
  "Расскажи про наш продукт"

ХОРОШО (в knowledge/):
  "Курс 4 недели. Цена 9900 руб. Без обещания миллиона за неделю."

ПЛОХО:
  "Отвечай как человек"

ХОРОШО (в roles/):
  "Ты скептик. Сомневаешься, просишь примеры. В конце можешь смягчиться."

ПРАВИЛО: пишите короткими пунктами "делай / не делай", как ТЗ для стажёра.


--------------------------------------------------------------------------------
ШАГ 3. ДУГА (arc.txt) - СЦЕНАРИЙ РАЗГОВОРА
--------------------------------------------------------------------------------

Если "Включить дугу = Да", разговор идёт по фазам:

  intro  - войти в тему, поддержать, задать вопрос, без рекламы
  pain   - озвучить боль (страшно, непонятно к кому идти)
  offer  - намекнуть на решение, БЕЗ контактов и имён
  cta    - "напиши в лс", если интересно (только эта фаза!)

Файл лежит рядом с программой: Data/AI/arc.txt
Если файла нет - создайте вручную или скопируйте из репозитория.

Одна фаза сдвигается после успешного прогона аккаунта.
Чтобы начать сначала - очистите таблицу "23 2 ИИ диалог дуга" в базе.


--------------------------------------------------------------------------------
ШАГ 4. ОРКЕСТР (orchestra.txt) - РАЗНЫЕ ЛЮДИ В ЧАТЕ
--------------------------------------------------------------------------------

Если "Включить оркестр = Да":
  аккаунт 1 = обеспокоенный родитель (задаёт вопросы)
  аккаунт 2 = опытный родитель (отвечает)
  аккаунт 3 = скептик (сомневается)
  аккаунт 4 = довольный родитель (личный кейс)

Файл: Data/AI/orchestra.txt
Нужно 3-4 аккаунта в группе. Файлы roles/01_ ... 04_ должны совпадать по числу.


--------------------------------------------------------------------------------
ШАГ 5. НАСТРОЙКИ "ПОТОКИ" И "ЦИКЛЫ" - ПРОСТЫМИ СЛОВАМИ
--------------------------------------------------------------------------------

Потоки = сколько аккаунтов работают ОДНОВРЕМЕННО.
  1 поток = по одному. 3 потока = трое пишут параллельно.

Циклы = сколько раз ПОВТОРИТЬ весь прогон.
  НЕ "сколько реплик в диалоге". Это число повторных запусков.

Сообщений на аккаунт = сколько реплик один аккаунт шлёт за один прогон.
  1-2 для теста, 2-4 для живого чата.

Задержка после сообщения = пауза в СЕКУНДАХ между своими репликами.
  Для "живости": 60-180, не 1-1.


--------------------------------------------------------------------------------
ШАГ 6. ЧТО ИИ НЕ УМЕЕТ (ЧТОБЫ НЕ ЖДАТЬ ЧУДА)
--------------------------------------------------------------------------------

- Не ведёт одного живого человека до созвона в личке
- Не пишет в ЛС сам - только зовёт текстом "напиши в лс"
- Не дожимает молчунов ("человек не ответил - напиши снова")
- Может ответить любому в чате, не только "твоему лиду"
- Не переводит разговор в личку автоматически

ИИ диалог = оживление чата вашими аккаунтами, не личный менеджер.


--------------------------------------------------------------------------------
ШАГ 7. ПЕРВЫЙ ТЕСТ (5 МИНУТ)
--------------------------------------------------------------------------------

1) 1 аккаунт в группе
2) Потоки: 1, Циклы: 1, Сообщений на аккаунт: 1
3) Запустить задачу 23, кнопка "Продолжить"
4) Проверить: реплика появилась в группе?
5) Проверить таблицу "23 1 ИИ диалог отчеты" - есть ссылка на сообщение?

Если в базе есть текст, а в чате пусто - скорее всего указали КАНАЛ, не группу.


--------------------------------------------------------------------------------
ШАГ 8. ЧАСТЫЕ ОШИБКИ
--------------------------------------------------------------------------------

| Проблема                         | Решение                          |
|----------------------------------|----------------------------------|
| Длинные простыни в чате          | Ужесточить system_prompt: 2 предложения, 200 символов |
| Одно и то же каждый раз          | Добавить 2-4 разных roles/       |
| ИИ выдумывает цены               | Заполнить knowledge/ фактами     |
| В чате ссылки/@                  | Запрет в system_prompt           |
| Нет свободных аккаунтов          | Задача 22 - "Освободить"         |
| Правки не видны                  | Перезапустить задачу 23          |


--------------------------------------------------------------------------------
ШАГ 9. МИНИ-ШАБЛОНЫ ДЛЯ КОПИПАСТА
--------------------------------------------------------------------------------

system_prompt.txt (начало):
---
Пиши коротко: 1-2 предложения, до 200 символов.
Тон: живой, как в обычном чате.
НИКОГДА не пиши ссылки и @username в чате.
Не говори что ты ИИ.
Факты только из knowledge/.
---

Тема диалога (в настройках):
---
Обсуждаем [ваша тема одной фразой]
---

knowledge/ваш_файл.txt:
---
Тема: [ниша]

Факты:
- [факт 1]
- [факт 2]

Частые вопросы:
- [вопрос]: [короткий ответ]
---


--------------------------------------------------------------------------------
КУДА КОПАТЬ ГЛУБЖЕ
--------------------------------------------------------------------------------

Полная инструкция по задаче 23:
  docs/Руководство/15_ИИ_диалог_аккаунтов.md

Промпты и файлы:
  docs/Руководство/14_Промпты_для_ИИ.md

Настройка LLM API:
  docs/Руководство/13_Настройка_LLM_API.md

Текущий пресет (заикание / психолог):
  смотрите файлы в этой же папке Data/AI/
  обязательно должны быть: arc.txt, orchestra.txt, system_prompt.txt
