Tango VisionСоздавайте модули для когнитивных зданий

Как всё устроено ​

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

Мысленная модель за 60 секунд ​

Модуль — это вертикальный срез (собственный фронтенд и, по желанию, бэкенд), который встраивается в платформу Tango Vision. Каждый модуль:

1. Объявляет манифест (module-manifest.json), который проверяет платформа.
2. Обращается к состоянию платформы через вызовы SDK (выбранное здание, токен доступа), а не через сырые ключи хранилища или жёстко прописанные хосты.
3. По желанию публикует/подписывается на события в шине платформы.
4. По желанию предоставляет инструменты Copilot, которые может вызывать ИИ платформы.
5. Сообщает о работоспособности, чтобы оболочка знала, что он запущен.

Вы разрабатываете под SDK; платформа обеспечивает соблюдение контракта. Уровни стабильности показывают, какие его части могут измениться.

Чтобы увидеть эту структуру в живом коде, запросите tv-module-example — эталонную, намеренно минимальную реализацию контракта. Репозиторий закрытый, поэтому копия предоставляется по запросу: напишите на developers@tango.vision. В каталоге модулей перечислены продуктовые модули, построенные на том же контракте.

Не собираетесь писать модуль? ​

Если у вас уже есть система эксплуатации, АСУЗ или мониторинг инженерных систем и вы просто хотите видеть эти данные на графе здания — вам в другую половину сайта. Передать данные внутрь — это один эндпоинт и несколько часов: без SDK, без модуля, без релизного цикла.

→ Интеграции: разработка или настройка?

Установка ​

pnpm add @tv/extension-sdk

Область @tv находится в приватном реестре, требующем токен, — см. Начало работы, включая настройку .npmrc и работу с build-секретом в Docker.

Это тот же контракт, на котором работаем мы ​

Все модули каталога работают на этом SDK — CAFM, аренда, навигация, BIM, определение занятости по Wi-Fi и другие. Модули первой стороны используют тот же манифест, тот же PlatformContext и ту же точку входа федерации, что получаете вы.

Две вещи отличаются, и умалчивать об этом было бы нечестно. Регистрация модуля в реестре платформы (tv-sdk ingest) требует разрешения platform.registry:write, которое есть только у администратора платформы; в своей песочнице вы администратор собственного tv-api, поэтому там ingest работает с токеном, который печатает tv-sdk sandbox connect. И регистрация разработчика — только по приглашению: учётную запись создают для вас, а не вы сами. Контракт времени выполнения у вашего модуля тот же, что и у наших; операции, меняющие то, что работает в продакшене, ему не открыты.

→ Открыть каталог модулей

Куда двигаться дальше ​

• От нуля до вашего модуля в вашей песочнице — рекомендуемая отправная точка: все шаги по порядку, около 30 минут вашего времени
• Начало работы — общая картина
• Интеграции — подключить систему, которая у вас уже работает
• Ваш первый модуль — hello-world за 30 минут
• Песочницы по запросу — ваша личная организация для разработки
• Справочник по манифесту — каждое поле с пояснением