Сообщения об ошибках как интерфейс агента: проектирование сбоев API, после которых агент может восстановиться

Ваш API возвращает 400 неверных запросов с телом {"ошибка": "неверный ввод"}. Разработчик-человек открывает документацию на второй вкладке, сравнивает полезную нагрузку со схемой и исправляет ее менее чем за минуту. У ИИ-агента нет второй вкладки. У него есть отправленный запрос, строка, которую вы отправили обратно, и решение, которое он должен принять прямо сейчас. Так что угадывает. Он переупорядочивает поля. Он повторяет тот же вызов в случае, если сбой был временным. Он переименовывает user_id в userId, а затем обратно. Каждое предположение — это обход туда и обратно и несколько тысяч токенов контекста, и запуск заканчивается тем, что агент сообщает вашему пользователю, что ваш API не работает. Исправление не лучше документации. Агенты читают документы один раз, в запланированное время, а затем работают с тем, что возвращается по проводу. Тело ошибки — это интерфейс. Что видит агент, когда ваш API говорит «нет» Для человека сообщение об ошибке — это один из множества входных данных: документы, исходный код, поток Slack, последние пять минут памяти. Для агента тело ошибки близко ко всей среде для этого шага. Какие бы байты вы ни возвращали, они добавляются в контекстное окно, где они действуют как инструкции. Это означает, что каждая реакция на отказ должна отвечать на три вопроса сама по себе: Это мой?