Агент сказал «отчёт готов»: как проверить, что артефакт действительно существует
Текст «готово» легко получить даже при ошибке сохранения файла. Пользователю нужен доступный результат, а не уверенная финальная реплика. Для задач с артефактом определите критерии завершения: объект создан, содержимое прошло проверку, права настроены и ссылка открывается.
Разделите успешное вычисление и успешную доставку. Отчёт может быть правильно сформирован в памяти, но не записан в хранилище либо недоступен получателю.
Где возникает ошибка
Данные ниже вымышлены: они показывают способ разбора, а не измерения действующего сервиса.
| Проверка | Учебное ожидание | Возможный сбой |
|---|---|---|
| Наличие объекта | Файл существует | Запись не произошла |
| Содержание | Есть три раздела | Сохранён пустой шаблон |
| Доступ | Пользователь открывает | Ссылка принадлежит исполнителю |
В учебном случае агент должен получить подтверждение хранилища и выполнить ограниченную проверку результата. Нельзя объявлять успех только потому, что инструмент вернул строку с похожим адресом. Идентификатор и фактическое состояние объекта проверяются отдельно.
Критерии содержания должны быть предметными. Размер файла больше нуля не доказывает, что в таблице правильные данные, а наличие заголовка не означает готовность анализа.
Как воспроизвести проблему
Смоделируйте отказ записи, пустой файл, неверные права и истёкшую ссылку. Проверьте, что каждый случай даёт точный статус, а не общее «выполнено». Для сохранённого результата повторно считайте минимальную часть и сравните с ожидаемым манифестом.
В финальном сообщении показывайте проверенный адрес и ограничения результата. Если файл создан, но доставка не удалась, не запускайте всё вычисление заново без необходимости. Сохраните связь задачи с артефактом и версией, чтобы пользователь не получил ссылку на прошлый отчёт.
Что учитывать при переносе
Проверка артефакта может требовать дополнительных прав. Не расширяйте их автоматически ради удобства. При невозможности проверить открытие пользователем явно укажите, какая часть подтверждена и какая требует проверки доступа.
Явный workflow позволяет отделить создание, проверку и доставку результата вместо одного непрозрачного шага. Официальная документация помогает уточнить технический механизм; предложенный диагностический протокол — наш учебный пример.
Если хотите связать этот разбор с системной практикой, посмотрите программу AI Agents PRO на Latorn: она охватывает граф состояний, инструменты, надёжность и эксплуатацию агентов. Перед оплатой сопоставьте требования курса со своим опытом и задачей проекта.
Следующий шаг: AI-агенты в приложениях: состояние, инструменты и сбои. По смежным вопросам: Агент получил ответ инструмента: как сохранить происхождение фактов, Как остановить AI-агента, если пользователь отменил задачу.
