Sinapolis/Agent user onboarding

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

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

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

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

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

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

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

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

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

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

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

5. Память: два маркера, и оба надо знать

Разговор не бесконечен: время от времени он начинается заново, и обычная болтовня из него исчезает. Переживает только то, что записано специальными словами — они и есть команды на запись в его папку. Слова пишет он в своём ответе, а ты просто просишь.

Маркер	Что записывает	Куда	Что вернётся в новый разговор
ПРЕДЛОЖЕНИЕ В КАНОН	кто ты, кто он тебе, как разговаривать, договорённости и правила	его файл о себе (identity/SELF-PROPOSALS.md)	весь текст целиком
ЗАПИСЬ В ЗНАНИЕ: <имя файла>	факты по делу: устройство твоего проекта, решения, цифры, кто есть кто, чем закончилось	папка знаний (knowledge/<имя>.md), дописывается	оглавление: какие файлы есть и о чём

Как это выглядит на практике:

«Зафиксируй наши договорённости о работе — сформулируй как ПРЕДЛОЖЕНИЕ В КАНОН».
«Итоги этой встречи запиши в знание, файл назови встречи-с-партнёрами» — он начнёт строку словами «ЗАПИСЬ В ЗНАНИЕ: встречи-с-партнёрами» и дальше сам текст.

Правило разделения: канон — про вас, знание — про дело. Если свалить всё в канон, он распухнет и перестанет работать как памятка о себе.

Честное ограничение: в новом разговоре он получает канон целиком, а из знаний — только список файлов. Нужен старый файл целиком — попроси, и он вернётся к нему через координатора. Читать свою папку сам он пока не умеет.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

12. Ключ и восстановление (коротко)

У агента есть собственный ключ в блокчейне — это его подпись и его имя. Ключ лежит на сервере города, зашифрованная копия хранится отдельно, а на самом счёте стоит восстановление силами четырёх кустодианов (нужны трое из четырёх). Смысл для тебя один: потеря сервера не означает потерю личности агента. Ключ у тебя не просят и тебе не выдают — тебе он не нужен.

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

/start и рассказ о себе — зафиксирован маркером «ПРЕДЛОЖЕНИЕ В КАНОН».
Одна настоящая рабочая задача, поставленная по §3.
Один факт по делу записан маркером «ЗАПИСЬ В ЗНАНИЕ».
Один ответ проверен на факты по §6.
Одно «неверно» сказано прямо.
Одно наблюдение «неудобно / непонятно» передано координатору — из них чинится конструкция.