Обычная интеграция идет по заранее заданному маршруту. Агент сам выбирает следующий инструмент и его параметры. Поэтому до подключения реальных данных я бы проверил семь вещей.

Список опирается на актуальные материалы OWASP. В них разобраны избыточные полномочия агента LLM03:2026, риски агентных систем Agentic Top 10 2026 и проверка прав на каждый объект API API1:2023.

1. Запишешь цель и границу Да: цель звучит так "записать пользователя на свободное место, не меняя чужие бронирования".

Нет: в задаче есть только "добейся записи". Сначала запиши, чего агенту нельзя делать ради результата.

2. Разделишь права Да: чтение, создание, изменение и удаление будут отдельными разрешениями. Ключ хранится вне промпта и кода, а токен дает только нужные для задачи права.

Нет: один токен позволяет сразу смотреть, менять и удалять данные. Раздели операции и сократи права до необходимых.

3. Оставишь только нужные методы Да: для записи в спортзал агент видит расписание и может создать бронь только для текущего пользователя. В описании каждого метода указаны его назначение, обязательные параметры и результат.

Нет: агенту доступна отмена чужой записи, но промпт запрещает ее вызывать. Слова в промпте не заменяют техническое ограничение.

4. Проверишь доступ к чужой записи В тесте подставь идентификатор записи другого пользователя.

Да: API вернул отказ. Значит, права проверяются для каждого объекта.

Нет: запрос прошел. Агент может изменить чужие данные, значит подключать его к реальным пользователям пока нельзя.

5. Потребуешь подтверждение Да: перед платежом, отправкой сообщения, удалением или сменой доступа система показывает действие и ждет решения человека.

Нет: агент может выполнить запрос сразу после того, как сам выбрал действие. Добавь подтверждение перед вызовом API.

6. Найдешь в журнале каждый шаг Открой одну тестовую операцию.

Да: в журнале есть пользователь, действие, объект, параметры, ответ API и решение человека. По этим данным можно восстановить ход ошибки.

Нет: сохранился только финальный ответ агента. Для расследования этого недостаточно.

7. Проверишь откат и сбои Сделай тестовое изменение и откати его. Затем смоделируй истекший токен, тайм-аут и ответы 429/5xx.

Да: исходное состояние восстановилось, а при сбое агент останавливается или повторяет запрос по заданному правилу. Он не зацикливается и не повторяет необратимое действие.

Нет: обратной операции нет или сбой запускает бесконечные повторы. Оставь такое действие человеку или не подключай его к агенту.

Семь ответов "да" не гарантируют безошибочную работу. Это минимум перед ограниченным пилотом. Если API позволяет менять чужой объект, опасное действие проходит без подтверждения или его нельзя откатить, доступ к реальным данным я бы не открывал.

#it #чек_лист #ИИ #агенты #API #системныйАнализ

Ваш Аналитик на Балтике 🌊 🌐 ineverov.ru