Синтетическая демонстрация

Журнал действий 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-агента.

Чтение CRMразрешено
Подтверждено
Отправка письманужно подтверждение
Внимание
Изменение ценызапрещено
Критично
Маршрут

От события до решения человека

  1. 01

    Задача

    Агент получает цель и минимальный контекст.

  2. 02

    Проверка прав

    Матрица разрешений определяет доступный инструмент и лимит действия.

  3. 03

    Выполнение

    Вызов, ответ инструмента и преобразование сохраняются в журнале.

  4. 04

    Подтверждение

    Критичное действие выполняется только после решения человека.

Проверка

Что должно работать в реальной системе

  • права задаются отдельно для чтения и изменения
  • секреты не попадают в журнал
  • повтор действия идемпотентен или заблокирован
  • критичные операции требуют подтверждения
  • ошибка переводит процесс в контролируемое состояние
Ограничения

Чего нельзя заключить из демо

  • Синтетические значения не подтверждают эффект для конкретной компании.
  • Реальная точность зависит от источников, интеграций и контрольной выборки.
  • Интерфейс показывает структуру решения, а не готовый универсальный продукт.
Связанное решение

AI-агенты для бизнеса

Проектирование агента, инструментов, прав, тестов и мониторинга.

Открыть услугу