Tvijo wiki
Каталог

Темы

Как читать квитанции агента и не путать доставку с прочтением

Разберитесь, на каком этапе находится сообщение роя, не смешивая сохранение, доставку, приём runtime и просмотр. Руководство показывает локальные проверки, приватный экран наблюдения и отдельные квитанции, чтобы подтверждение доставки не превращалось в недоказанное обещание выполненного действия.

🎯 Для Операторы и разработчики Tvijo, проверяющие события задачи в рабочей среде с явной областью владельца или в VS Code.

📚 Вы узнаете
  • Различать сохранение, очередь, подтверждение bridge, получение runtime и просмотр человеком.
  • Возобновлять проекцию журнала по курсору, не считая открытие страницы подтверждением.
  • Распознавать состояния, где получение runtime остаётся неизвестным.

Журнал упрощает воспроизведение событий задачи, если названия квитанций точны. В ограниченной реализации от 9 ноября 2026 года разрешённые промежуточные сообщения агента и идентификаторы начала/результата/ошибки инструмента дописываются в устойчивый журнал, а затем отправляются через существующий outbox Worker. Ответ bridge ok/event_id — подтверждение хранения: он не доказывает, что событие получил runtime или прочитал человек.

Цель

Проверить события одной задачи и определить самый сильный статус, подтверждённый явной квитанцией. При переходе между задачей в VS Code и аутентифицированным рабочим экраном на телефоне сохраняйте тот же scope задачи и аккаунта.

Офлайн-команда контракта

Из корня репозитория запустите детерминированные тесты контракта:

python3 -m unittest tests.test_agentroy_communications tests.test_agentroy_worker

Тесты проверяют локальное сохранение, повторное чтение по курсору, пробелы покрытия и fake subprocess receiver. Fake-приёмник не является установленным адаптером DSHREM или Codex. Read-only проекция предназначена для существующей owner-scoped среды Platform/RemDesk; тест не доказывает подключение UI или получение квитанций от live адаптера.

Как читать статусы

  • persisted: транзакция журнала зафиксирована.
  • queued: в существующем outbox ожидает отправки.
  • sent: endpoint bridge/storage принял событие.
  • runtime_received: UNKNOWN, пока явная квитанция не содержит совпадающий ID события.
  • human_displayed и explicitly_viewed_or_approved: не заявляются, пока UI не запишет эти действия отдельно.
  • Завершение действия: неизвестно без отдельной квитанции о завершении.

При возобновлении ленты используйте курсор и сохраняйте фильтр аккаунта/задачи. Повтор того же ID с тем же содержимым идемпотентен; изменённое содержимое с тем же ID — конфликт, а не новое сообщение. См. также MCP в VS Code и что такое MCP.

Когда это не работает

Тестовая команда завершается без запроса к модели/API. Fake receiver доказывает только контракт квитанции в изоляции, а не поддержку в production runtime. Частая ошибка — читать sent как «агент увидел» или считать успешный GET доказательством, что человек прочитал. Оставляйте runtime- и human-статусы UNKNOWN, пока для каждого нет отдельного доказательства.

Область утверждения: COMMS-01, реализация проверена 2026-11-09. Только локальный журнал и контракт fake receiver; получение квитанций от native production runtime остаётся UNKNOWN; показ браузером проверен отдельно на синтетических данных.

Проверить интерфейс доставки

Маршрут /communications проверен в изолированном кандидате. Его production-активация сейчас BLOCKED: действующий gateway загружен из общей рабочей копии с чужими незавершёнными изменениями, а соответствие её текущих файлов запущенному процессу не доказано. Мы сохранили рабочий gateway и не перезапускали его ради этой функции. Описанные ниже действия относятся к проверенному кандидату после входа синтетического аккаунта, а не к уже доступному публичному экрану. Видны только явно назначенные ему журналы. Пустой список означает отсутствие назначений, а не отсутствие потерянных сообщений. Обновление читает журнал, кнопка следующих событий использует курсор. Показ карточки браузером сохраняет отдельную клиентскую квитанцию; кнопка подтверждения — отдельное явное подтверждение клиента. Ни одно из них не доказывает внимание человека или завершение действия. Рабочие сообщения остаются приватными.

python3 -m pytest -q tests/test_platform_communications.py
python3 scripts/agentroy_communications.py --help

Ожидаются 8 локальных тестовых случаев без model API и справка CLI. Владелец задаёт приватный registry и назначение журнала явным действием; инструмент отказывается переназначать существующий ID. Не назначайте чужой журнал по предположению. Native Codex/DSHREM не подтверждают runtime-приём через этот адаптер: показывается UNKNOWN. Изолированный runtime-приём и настоящий ASGI/SQLite/UI проверены на синтетическом аккаунте, который не является production-перепиской.

Телефон и VS Code

С телефона используйте Termius/SSH и Bash в отдельной рабочей копии; команды вводятся в терминал, а не в поле задания Codex/DSHREM. В VS Code Remote SSH откройте терминал этой же рабочей копии. Инструкции общего доступа: MCP в VS Code. Мобильная веб-проверка выполнена в браузере на ширинах 320/390; физический iPhone в этом пакете не проверялся.

Доказательства

Проверено 2026-11-09. Исходные файлы доступны сопровождающим в приватном checkout, содержащем этот выпуск; команды офлайн рассчитаны на этот checkout, Node 26.7.0 и Python 3.12. Структурированные данные и claim IDs · Аудит первоисточников · QM, изученный commit · Promptfoo custom providers.

9 ноября 2026 UTC. Проверены зафиксированные данные пилота и локальные сценарии, перечисленные выше. До отдельной квитанции публикации локальная сборка и скриншот не считаются доказательством доступности публичного URL.

Практика

Выполните приведённую выше команду чтения аудита и сохраните её вывод рядом с датой проверки. Это чтение опубликованного JSON, без запроса к модели.

Проверьте себя

Откройте синтетическую квитанцию и найдите стабильный event ID, sender, recipient, run и курсор. Может ли storage ACK доказать приём агентом? Может ли GET доказать просмотр человеком? Оба ответа отрицательные. При UNKNOWN сначала установите покрытие адаптера и наличие явного подтверждения, а не запускайте задачу повторно. Сравните состояние до и после переподключения: порядок событий должен сохраниться, а завершение действия не должно появиться само.

Дальше

Перейдите к связанным урокам: оценка, доставка и проверка источников. Следующая расширенная выборка пока только запланирована. Новые skills остаются гипотезами: проверять пользу нужно на других задачах, с фиксированной методикой и независимой приёмкой.

Источники

Данные пилота, аудит десяти материалов, документация Promptfoo, QM: изученный commit. Источники дают происхождение утверждения; применимость и полезность определяются условиями конкретной проверки.

COMMS-IMPL-01 — область реализации. Проверено 2026-11-09 UTC: устойчивый журнал, outbox, курсор и отдельные клиентские квитанции работают в изолированной реализации; production-активация не подтверждена. Источник — локальные независимые тесты и сохранённые синтетические ASGI/SQLite/browser-квитанции; рабочие сообщения не публикуются. Версия журнала: префикс SHA-256 5f7c05159150. Противоречие и ограничение: native-адаптеры не дают явного runtime ACK, действующая база gateway не закреплена. Перепроверка — после появления проверенного неизменяемого gateway base и отдельного допуска установки.

Связи опубликованных статей. Выберите узел, чтобы открыть статью у заголовка.

Показать граф связей
100%
→ Связанные статьи← Ссылаются сюда⋯ Та же тема
Связи статей · клавиатура / текст

💬 Комментарии

Комментарии публичны и модерируются. Не публикуйте персональные данные.
  • Комментариев пока нет. Будьте первым!

Следующие шаги

Основа ИИ и процессов

Система агентов Tvijo: PRIZMA, RUNLEDGER и приёмка

Tvijo развивает управляемый путь от задачи в репозитории до принятого результата: с разрешениями, ограничениями ресурсов и проверяемыми свидетельствами выполнения. PRIZMA описывает профиль ресурсов, RUNLEDGER связывает работу с проверками и…

Основа ИИ и процессов

Проверяйте AI-радар по первоисточникам до добавления новости

Проверьте технологическую новость по первоисточнику, версии и дате события до решения о внедрении. Руководство разбирает фиксированную выборку из десяти материалов, отделяет факты от выводов и прогнозов и показывает, как сохранить ограничения и условие следующей проверки.

Основа ИИ и процессов

Сначала проверьте оценку AI-harness офлайн, до любого live-пилота

Проверьте процедуру оценки coding-агентов без запроса к модели, затем разберите восемь реальных слотов инженерного пилота. Руководство связывает команды, независимую приёмку, полное время и квитанции расходов, объясняя, почему сохранённый ответ и новый принятый результат различаются.