Журнал действий AI-агента и контроль полномочий
Как фиксировать входные данные, вызовы инструментов, подтверждения человека, результат и безопасную остановку AI-агента.

Пример одной операции в журнале: повтор после тайм-аута
Вымышленная операция DEMO-042 — подготовить письмо по сделке. Журнал связывает намерение, проверку прав и фактический результат. Повторное нажатие или потерянный ответ не должны превращать одну операцию в два письма.
| Шаг DEMO-042 | Запись в журнале | Действие системы |
|---|---|---|
| Получен запрос | Роль sales-assistant; разрешённая сделка DEMO-17; действие draft_email. | Читает только разрешённый контекст; полный текст переписки и секреты в журнал не копируются. |
| Черновик подготовлен | Версия черновика v1; состояние awaiting_approval; отправка ещё не выполнена. | Показывает человеку адресата и содержание. Успешная генерация не считается отправкой. |
| Человек подтвердил | Решение связано с v1, адресатом и ключом операции DEMO-042-send. | Изменение текста или адресата отменяет старое подтверждение и требует нового. |
| Ответ почтового сервиса потерян | Состояние result_unknown; сохранены ключ операции и время вызова. | Автоматическая повторная отправка приостанавливается до проверки фактического состояния у провайдера. |
| Результат сверили | Найден один идентификатор сообщения у провайдера; статус sent подтверждён. | Повтор DEMO-042 возвращает прежний результат. Если сверить нельзя, операция передаётся человеку без слепого повтора. |
При приёмке воспроизведите потерю ответа, двойной запуск и изменение черновика после согласования. Проверяйте число внешних действий, а не только количество строк «успех» в интерфейсе.
Все идентификаторы демонстрационные; письмо не отправляется. Возможность безопасной сверки зависит от конкретного внешнего сервиса и должна быть проверена до включения автоматических повторов.
Журнал, который различает чтение, предложение и изменение
Ниже — безопасный журнал синтетической задачи DEMO-17. В нём нет токенов, текста реального клиента и секретов: сохраняются идентификатор операции, право, версия объекта, результат инструмента и решение человека.
Зачем фиксировать намерение
Строка журнала связывает входную цель с конкретным разрешённым действием. Поэтому чтение сделки, подготовка черновика письма и отправка письма — три разные операции, даже если пользователь воспринимает их как один диалог.
Как записывать неопределённость
Тайм-аут не равен ошибке и не равен успеху. Состояние отмечают как неизвестное, затем сверяют принимающую систему по ключу идемпотентности. Слепой повтор запрещён, пока фактический результат не установлен.
Что нельзя хранить
Секреты, полные персональные данные и содержимое защищённых документов в журнал не копируют. Для расследования достаточно ссылок на разрешённый объект, хеша версии, категории результата и защищённого маршрута к исходнику.
Разделите событие запроса и факт изменения
Сохраните ID операции, тип действия, версию объекта до записи и результат независимого чтения. В журнале не нужны секреты и полный текст клиента. Если принимающая система не даёт однозначного ответа, назначается ручная сверка вместо автоматической новой записи.
Фрагмент DEMO-LOG-17
Учебный образец. Перенесите структуру в рабочий документ и замените исходные условия своими.
- Инициатор
- Учебная роль sales-assistant; пользователь DEMO-U7.
- Объект
- Сделка DEMO-17, версия 12.
- Ключ повтора
- demo-17-follow-up-v12.
- Правило остановки
- Любое изменение цены или внешний вызов без подтверждения.
| Время | Операция | Право | Результат |
|---|---|---|---|
| 09:14:02 | Прочитать статус | Разрешено | Версия 12 получена |
| 09:14:04 | Предложить письмо | Разрешено | Черновик сохранён |
| 09:14:10 | Отправить письмо | Нужно согласование | Остановлено |
| 09:15:01 | Подтверждение U7 | Человек | Параметры версии 12 приняты |
| 09:15:03 | Отправить письмо | Одно действие | Ответ инструмента 202 |
| 09:15:05 | Повтор того же ключа | Запрещён | Дубликат не создан |
Сверка журнала при потерянном ответе инструмента
Учебная операция DEMO-WRITE-2 отправлена один раз. Соединение оборвалось до ответа. Журнал должен помочь установить состояние объекта, сохранив неопределённость до сверки. Проверьте, что после перезапуска обработчик начинает со сверки незавершённой операции. Пустая строка ответа в логе не даёт права считать действие невыполненным.
| Проверка | Наблюдение в учебном примере | Решение и доказательство |
|---|---|---|
| Намерение | Есть разрешение на конкретный объект и версию. | Это основание попытки, но не доказательство изменения. |
| Потеря ответа | Запрос отправлен, подтверждение не получено. | Статус «результат неизвестен»; повтор временно запрещён. |
| Сверка подтверждает запись | В принимающей системе найден результат с тем же ID операции. | Связать его с первой попыткой; новую запись не создавать. |
| Сверка неоднозначна | Есть похожий объект без доказанной связи с операцией. | Передать проверяющему; не помечать успехом и не удалять похожий объект. |
Демонстрация, а не обещание результата
Действия и системы вымышлены. Демонстрация показывает модель контроля и не означает, что агент имеет доступ к реальной CRM, почте или платёжным данным.
Что показывает демо
Показать, какие поля необходимы для аудита поведения агента и где автоматическое действие должно останавливаться до подтверждения человека.
AI-агент становится управляемым, когда каждое действие связано с ролью, разрешением, входом, результатом и правилом эскалации. Журнал нужен не после инцидента, а как часть критериев приёмки.
Журнал действий AI-агента и контроль полномочий
Как фиксировать входные данные, вызовы инструментов, подтверждения человека, результат и безопасную остановку AI-агента.
От события до решения человека
- 01
Задача
Агент получает цель и минимальный контекст.
- 02
Проверка прав
Матрица разрешений определяет доступный инструмент и лимит действия.
- 03
Выполнение
Вызов, ответ инструмента и преобразование сохраняются в журнале.
- 04
Подтверждение
Критичное действие выполняется только после решения человека.
Что должно работать в реальной системе
- права задаются отдельно для чтения и изменения
- секреты не попадают в журнал
- повтор действия идемпотентен или заблокирован
- критичные операции требуют подтверждения
- ошибка переводит процесс в контролируемое состояние
Чего нельзя заключить из демо
- Синтетические значения не подтверждают эффект для конкретной компании.
- Реальная точность зависит от источников, интеграций и контрольной выборки.
- Интерфейс показывает структуру решения, а не готовый универсальный продукт.
AI-агенты для бизнеса
Проектирование агента, инструментов, прав, тестов и мониторинга.