Обработка ошибок в MCP: проектирование устойчивых рабочих процессов
Создавайте надёжные MCP-процессы, которые изящно обрабатывают ошибки. Это руководство объясняет распространённые категории ошибок (аутентификация, валидация, сеть, лимиты запросов) и показывает, как проектировать промпты, восстанавливающиеся после сбоев, с помощью переиспользуемых шаблонов восстановления.
Категории ошибок
Ошибки аутентификации (401, 403)
Восстановление после ошибки аутентификации
"Если при вызове инструментов Workify возникает ошибка 401 или 403: 1. Сообщи мне, что есть проблема с аутентификацией 2. Предложи проверить API-ключ в конфигурации 3. Не повторяй операцию автоматически 4. Дождись, пока я исправлю проблему с аутентификацией"
Частые причины:
- Недействительный или просроченный API-ключ
- Отсутствует заголовок Authorization
- Недостаточно прав
Ошибки валидации (400)
Восстановление после ошибки валидации
"Если при вызове инструментов Workify возникает ошибка валидации (400): 1. Покажи мне сообщение об ошибке чётко 2. Определи, какое поле недействительно 3. Предложи, каким должен быть правильный формат 4. Спроси, хочу ли я повторить с исправленными данными"
Частые причины:
- Отсутствуют обязательные поля
- Неверный формат поля (даты, ID)
- Недопустимые значения полей
Сетевые ошибки
Восстановление после сетевой ошибки
"Если при вызове инструментов Workify возникает сетевая ошибка (сбой соединения, тайм-аут): 1. Сообщи мне, что есть проблема с сетью 2. Подожди немного, затем повтори один раз 3. Если повтор не удался, предложи проверить сетевое подключение 4. Не повторяй автоматически более одного раза"
Частые причины:
- Проблемы с сетевым подключением
- Тайм-аут сервера
- Проблемы с разрешением DNS
Ограничение частоты запросов (429)
Восстановление после ограничения запросов
"Если при вызове инструментов Workify возникает ошибка 429 (превышен лимит запросов): 1. Сообщи мне, что запрос был ограничен по частоте 2. Подожди несколько секунд перед повтором 3. Сократи число вызовов инструментов (пакетные операции) 4. Если лимит всё ещё превышен, предложи разбить операцию на меньшие шаги"
Частые причины:
- Слишком много запросов за короткое время
- Крупные пакетные операции
- Циклы вызовов инструментов
Шаблоны промптов восстановления
Шаблон 1: изящный отказ
Паттерн обработки ошибок
"При вызове инструментов Workify, если ты столкнёшься с любой ошибкой: 1. Покажи мне сообщение об ошибке чётко 2. Объясни, что означает ошибка, простым языком 3. Предложи, как её исправить 4. Спроси, хочу ли я повторить или попробовать другой подход 5. Не повторяй автоматически более одного раза"
Этот паттерн: изящно обрабатывает ошибки, даёт указания, спрашивает направление
Шаблон 2: повтор с задержкой
Паттерн повтора
"Если вызов инструмента завершается сетевой ошибкой или тайм-аутом: 1. Подожди 2 секунды 2. Повтори операцию один раз 3. Если снова не удалось, сообщи мне и предложи проверить сеть 4. Не повторяй более одного раза"
Этот паттерн: обрабатывает временные ошибки, предотвращает бесконечные повторы
Шаблон 3: запасная стратегия
Паттерн запасного варианта
"Если получить список всех задач не удаётся: 1. Попробуй вместо этого получить задачи по конкретному проекту 2. Если это сработало, покажи мне эти задачи 3. Сообщи, что при необходимости можно расширить до других проектов 4. Предложи, что проблема может быть в запросе полного списка"
Этот паттерн: пробует альтернативные подходы, когда основной не срабатывает
Полные примеры
Пример 1: устойчивый список задач
Устойчивый к ошибкам промпт
"Покажи мои задачи из Workify со сроком на этой неделе. Если столкнёшься с ошибками: - При ошибках аутентификации (401/403): скажи проверить API-ключ, не повторяй - При сетевых ошибках: подожди 2 секунды и повтори один раз - При лимитах запросов (429): подожди 5 секунд и повтори один раз - При ошибках валидации (400): покажи ошибку и попроси исправление - Если все повторы не удались, скажи, что пошло не так, и предложи дальнейшие шаги"
Этот паттерн: обрабатывает все типы ошибок с подходящим восстановлением
Пример 2: безопасная пакетная операция
Устойчивое к ошибкам пакетное обновление
"Обнови 5 задач на статус 'in_progress'. Если какое-либо обновление не удалось: - Покажи мне, какие задачи успешны, а какие нет - Для неудавшихся задач покажи сообщение об ошибке - Спроси, хочу ли я повторить неудавшиеся - Не повторяй автоматически — дождись моего решения"
Этот паттерн: обработка частичного успеха, повторы под контролем пользователя
Лучшие практики
Лучшие практики обработки ошибок
- Показывайте ошибки чётко: всегда отображайте сообщения об ошибках пользователю
- Объясняйте простым языком: переводите технические ошибки в понятные термины
- Предлагайте решения: давайте конкретные шаги для устранения ошибок
- Ограничивайте повторы: не повторяйте бесконечно — задайте разумные лимиты
- Обрабатывайте частичный успех: для пакетных операций показывайте, что удалось/не удалось
- Спрашивайте перед повтором: для критичных операций спрашивайте разрешение перед повтором
Связанные материалы
Указатель по устранению неполадок
Полное руководство по устранению неполадок
Сбои вызова инструментов
Отладка проблем с вызовами инструментов
Ограничение частоты запросов
Обработка лимитов запросов
Руководство по пакетной обработке
Сокращение числа вызовов инструментов
Создавайте устойчивые MCP-процессы
Используйте паттерны обработки ошибок, чтобы создавать надёжные промпты, изящно восстанавливающиеся после сбоев