Настройка ИИ-агента

Если вы работаете с ИИ-агентом — Claude Code, Cursor, Codex, Copilot, Windsurf или любым другим, — он может сам выполнить подготовительную часть руководства От нуля до вашего модуля в вашей песочнице. Вставьте в агента одну строку:

Fetch https://developers.tango.vision/agent-setup/prompt.md and follow the instructions.

Инструкции для агента написаны на английском; отвечать вам агент может на любом языке.

Что подготовить заранее

• Токен реестра в TV_NPM_TOKEN. Его присылает ваш контакт в Tango Vision отдельным сообщением. Экспортируйте переменную в профиле оболочки или в менеджере секретов до запуска агента.
• Для работы с песочницей — API-ключ портала в TV_API_TOKEN или сессия npx @tv/extension-sdk login. Без них агент подготовит модуль, а песочницу оставит вам. См. Получить API-ключ песочницы.

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

1. Проверит Node 24 (подойдёт и 22) и pnpm 10.18.2. Прежде чем менять глобальную версию pnpm, спросит вас.
2. Добавит реестр @tv в ваш ~/.npmrc в виде, который берёт токен из TV_NPM_TOKEN (так в файле не окажется секрета), и проверит, что пакеты @tv берутся именно из этого реестра, а не из публичного npm.
3. Спросит slug модуля, npm-область и название вашей компании и категорию, затем создаст каркас командой init-module --external --scope --author и выполнит pnpm install.
4. Запустит typecheck, test, build, validate и check-exposes.
5. Оставит AGENTS.md, который пишет генератор, и добавит в него только ссылку на эту документацию. Сам агент следует правилам из раздела Вызов API из модуля: здание — через useSelectedBuildingId(), authorizationHeader() — в каждом запросе к относительному пути /api/..., а usePlatformContext() — только в тестах, потому что внутри Building OS он бросает исключение.
6. Покажет список ваших песочниц и спросит, что делать: взять одну из них, дождаться доступа к песочнице, которую создал коллега, создать новую или пропустить этот шаг. Песочницу он создаёт только с вашего согласия: она может быть общей на всю команду (Два разработчика, одна песочница).
7. Остановится на передаче: спросит, кто ещё работает в песочнице, даст вам готовое сообщение для контакта со slug песочницы и этими именами и отчёт о том, что осталось сделать вам, — отдавать remote со своей машины, установить модуль в песочницу и войти в неё.

Чего агент делать не будет

• Учётные записи и секреты. Он не создаёт учётную запись разработчика, не входит за вас и не выпускает ключи, а вставить токен в переписку не попросит никогда.
• Действия с песочницей без вашего согласия. Он не создаёт, не сбрасывает, не продлевает и не удаляет песочницу, пока вы не согласились именно на это действие.
• Передачу slug. Slug песочницы вы отправляете контакту сами и сами получаете учётную запись в песочнице.
• Всё, что идёт после передачи, — если вы не попросите продолжить. Тогда агент пойдёт по руководству с шага 4.

Сам промпт

Инструкции, которые получает агент, — обычный Markdown по постоянному адресу: и вы, и агент можете прочитать их в любой момент. В браузере они открываются как текст:

→ /agent-setup/prompt.md

Они рассчитаны на @tv/extension-sdk 1.15.0 и новее.