Руководство по интеграции
### Введение
При работе автономных ИИ-агентов «черный ящик» нейросети создает высокие операционные риски. Невозможность понять, *почему* агент совершил конкретное действие (например, удалил файл или вошел в сделку), делает систему неуправляемой. Протокол **Decision Trace** (трассировка решений) решает эту проблему, превращая логические рассуждения LLM в проверяемый структурированный аудит.
### Структура 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** (трассировка решений) решает эту проблему, превращая логические рассуждения LLM в проверяемый структурированный аудит.
### Структура 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`. Это позволяет:
- Восстанавливать контекст при сбоях (агент читает последние трассировки решений для понимания текущей диспозиции).
- Проводить аудит безопасности (оператор может проверить, не было ли действие вызвано инъекцией промпта).
- Автоматически корректировать лимиты на основе прошлых решений.