Руководство по интеграции
Обновлено: 2026-07-04
*Дисклеймер: Данный технический материал носит исключительно информационный характер и не является финансовой рекомендацией.*
## Как реализовать аудит и трассировку решений (Decision Trace) в автономных ИИ-агентах?
Трассировка решений (Decision Trace) — это системный протокол логирования каждого шага автономных ИИ-агентов. Он преобразует абстрактные рассуждения нейросети в структурированный аудит, фиксируя входные метрики среды, цепочку рассуждений, детерминированные проверки безопасности и параметры выполненных команд. Это гарантирует прозрачность, управляемость и возможность быстрого автоматического восстановления системы после сбоев.
### Структура Decision Trace
Каждое решение агента сопровождается записью в структурированный лог (Blackboard Ledger), содержащий:
1. **Входные данные (Observe)**: Точный срез состояния внешней среды (цены, лимиты, системные переменные), на основе которого принималось решение.
2. **Логическая трассировка (Orient/Decide)**: Краткое изложение («цепочка рассуждений» или score-карты), обосновывающее выбор конкретного действия.
3. **Проверка ограничений (Verify Preconditions)**: Прохождение детерминированных фильтров безопасности (проверка балансов, сверка лимитов, права доступа паспорта SAP) до отправки команды.
4. **Акт действия (Act)**: Параметры выполненной команды и возвращенный системой ID (например, ID транзакции или дельты).
### Применение к Continuity OS и боту
Любая транзакция или изменение фазы в Continuity OS записывается в `proof_ledger.jsonl` и `trading_deltas.jsonl` с указанием Actor ID и сводки дельт. Торговый бот сохраняет все действия в `btcusdt_actions.jsonl`. Это позволяет:
- Восстанавливать контекст при сбоях (агент читает последние трассировки решений для понимания текущей диспозиции).
- Проводить аудит безопасности (оператор может проверить, не было ли действие вызвано инъекцией промпта).
- Автоматически корректировать лимиты на основе прошлых решений.
*Дисклеймер: Данный технический материал носит исключительно информационный характер и не является финансовой рекомендацией.*
## Как реализовать аудит и трассировку решений (Decision Trace) в автономных ИИ-агентах?
Трассировка решений (Decision Trace) — это системный протокол логирования каждого шага автономных ИИ-агентов. Он преобразует абстрактные рассуждения нейросети в структурированный аудит, фиксируя входные метрики среды, цепочку рассуждений, детерминированные проверки безопасности и параметры выполненных команд. Это гарантирует прозрачность, управляемость и возможность быстрого автоматического восстановления системы после сбоев.
| Ключевой компонент трассировки и логирования | Описание и функциональная роль в аудите | Применяемый файл/инструмент в системе |
|---|---|---|
| 1. Observe (Входные данные) | Точный срез состояния внешней среды, лимитов, балансов и переменных на момент принятия решения. | Снапшот цен, API биржи, state.json и лимиты |
| 2. Orient/Decide (Рассуждения) | Логические выводы LLM, цепочки мыслей и скоринговые карты, обосновывающие выбор действия. | Системный контекст, prompt_compression и entropy_compression |
| 3. Verify (Безопасность) | Прохождение жестких детерминированных фильтров безопасности и проверка паспорта способностей SAP. | invariants.py, safe_write.py и OODA-циклы |
| 4. Act (Выполнение команды) | Параметры выполненного действия, хэши транзакций, измененные файлы и ID полученных дельт. | proof_ledger.jsonl, trading_deltas.jsonl и внешние журналы СУБД |
| 5. Retention (Хранение) | Длительность хранения и максимальный размер журналов трассировки решений во избежание переполнения. | Настройка ротации (trace_retention_days) |
| 6. Audit (Ретроспектива) | Анализ записанных цепочек оператором для выявления дрейфа или попыток обхода безопасности. | DEVIL_ADVOCATE_REVIEW, logs/ |
### Структура Decision Trace
Каждое решение агента сопровождается записью в структурированный лог (Blackboard Ledger), содержащий:
1. **Входные данные (Observe)**: Точный срез состояния внешней среды (цены, лимиты, системные переменные), на основе которого принималось решение.
2. **Логическая трассировка (Orient/Decide)**: Краткое изложение («цепочка рассуждений» или score-карты), обосновывающее выбор конкретного действия.
3. **Проверка ограничений (Verify Preconditions)**: Прохождение детерминированных фильтров безопасности (проверка балансов, сверка лимитов, права доступа паспорта SAP) до отправки команды.
4. **Акт действия (Act)**: Параметры выполненной команды и возвращенный системой ID (например, ID транзакции или дельты).
### Применение к Continuity OS и боту
Любая транзакция или изменение фазы в Continuity OS записывается в `proof_ledger.jsonl` и `trading_deltas.jsonl` с указанием Actor ID и сводки дельт. Торговый бот сохраняет все действия в `btcusdt_actions.jsonl`. Это позволяет:
- Восстанавливать контекст при сбоях (агент читает последние трассировки решений для понимания текущей диспозиции).
- Проводить аудит безопасности (оператор может проверить, не было ли действие вызвано инъекцией промпта).
- Автоматически корректировать лимиты на основе прошлых решений.