Урок 2.2Урок 9 з 30

Структуровані помилки MCP-інструментів

Implement structured error responses for MCP tools

Головне

1Інструмент повідомляє про збій MCP-прапорцем isError. Так агент розуміє, що виклик не вдався, і не сприймає текст помилки як дані.
2Повертайте errorCategory (transient, validation, business, permission), isRetryable і зрозумілий людині опис. З відповіді «Operation failed» агенту нема з чого вирішувати.
3Порушення бізнес-правила повтором не виправити. Додайте зрозуміле клієнтові пояснення, яке агент зможе йому передати.
4Тимчасові збої субагент повторює сам, а далі передає лише те, що не зміг вирішити, — разом із частковими результатами й переліком того, що вже пробував.
5«No matching records» — коректний порожній результат, а «Could not reach the database» — збій. Ніколи не видавайте одне за інше.

Що перевіряє іспит із цієї теми

Формулювання з програми іспиту (англійською).

2.2.K1MCP isError flag communicates tool failures to the agent
2.2.K2Error kinds: transient, validation, business (policy), permission
2.2.K3Uniform generic errors ("Operation failed") block good recovery decisions
2.2.K4Retryable vs non-retryable; structured metadata prevents wasted retries
2.2.S1Return errorCategory, isRetryable and a human-readable description
2.2.S2Business rule violations: retriable false plus customer-friendly explanation
2.2.S3Subagents recover locally from transient failures; propagate only unresolved errors with partial results and attempts
2.2.S4Distinguish access failures from valid empty results

Дайте відповідь на запитання за сценаріями з цієї теми. До кожного варіанта є розбір.