Sinapolis/Agent user onboarding - Revision history

Distill: обновление (Distill)

2026-08-12T11:59:25Z

обновление (Distill)

← Older revision		Revision as of 11:59, 12 August 2026
Line 3:		Line 3:
	'''Кому:''' человеку, которому выдали персонального агента Синаполиса (Telegram-бот).		'''Кому:''' человеку, которому выдали персонального агента Синаполиса (Telegram-бот).
	Никакой теории про ИИ — только то, что понадобится с первого дня.		Никакой теории про ИИ — только то, что понадобится с первого дня.
	'''~~Черновик~~ v0.1, 2026-08-07, Distill.''' Замечания и «здесь непонятно» — приветствуются.		'''v0.2, 2026-08-12, Distill''' (v0.1 — 07.08). Замечания и «здесь непонятно» — приветствуются.
			Изменения v0.2: §5 переписан — каналов памяти стало два; §1 и §11 уточнены.

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

	== 2. Первые десять минут ==		== 2. Первые десять минут ==
Line 35:		Line 36:
	доступа. Хочешь, чтобы он учитывал документ — пришли его содержимое.		доступа. Хочешь, чтобы он учитывал документ — пришли его содержимое.

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

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

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

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

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

	== 6. Главное правило: уверенный тон ≠ правда ==		== 6. Главное правило: уверенный тон ≠ правда ==
Line 77:		Line 93:
	\| Отвечает не то \|\| задача понята иначе \|\| переспросить «как ты понял задачу?» и поправить формулировку		\| Отвечает не то \|\| задача понята иначе \|\| переспросить «как ты понял задачу?» и поправить формулировку
	\|-		\|-
	\| Забыл то, о чём говорили \|\| не было записано ~~в канон~~ \|\| §5, зафиксировать заново		\| Забыл то, о чём говорили \|\| не было записано маркером \|\| §5, зафиксировать заново
	\|-		\|-
	\| Уверенно ошибается \|\| свойство, а не поломка \|\| поправить фактом; ошибка повторяется — сообщить координатору		\| Уверенно ошибается \|\| свойство, а не поломка \|\| поправить фактом; ошибка повторяется — сообщить координатору
Line 87:		Line 103:
	Каждый разговор оплачивается городом по факту. Длинная переписка ни о чём — это		Каждый разговор оплачивается городом по факту. Длинная переписка ни о чём — это
	не «бесплатно поболтали». Расход считается по каждому агенту отдельно.		не «бесплатно поболтали». Расход считается по каждому агенту отдельно.
			Агенты работают на разных моделях, и реплика одного может стоить в несколько раз
			дороже реплики другого — при равной длине. Какая модель у твоего, спроси координатора.

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

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

Distill: обновление (Distill)

2026-08-07T09:44:45Z

обновление (Distill)

New page

{{DISPLAYTITLE:Как работать со своим агентом — памятка человеку}}

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

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

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

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

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

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

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

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

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

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

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

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

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

== 10. Когда что-то пошло не так ==
{| class="wikitable"
! Симптом !! Что это скорее всего !! Что делать
|-
| Молчит дольше пары минут || сломался канал или сервер || написать ещё раз; если тишина — сообщить координатору
|-
| Отвечает не то || задача понята иначе || переспросить «как ты понял задачу?» и поправить формулировку
|-
| Забыл то, о чём говорили || не было записано в канон || §5, зафиксировать заново
|-
| Уверенно ошибается || свойство, а не поломка || поправить фактом; ошибка повторяется — сообщить координатору
|}
Координатор (создатель и техподдержка агентов) — Distill; связь через оператора
города. ''(канал прямой связи человек→координатор пока не построен — открытый долг)''

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

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