
Защищённые от несанкционированного вмешательства журналы аудита для ИИ-агентов: связанные хэш-цепочкой записи Runtime Records, без зависимостей, проверяемые кем угодно.
Аудит-трейлы для AI-агентов с защитой от подделки — Runtime Records, связанные хеш-цепочкой и отображаемые в виде Runtime Report, который ваши клиенты могут проверить самостоятельно.
Каждое действие, зафиксированное вашей инструментацией (вызовы инструментов, вызовы моделей, доступ к данным, подтверждения), становится одной Runtime Record в журнале, доступном только для добавления и связанном хеш-цепочкой; Runtime Report — это та же цепочка, отрендеренная в виде HTML-страницы, которая пересчитывает хеш-цепочку в браузере читателя и отображает то, что показывает, на основе проверенных ею записей (для проверки, не полагающейся на собственный код страницы, запустите halo verify на JSONL). Любая сторона, владеющая контрольной точкой цепочки, может убедиться, что записи до этой контрольной точки не были изменены с момента её создания, не доверяя тому, кто их создал, — эта контрольная точка является ключевым элементом: одна лишь цепочка обеспечивает защиту от подделки для всех, кроме стороны, управляющей регистратором (LIMITS.md §1). Когда служба безопасности клиента спрашивает: «Что ваш агент делал с нашими данными?», вы отправляете им ссылку вместо абзаца текста. Проверки безопасности уже включают вопросы об AI рядом с чек-листом SOC 2 — и всё чаще эти вопросы исходят из ISO 42001, статей EU AI Act о ведении документации и собственных опросников клиентов. Сегодня письменное заверение всё ещё проходит. Ставка этого проекта в том, что так будет недолго.
«Двадцать лет в криминалистике учат тому, что доказательство — это доказательство, только если другая сторона может его проверить... в области, полной AI-продуктов, требующих доверия, [Halo] — редкий из тех, что создан, чтобы сделать доверие ненужным.»
Johannes Stillig, основатель и CEO Tidebreak AI, Group CISO в частном инвестиционном офисе
Отмечен в Help Net Security · В топ-4% запусков Show HN той недели · Указан в Agentic Trust Controls по пяти контролям
Формат записей открыт и свободен для реализации. Этот пакет — эталонная реализация: регистратор, верификатор, клиент-свидетель и сервер отчётов.
Используете halo-record или думаете об этом? Расскажите, кто вы и для чего → Кто использует halo-record?
Вас просят внедрить регистратор внутрь вашего агента. Вы не должны принимать это на веру:
pip install halo-record устанавливает ровно один пакет.halo serve --verify-email (отправляет одноразовый код и имя субъекта отчёта по SMTP через сервер, который вы настроите в $HALO_SMTP_HOST, на адрес, введённый просматривающим отчёт). Все они отключены, пока вы их не вызовете; никакое другое содержимое записей не покидает вашу инфраструктуру.summaries=False) не сохраняет сводку вовсе. Редактирование выполняется по мере возможности (регулярные выражения по распространённым форматам секретов и PII плюс универсальный перехват по энтропии): рассматривайте его как дополнительный уровень защиты, а не как гарантию. Поля результата, которые вы передаёте помимо summary, сканируются и маскируются теми же шаблонами, но не обрезаются до 200 символов (LIMITS §13).Что доказывает каждый уровень — ключевое различие в этом проекте (LIMITS.md §1): цепочка, которую вы храните сами, доказывает, что записи не были отредактированы, относительно головы, которая уже есть у кого-то; только контрольные точки, хранящиеся вне оператора, доказывают, что ни одна не была удалена; и никакой хеш не доказывает, что каждое действие было зафиксировано.
| Утверждение | Собственная цепочка | + Внешние контрольные точки | + Доверенная фиксация |
|---|---|---|---|
| Обнаружение правок в установленном артефакте | ✔ | ✔ | ✔ |
| Обнаружение перезаписи зафиксированной истории | — | ✔ | ✔ |
| Обнаружение отсутствующих/запоздалых контрольных точек | — | ✔ (согласованная периодичность) | ✔ |
| Доказательство того, что каждое действие было записано | — | — | зависит от границы фиксации |
Посмотрите пример перед установкой: образец Runtime Report — вымышленные данные, настоящая цепочка, и его скрипт пересчитывает хеш-цепочку встроенных записей в вашем браузере при открытии.
Агент не требуется. С uv ничего устанавливать не нужно:
uvx --from halo-record halo demo --serve
или классическим способом:
pip install halo-record
halo demo --serve
Любой из них создаёт вымышленного поставщика агентов поддержки с двумя клиентами, фиксирует цепочки (при этом локальный файл-свидетель заменяет одного внешнего участника — см. LIMITS.md §1), выдаёт их защищённые Runtime Reports и открывает консоль оператора в вашем браузере. Затем попробуйте тест на подмену: удалите строку из одного из файлов .jsonl и перезагрузите. Отчёт это обнаружит.
Одна строка на границе:
from halo_record import trace
agent = trace(run_my_agent, profile="my-agent", log="audit.jsonl") # wraps your entrypoint; records the run boundary to ./audit.jsonl — add record_call() or a framework adapter at each tool boundary to capture individual calls
Удобная обёртка from halo import ... также поставляется — но имя halo на PyPI принадлежит несвязанному пакету терминального спиннера, и если этот пакет установлен, он выигрывает импорт. halo_record однозначен, поэтому в примерах используется он.
Без log= записи попадают в ~/.halo/my-agent.jsonl (одна цепочка на агента). Обёртка фиксирует границу запуска; доказательства хранятся в записях отдельных вызовов. Захватывайте их с помощью адаптера фреймворка (матрица ниже) — или явно, что также показывает, как связывается делегирование:
from halo_record import Recorder, record_call
rec = Recorder("audit.jsonl")
with record_call(rec, "crm.lookup", {"account": "acct-9"}) as call: # one sealed record per tool call
call.result = crm.lookup("acct-9")