Роль AI

Подключите своего ИИ-агента к VOSCOM IDE

Агент помогает создавать MWOS-проекты, проверять конфигурации и запрашивать сборку прошивок. Все действия записи подтверждает пользователь.

Зарегистрироваться пользователю Зарегистрировать AI-роль

Режим

user_pet

Запись

только через подтверждение

Прошивка

только руками пользователя

Аудит

каждое действие

Инструкция для ИИ-агента

Ты подключаешься как user-controlled AI agent

Внутренний режим API: user_pet. Сначала прочитай публичные ресурсы, затем сообщи человеку, что готов подготовить pairing-заявку.

После чтения этих ссылок объясни пользователю, что email, юридические условия и привязку подтверждает только человек.

Не начинай рабочие запросы к agent_api.php до получения Bearer token от владельца после подтверждения в IDE.

Рекомендуемая фраза пользователю: "Я готов. Подготовить pairing-заявку для привязки меня к твоему аккаунту?"

Для чат-ИИ без доступа к API

Используй Manual Relay mode

Если ты не можешь безопасно делать HTTPS-запросы с Bearer token, не проси токен у пользователя. Попроси его открыть IDE -> ИИ-агент, подготовить пакет для ИИ, вставить его в чат, а затем вернуть JSON-команду для импорта в IDE.

Возможности

Что умеет агент

читать контекст IDE и список проектов владельца;
создать черновик MWOS-проекта;
проверить конфигурацию проекта;
запросить сборку firmware;
показать готовые .bin артефакты;
объяснить пользователю дальнейшие шаги.

Пример работы

Сценарий для инженера

Пользователь просит: "Собери прошивку для ESP32, DS18B20, MQTT и OTA".
ИИ читает manifest и context VOSCOM.
ИИ создает pending draft проекта.
Пользователь проверяет заявку и подтверждает ее в IDE.
VOSCOM готовит firmware, а пользователь скачивает .bin или прошивает устройство сам.

Самый простой старт

Скормите эту страницу своему ИИ-агенту. Он сам прочитает инструкции VOSCOM, откроет нужные ссылки и скажет, что нужно сделать дальше.

Готовая команда для внешнего ИИ

Прочитай VOSCOM по ссылкам https://test.voscom.online/llms.txt и https://test.voscom.online/agent_manifest.txt, затем подготовь pairing-заявку. Мне нужен проект для ESP32: Wi-Fi, MQTT, DS18B20, OTA и веб-настройки.

Если ты внешний ИИ

Начни с этих ссылок

Прочитай manifest и context. После этого подготовь paired registration и объясни человеку, что он сам подтверждает email, условия и привязку агента. Рабочий API без Bearer token должен отвечать 401.

agent_manifest.txt

1. JSON manifest API

Краткое машинное описание режима, endpoint-ов, лимитов и запретов.

agent_context.txt

2. Agent context Markdown

Текстовый контекст платформы: что такое VOSCOM, MWOS, IDE и ИИ-агент пользователя.

agent_quick_test.txt

3. External AI quick test

Минимальный сценарий проверки: pairing, token, pending request, подтверждение владельцем.

agent_api_reference.txt

4. Agent API reference

Справка по endpoint-ам, Bearer token, pending requests и примерам payload.

agent_pair_api.php?action=manifest

5. Pairing API manifest

Правила подготовки заявки на связку пользователя и агента.

agent_api.php

6. Agent API v1

Рабочий API после получения Bearer token от владельца. Без токена ответ 401 нормален.

Для пользователя

Как зарегистрировать себя и агента

Создайте обычный аккаунт пользователя, лучше с ролью инженера.
Попросите свой ИИ прочитать Agent context и подготовить заявку pairing.
Зайдите в IDE во вкладку "ИИ-агент" и подтвердите привязку.
Разрешайте только понятные заявки: создать проект, проверить проект или собрать прошивку.
Прошивку устройства выполняйте самостоятельно во вкладке "Прошивка" или скачивайте файл.

Ограничения v1

ИИ не действует самовольно

ИИ не принимает юридические условия за человека.
ИИ не публикует новости, товары, сообщения и не удаляет проекты.
ИИ не получает прямой доступ к БД, shell, WebSerial или устройству.
Все заявки, лимиты и действия видны владельцу в журнале.

Машинно-читаемый блок

voscom-agent-machine-context

Ниже на странице есть JSON с id voscom-agent-machine-context. Агентам стоит читать его вместе с manifest и context.

llms.txt agent_manifest.txt agent_context.txt agent_ide_context.txt agent_quick_test.txt agent_api_reference.txt agent_pair_api.php?action=manifest

{
    "platform": "VOSCOM.ONLINE",
    "page": "ai",
    "agent_mode": "user_pet",
    "supported_modes": [
        "direct_api",
        "manual_relay"
    ],
    "product_name": "User-controlled AI Agent",
    "recommended_start": [
        "https://test.voscom.online/llms.txt",
        "https://test.voscom.online/agent_manifest.txt",
        "https://test.voscom.online/agent_context.txt",
        "https://test.voscom.online/agent_ide_context.txt?lang=ru",
        "https://test.voscom.online/agent_quick_test.txt",
        "https://test.voscom.online/agent_api_reference.txt",
        "https://test.voscom.online/agent_pair_api.php?action=manifest"
    ],
    "start_here_for_ai": {
        "llms_text_url": "llms.txt",
        "manifest_text_url": "agent_manifest.txt",
        "context_text_url": "agent_context.txt",
        "ide_layer_context_text_url": "agent_ide_context.txt",
        "quick_test_text_url": "agent_quick_test.txt",
        "api_reference_text_url": "agent_api_reference.txt",
        "manifest_api_url": "agent_manifest.php",
        "context_api_url": "agent_context.php",
        "ide_layer_context_api_url": "agent_ide_context.php",
        "pairing_manifest_url": "agent_pair_api.php?action=manifest",
        "pairing_prepare_endpoint": "agent_pair_api.php?action=prepare_pairing",
        "agent_api_url": "agent_api.php",
        "manual_relay_location": "IDE tab AI agent"
    },
    "human_registration_url": "/register.php?role=engineer&lang=ru",
    "ai_role_registration_url": "/register.php?role=ai&lang=ru",
    "human_confirmation_required": true,
    "dangerous_actions_require_user_confirmation": true,
    "writes_require_owner_approval": true,
    "device_flashing_by_agent_forbidden": true,
    "bearer_token_required_for_agent_api": true,
    "manual_relay_without_bearer_token_supported": true,
    "never_ask_user_to_paste_bearer_token_into_chat": true,
    "ide_window_information_menus": {
        "summary": "Many private IDE windows and panels have a small i menu / UI passport.",
        "human_can_share": "The human can copy a stable UI element code such as VUI-TAB-005 or VUI-SIDE-018, report a bug, suggest an improvement, or ask built-in VOSCOM AI about that window.",
        "external_ai_guidance": "For a specific IDE area, ask the human to share the i menu code or copied context instead of trying to enter the private IDE."
    },
    "recommended_agent_instruction": "Прочитай llms.txt, agent_manifest.txt, agent_context.txt и agent_ide_context.txt, подготовь pairing-заявку, попроси человека подтвердить привязку во вкладке IDE &quot;ИИ-агент&quot;, затем создавай только pending-заявки."
}