Remediëringshulpmiddel
De remediate tool neemt een of meer toegankelijkheidsproblemen die zijn geïdentificeerd door de analyze of igt tool en genereert contextbewuste, AI-aangedreven richtlijnen voor remediëring die programmeeragenten kunnen vertalen in daadwerkelijke codeoplossingen. Problemen worden als een batch ingediend, zodat één oproep oplossingen kan opleveren voor elke overtreding die op een pagina is gevonden.
Wat Het Doet
- Authenticatie - Valideert de gebruikersreferenties - een API-sleutel of een OAuth 2.0 toegangstoken - om geautoriseerde toegang te garanderen
- AI-krediet Gebruik - Elk probleem in de batch verbruikt AI-kredieten van de toewijzing van uw organisatie, waardoor het gebruik van geavanceerde AI-modellen mogelijk wordt die getraind zijn op de uitgebreide toegankelijkheidsexpertise van Deque
- AI-gegenereerde Remediëring - Creëert hoogwaardige, uitvoerbare toegankelijkheidsoplossingen die programmeeragenten kunnen interpreteren en implementeren in de broncode
Als de AI-kredieten op zijn, zal de remediate tool niet meer werken totdat uw kredieten zijn hersteld (hetzij door meer aan te schaffen of door uw maandelijkse cyclus te resetten). De analyze tool zal echter blijven functioneren.
Batch Remediëring
De tool accepteert een issues array. Dien alle de problemen van een enkele analyze of igt run in één oproep in plaats van de tool een keer per probleem te bellen - een batch ondersteunt tussen de 1 en 25 problemen.
Elk probleem heeft de volgende velden:
| Veld | Vereist | Beschrijving |
|---|---|---|
id |
Ja | Een door de oproeper gekozen identificatie, uniek binnen de batch (bijv. de regel-ID plus een teller: color-contrast-0). Wordt alleen gebruikt om elk resultaat te correleren met zijn invoer. |
rule |
Ja | De Axe regel-ID van de analyze/igt uitvoer (bijv. color-contrast, image-alt). |
elementHtml |
Ja | Het HTML-fragment van het overtredende element. |
remediation |
Ja | Een beschrijving van wat er mis is en wat er gerepareerd moet worden, afkomstig uit de samenvatting van het probleem (optioneel verrijkt met de beschrijving, helpttekst of AI-redenering). |
pageUrl |
Nee | De URL van de pagina die wordt gerepareerd, uit de analyze respons. |
Stuur uw AI-agent een prompt in natuurlijke taal - deze stelt de batch samen uit de analyseresultaten:
Analyze http://localhost:3000 and remediate every issue foundDe agent verwerkt de prompt en roept de remediate tool aan met een payload vergelijkbaar met:
{
"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"
}
]
}Uitvoer
De tool retourneert een array van resultaten per probleem, elk teruggekoppeld naar zijn invoer door id. Een resultaat heeft een van de twee vormen:
- Succes —
status: "ok", met eenremediationobject dat een algemene beschrijving, de remediëringsstappen en een concrete codeoplossing bevat - Fout —
status: "error", met eenerrorobject (codeenmessage) voor een probleem dat niet kon worden gerepareerd
{
"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": "..." }
}
]
}Resultaten zijn onafhankelijk: een mislukking van een probleem blokkeert geen richtlijnen voor de andere.
Kredietgebruik
De remediate tool maakt deel uit van het AI Kredietbeheersysteem. Elk probleem in een batch verbruikt kredieten van de maandelijkse toewijzing van uw organisatie. Beheerders kunnen het kredietgebruik monitoren via het Axe Account Portal.
