Outil de Remédiation
L'outil remediate prend un ou plusieurs problèmes d'accessibilité identifiés par l'outil analyze ou igt et génère des conseils de remédiation contextuels, alimentés par l'IA, que les agents de codage peuvent traduire en véritables corrections de code. Les problèmes sont soumis par lot, de sorte qu'un seul appel peut retourner des corrections pour chaque violation trouvée sur une page.
Fonctionnalités
- Authentification - Valide les informations d'identification de l'utilisateur — soit une clé API, soit un jeton d'accès OAuth 2.0 — pour garantir un accès autorisé
- Utilisation de Crédit AI - Chaque problème dans le lot consomme des crédits AI de l'allocation de votre organisation, permettant l'utilisation de modèles d'IA avancés formés avec l'expertise étendue en accessibilité de Deque
- Remédiation Générée par l'IA - Prépare des corrections d'accessibilité de haute qualité et actionnables que les agents de codage peuvent interpréter et mettre en œuvre dans le code source
Si les crédits AI sont épuisés, l'outil remediate ne fonctionnera plus tant que vos crédits ne seront pas restaurés (soit en achetant plus, soit après la réinitialisation de votre cycle mensuel). Cependant, l'outil analyze continuera de fonctionner.
Remédiation par Lot
L'outil accepte un tableau issues. Soumettez tous les problèmes d'une seule exécution analyze ou igt ensemble en un seul appel plutôt que d'appeler l'outil une fois par problème — un lot prend en charge entre entre 1 et 25 problèmes.
Chaque problème comporte les champs suivants :
| Champ | Requis | Description |
|---|---|---|
id |
Oui | Un identifiant choisi par l'appelant, unique dans le lot (par exemple, l'ID de la règle plus un compteur : color-contrast-0). Utilisé uniquement pour corréler chaque résultat à son entrée. |
rule |
Oui | L'ID de la règle Axe à partir de la sortie analyze/igt (par exemple, color-contrast, image-alt). |
elementHtml |
Oui | L'extrait HTML de l'élément en violation. |
remediation |
Oui | Une description de ce qui ne va pas et de ce qui doit être corrigé, tirée du résumé du problème (éventuellement enrichie de sa description, de son texte d'aide ou de son raisonnement IA). |
pageUrl |
Non | L'URL de la page en cours de remédiation, à partir de la réponse analyze. |
Soumettez votre requête à votre agent IA en langage naturel — il constitue le lot à partir des résultats de l'analyse :
Analyze http://localhost:3000 and remediate every issue foundL'agent résout la requête et appelle l'outil remediate avec une charge utile similaire à :
{
"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"
}
]
}Résultats
L'outil retourne un tableau de résultats par problème, chacun référencé à son entrée par id. Un résultat prend l'une des deux formes :
- Succès —
status: "ok", avec un objetremediationcontenant une description générale, les étapes de remédiation et une correction de code concrète - Erreur —
status: "error", avec un objeterror(codeetmessage) pour un problème qui n'a pas pu être remédié
{
"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": "..." }
}
]
}Les résultats sont indépendants : un échec sur un problème n'empêche pas la fourniture de conseils pour les autres.
Utilisation des Crédits
L'outil remediate fait partie du Système de Gestion des Crédits AI. Chaque problème dans un lot consomme des crédits de l'allocation mensuelle de votre organisation. Les administrateurs peuvent surveiller l'utilisation des crédits via le portail de compte Axe.