Agent-Reach: preparar y diagnosticar lectores web para agentes
Lea el límite de errores de doctor en Agent-Reach
Examine excepciones, estado anterior y saneamiento sin convertir una revisión local en auditoría completa.
Qué aprenderás
- Evitar éxito obsoleto
- Dos rutas de mensaje
- Pruebas propuestas
Antes de empezar
- Lectura básica de comandos y configuración
- Entorno de ensayo desechable y autorizado
Vincule salud, recuperación y respuesta sin almacenar secretos de cuenta ni convertir una comprobación en evidencia de todas las etapas.
Conclusiones clave
- La excepción limpia el backend del resultado.
- Ambos mensajes pasan por saneamiento de URL.
- Agregación unitaria no prueba todo el flujo.
Evitar éxito obsoleto
El comentario del código identifica canales singleton. Si check lanza una excepción, check_all asigna active=None en vez de copiar un backend posiblemente retenido de una ejecución anterior. El error no debe aparentar selección válida actual.
En la rama normal copia active_backend con getattr y conserva la lista configurada. Un valor activo no demuestra que la siguiente URL pueda recuperarse: eso necesita otra observación.
Dos rutas de mensaje
scrub_url_credentials se ejecuta después de la rama normal o la excepción. Así cubre mensajes esperados y errores que pueden repetir una URL configurada con credenciales en este límite de salida.
No examinamos cada regla del saneador ni todos los logs upstream. No afirme que ningún token, cookie o dato personal puede filtrarse. Revise el JSON efectivo antes de conservarlo.
Pruebas propuestas
Use canales ficticios que devuelvan ok, warn y una excepción tras conservar un backend antiguo. Compruebe que aparecen los demás canales y que el resultado fallido contiene active_backend:null. Pruebe el saneador aparte.
Estos casos no se ejecutaron. La integración completa necesita una sonda real y recuperación autorizada. El comportamiento unitario no demuestra permisos de cuenta ni integridad del documento.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Lea ramas normal y excepcional.
- 2
Pruebe un canal ficticio con backend antiguo.
- 3
Separe agregación, saneamiento y lectura real.
Ejemplo para copiar
{
"proposedFixture": true,
"channel": "demo",
"previousActiveBackend": "reader-a",
"checkRaises": true,
"expected": {
"status": "error",
"active_backend": null
},
"executed": false
}Preguntas frecuentes
¿Por qué limpiar el backend?
El singleton puede conservar el valor anterior.
¿Esto certifica todos los logs?
Solo se examina un límite de salida.
Fuentes
- Agent-Reach / agent_reach/doctor.pyFuente verificada 2026-09-18