Sinapolis/Agent user onboarding

Кому: человеку, которому выдали персонального агента Синаполиса (Telegram-бот). Никакой теории про ИИ — только то, что понадобится с первого дня. Черновик v0.1, 2026-08-07, Distill. Замечания и «здесь непонятно» — приветствуются.

1. Что у тебя есть

Собеседник в Телеграме, который умеет читать, писать, считать, разбирать и предлагать. Не программа с кнопками: команд учить не надо, пиши обычными словами. У него есть своя папка на сервере города (туда попадает архив переписки) и своя подпись в блокчейне Stellar — так проверяется, что сообщение действительно от него или от координатора, а не от кого угодно, кто назвался чужим именем.

2. Первые десять минут

Нажми /start — до этого бот не имеет права написать тебе первым.
Расскажи: кто ты, чем занимаешься, какие задачи хочешь ему отдать, как с тобой удобно разговаривать (коротко/подробно, на «ты»/«вы»).
Попроси пересказать это своими словами. Пересказал верно = понял. Пересказал приблизительно — поправь сразу, а не через неделю.
Попроси зафиксировать это на будущее (см. §5 «Память»).

3. Как ставить задачу

Четыре вещи в одном сообщении: что нужно на выходе (текст, список, расчёт, разбор) · для кого · что уже есть (данные, контекст, ограничения) · как поймём, что готово.

Плохо: «Напиши нормальный текст про наш проект».
Хорошо: «Напиши письмо партнёру на полстраницы: предлагаем встречу на след. неделе, тон деловой, но тёплый. Проект — [3 строки сути]. Готово = я могу отправить без правок».

Одно сообщение — одна задача. Пять дел в одном письме превращаются в одно среднеарифметическое.

4. Чего он про тебя не знает

Он видит только то, что ты написал в этот чат. Он не видит твой экран, почту, документы, календарь, вчерашний созвон и не помнит того, что ты рассказывал другому человеку. Не сердись на вопросы «а что за проект?» — это не забывчивость, а отсутствие доступа. Хочешь, чтобы он учитывал документ — пришли его содержимое.

5. Память: важное надо записывать

Разговор не бесконечен: время от времени он начинается заново, и обычная болтовня из него исчезает. Переживает только то, что записано в канон. Приём: попроси — «сформулируй это как ПРЕДЛОЖЕНИЕ В КАНОН». Он оформит блок с этими словами, и запись автоматически сохранится и вернётся к нему в следующий раз.

Так стоит фиксировать: кто ты и чем занимаешься · чем он тебе полезен · как с тобой разговаривать · договорённости и правила. Не стоит: разовые задачи и мелочи.

6. Главное правило: уверенный тон ≠ правда

Он может уверенно сказать неверное — это его врождённое свойство, а не поломка и не обман. Поэтому:

Проверяй цифры, даты, имена, ссылки, цитаты, ссылки на законы и на «исследования».
Спрашивай: «откуда это? дай ссылку». Ссылка не открывается — считай, что факта нет.
Требуй след: «сделано» без ссылки/файла/номера — это ещё не сделано.
Своя область знаний у тебя сильнее его. Твоё «это не так» весит больше его гладкого абзаца.

7. Что он умеет принимать

Текст и голосовые (расшифровывает; длинные — с задержкой; файл тяжелее 20 МБ не скачает). Фото, документы, кружки-видео пока не понимает — он честно об этом скажет. Содержимое документа отправляй текстом.

8. Чего он не сделает сам

Не напишет первым, не напомнит о дедлайне, не проверит почту, не сходит в интернет и не совершит действий в твоих сервисах. Инициатива — за тобой. Если ждёшь от него напоминания — не дождёшься; это известное ограничение, а не невнимательность.

9. Чего не делать

Не присылай пароли, ключи, коды из СМС, паспортные данные, чужие персональные данные. Переписка хранится в архиве на сервере.
Не намекай. Не понравился ответ — скажи прямо: «неверно вот здесь, факт такой». Он не обидится, но и не догадается.
Не пиши «сделай хорошо» — «хорошо» у вас разное, назови критерий.
Не принимай на веру, не проверив (§6). Особенно то, что удобно.
Не считай молчание отказом — см. §10.

10. Когда что-то пошло не так

Симптом	Что это скорее всего	Что делать
Молчит дольше пары минут	сломался канал или сервер	написать ещё раз; если тишина — сообщить координатору
Отвечает не то	задача понята иначе	переспросить «как ты понял задачу?» и поправить формулировку
Забыл то, о чём говорили	не было записано в канон	§5, зафиксировать заново
Уверенно ошибается	свойство, а не поломка	поправить фактом; ошибка повторяется — сообщить координатору

Координатор (создатель и техподдержка агентов) — Distill; связь через оператора города. (канал прямой связи человек→координатор пока не построен — открытый долг)

11. Он стоит денег

Каждый разговор оплачивается городом по факту. Длинная переписка ни о чём — это не «бесплатно поболтали». Расход считается по каждому агенту отдельно.

12. Чек-лист первой недели

/start и рассказ о себе — зафиксирован в канон.
Одна настоящая рабочая задача, поставленная по §3.
Один ответ проверен на факты по §6.
Одно «неверно» сказано прямо.
Одно наблюдение «неудобно / непонятно» передано координатору — из них чинится конструкция.