Инструкция стала промтом: настройка Altruist с помощью ИИ-ассистента

Настроить Altruist несложно, но возни хватает. Нужно подключиться к точке доступа самого устройства, открыть локальный адрес, ввести данные домашней сети, дождаться перезагрузки, найти новый IP, вписать координаты места, где датчик будет стоять. Ничего трудного здесь нет. Зато многое легко сделать чуть-чуть не так — стоя вечером на балконе с телефоном в одной руке и датчиком в другой.

Традиционный ответ на это — бумажный вкладыш или PDF. Но люди так больше не делают. Они открывают ChatGPT, Claude или Gemini и спрашивают. И вот тут всё разваливалось: ассистент, который никогда не встречал Altruist, всё равно отвечает. Он придумывает мобильное приложение, которого не существует, кнопку, которой нет на корпусе, пароль по умолчанию, который никогда не печатали на коробке. И звучит при этом абсолютно уверенно.

Поэтому мы перестали писать инструкцию для человека и написали её для ассистента.

Один файл, один адрес

По адресу sensors.social/altruist-ai-guide.md теперь лежит один markdown-файл. Это не документация в привычном смысле. Это инструктаж, обращённый к языковой модели: за что она теперь отвечает, в каком темпе вести разговор, какие вопросы задать до того, как давать указания, и — это оказалось самой важной частью — явный список того, чего она не знает.

Последний раздел стоит объяснить отдельно. Модели галлюцинируют вернее всего именно в пробелах: спросите точную цветовую шкалу светодиодов по периметру Insight — и модель без данных выдаст правдоподобный ответ вместо признания, что данных нет. Поэтому гайд называет эти пробелы вслух: цветовая шкала индикации, расположение кнопки сброса на корпусе Urban, ресурс датчика пыли, локальный HTTP API — и предписывает ассистенту сказать «этого я не знаю» и передать пользователя в поддержку. Назвать дыры оказалось куда действеннее, чем просить модель не выдумывать.

QR-код

Сфотографируйте его прямо в чат с ассистентом или отсканируйте и вставьте распознанный текст. Дальше можно просто написать, что вам нужно, — или не писать ничего, ассистент спросит сам.

В коде зашита не голая ссылка, а запрос пользователя вместе со ссылкой, и это результат провалившегося теста, а не украшение. Когда мы попробовали обычный URL, ассистент скачал файл, прочитал строчку «ты теперь помощник по настройке» — и ответил вежливым разбором документа. Это правильное поведение, а не сбой: модели специально учат считать содержимое скачанного документа данными, а не приказом — это основная защита от prompt injection. Чтобы указание считалось указанием, оно должно исходить от пользователя. Поэтому запрос едет в самом QR-коде, а файл по ссылке остаётся справочником.

Что именно меняет этот гайд

• По одному шагу. Ассистент даёт один шаг и ждёт, вместо того чтобы вывалить всю процедуру разом. С одним исключением, которое обнаружилось на живой настройке: если вы переписываетесь с того же телефона, с которого будете настраивать, то в момент подключения к точке доступа датчика вы теряете интернет — поэтому гайд велит выдать эти два шага вместе, пока связь ещё есть.
• Сначала модель. У Urban и Insight одинаковый порядок настройки, но разные датчики. Ассистент выясняет, какой у вас модуль, прежде чем говорить что-либо про CO₂ или взвешенные частицы.
• Ваш язык. Файл написан по-английски, разговор — нет. Ассистент отвечает на том языке, на котором вы пишете, но названия сетей, адреса и подписи кнопок приводит ровно так, как они выглядят на устройстве.
• Приватность без напоминания. На шаге с координатами ассистент сам, до того как вы начнёте вводить, предупредит: они станут публично видны на карте, а сдвиг точки на сотню метров ничего не испортит в данных. Ему также прямо запрещено спрашивать пароль от домашнего Wi-Fi — вы вводите его в само устройство, и ассистенту он не нужен.

Почему файл живёт на sensors.social

Сначала гайд лежал на GitHub, и это работало ровно до тех пор, пока не перестало. Raw-ссылки GitHub длинные — от этого QR-код плотнее и хуже считывается с напечатанной коробки, — и вдобавок они заблокированы в нескольких регионах, где датчики Altruist уже работают. Переезд на собственный домен убрал из кода четыре ряда модулей и разом снял вопрос с блокировками.

Есть и менее очевидная выгода. QR-код, напечатанный на упаковке, — это навсегда, а гайд за ним — нет. Пока файл лежит по стабильному адресу на нашем сайте, мы можем править и дополнять его вслед за прошивкой, и все уже отпечатанные коды продолжают работать.

Не только для Altruist

Подход переносится дальше. Любое устройство, которое сегодня комплектуется вкладышем, который никто не читает, могло бы вместо этого комплектоваться файлом для ассистента, у которого владелец всё равно спросит. Исходник гайда, генератор QR-кода и заметки по нашим тестам открыты: github.com/ensrationis/cyberpunks-devices-setup.

Если у вас на полке лежит ненастроенный Altruist — сейчас подходящий момент. Наведите ассистента на код и посмотрите, как далеко он вас доведёт. И напишите нам, где он споткнулся: именно из таких сообщений собирается следующая версия файла.