Herramienta de Remediación
La herramienta remediate toma uno o más problemas de accesibilidad identificados por la herramienta analyze o igt y genera una guía de remediación contextualizada y potenciada por IA que los agentes de codificación pueden traducir en correcciones de código reales. Los problemas se envían en lotes, por lo que una sola llamada puede devolver correcciones para cada violación encontrada en una página.
Lo Que Hace
- Autenticación - Valida las credenciales del usuario—ya sea una clave de API o un token de acceso OAuth 2.0—para asegurar el acceso autorizado
- Uso de Crédito de IA - Cada problema en el lote consume créditos de IA de la asignación de tu organización, permitiendo el uso de modelos de IA avanzados entrenados con la amplia experiencia en accesibilidad de Deque
- Remediación Generada por IA - Elabora soluciones de accesibilidad de alta calidad y accionables que los agentes de codificación pueden interpretar y aplicar en el código fuente
Si los créditos de IA se agotan, la herramienta remediate dejará de funcionar hasta que se restablezcan tus créditos (ya sea comprando más o cuando se reinicie tu ciclo mensual). Sin embargo, la herramienta analyze continuará funcionando.
Remediación en Lote
La herramienta acepta un arreglo de issues. Envía todos los problemas de una única ejecución analyze o igt juntos en una sola llamada en lugar de llamar a la herramienta una vez por problema: un lote admite entre 1 y 25 problemas.
Cada problema tiene los siguientes campos:
| Campo | Requerido | Descripción |
|---|---|---|
id |
Sí | Un identificador elegido por el autor de la llamada, único dentro del lote (por ejemplo, el ID de regla más un contador: color-contrast-0). Utilizado solo para correlacionar cada resultado con su entrada. |
rule |
Sí | El ID de regla Axe del resultado analyze/igt (por ejemplo, color-contrast, image-alt). |
elementHtml |
Sí | El fragmento HTML del elemento infractor. |
remediation |
Sí | Una descripción de lo que está mal y lo que necesita corregirse, tomada del resumen del problema (opcionalmente enriquecida con su descripción, texto de ayuda o razonamiento de IA). |
pageUrl |
No | La URL de la página que se está remediando, del resultado analyze. |
Indica a tu agente de IA en lenguaje natural — este ensambla el lote a partir de los resultados del análisis:
Analyze http://localhost:3000 and remediate every issue foundEl agente resuelve la solicitud y llama a la herramienta remediate con una carga útil similar a:
{
"issues": [
{
"id": "color-contrast-0",
"rule": "color-contrast",
"elementHtml": "<span style=\"color: #aaa\">Sign up</span>",
"remediation": "Increase the contrast ratio to at least 4.5:1",
"pageUrl": "http://localhost:3000"
},
{
"id": "image-alt-1",
"rule": "image-alt",
"elementHtml": "<img src=\"logo.png\">",
"remediation": "Add alt text describing the image"
}
]
}Salida
La herramienta devuelve un arreglo de resultados por problema, cada uno vinculado de nuevo a su entrada por id. Un resultado tiene una de dos formas:
- Éxito —
status: "ok", con un objetoremediationque contiene una descripción general, los pasos de remediación y una corrección de código concreta - Error —
status: "error", con un objetoerror(codeymessage) para un problema que no pudo ser remediado
{
"data": [
{
"id": "color-contrast-0",
"status": "ok",
"remediation": {
"general_description": "...",
"remediation": "...",
"code_fix": "<span style=\"color: #595959\">Sign up</span>"
}
},
{
"id": "image-alt-1",
"status": "error",
"error": { "code": "LLM_ERROR", "message": "..." }
}
]
}Los resultados son independientes: un fallo en un problema no bloquea la guía para los demás.
Uso de Créditos
La herramienta remediate es parte del Sistema de Gestión de Créditos de IA. Cada problema en un lote consume créditos de la asignación mensual de tu organización. Los administradores pueden monitorear el uso de créditos a través del Portal de Cuentas de Axe.