Remediëringshulpmiddel

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data

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

  1. Authenticatie - Valideert de gebruikersreferenties - een API-sleutel of een OAuth 2.0 toegangstoken - om geautoriseerde toegang te garanderen
  2. 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
  3. AI-gegenereerde Remediëring - Creëert hoogwaardige, uitvoerbare toegankelijkheidsoplossingen die programmeeragenten kunnen interpreteren en implementeren in de broncode
note

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 found

De 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:

  • Successtatus: "ok", met een remediation object dat een algemene beschrijving, de remediëringsstappen en een concrete codeoplossing bevat
  • Foutstatus: "error", met een error object (code en message) 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.