Solución de problemas
Diagnosticar fallas de autenticación, acceso, validación, conflictos y facturación.
| Síntoma | Consultar |
|---|---|
| 401 / no autenticado | epismo whoami, vencimiento del token, estado de inicio de sesión |
| 403 / prohibido | espacio de trabajo, ámbito, rol de propietario, ACL de objeto |
| 404 / no encontrado | ID, estado del archivo, ACL actual; los objetos ocultos también pueden aparecer ausentes |
| 409 / conflicto | vuelva a leer la última versión del caso, tarea o libro de estrategias y reconsidere el cambio |
| 422 / validación | esquema de entrada, campos obligatorios, ID de pasos, referencias de recursos |
| 402 / crédito insuficiente | espacio de trabajo activo y saldo de crédito |
| 429 / límite de tarifa | detenga los bucles inmediatos, retroceda y vuelva a intentarlo |
Para fallas de CLI, inspeccione el código de error stderr, el mensaje y los campos reintentables. Para MCP, clasifique una falla de la herramienta como autenticación, entrada o concurrencia antes de actuar.
Reutilice una clave de idempotencia solo para una solicitud incierta idéntica. Utilice una nueva clave después de corregir la validación o reconstruir la intención desde un estado nuevo.