Strumento di Rimedio

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

Lo strumento remediate prende una o più problematiche di accessibilità identificate dallo strumento analyze o igt e genera linee guida di rimedio contestuali e potenziate dall'intelligenza artificiale che gli agenti codificatori possono tradurre in reali correzioni di codice. Le problematiche vengono inviate in blocco, quindi una singola chiamata può restituire le correzioni per ogni violazione trovata su una pagina.

Cosa Fa

  1. Autenticazione - Convalida le credenziali dell'utente — sia una chiave API che un token di accesso OAuth 2.0 — per garantire l'accesso autorizzato
  2. Utilizzo Credito AI - Ogni problematica nel batch consuma crediti AI dall'allocazione della tua organizzazione, consentendo l'utilizzo di modelli AI avanzati addestrati sull'ampia esperienza di accessibilità di Deque
  3. Rimedio Generato dall'AI - Crea correzioni di accessibilità di alta qualità e praticabili che gli agenti codificatori possono interpretare e implementare nel codice sorgente
note

Se i crediti AI sono esauriti, lo strumento remediate non funzionerà più fino a quando i tuoi crediti non saranno ripristinati (tramite l'acquisto di nuovi o il reset del ciclo mensile). Tuttavia, lo strumento analyze continuerà a funzionare.

Rimedio Batch

Lo strumento accetta un array issues. Invia tutto le problematiche da un singolo analyze o esecuzione igt insieme in una chiamata piuttosto che chiamare lo strumento una volta per ogni problematica — un batch supporta tra 1 e 25 problematiche.

Ogni problematica ha i seguenti campi:

Campo Richiesto Descrizione
id Un identificatore scelto dal chiamante, unico all'interno del batch (es., l'ID della regola più un contatore: color-contrast-0). Utilizzato solo per correlare ogni risultato al suo input.
rule L'ID della regola Axe dall'output analyze/igt (es., color-contrast, image-alt).
elementHtml Il frammento HTML dell'elemento che viola le regole.
remediation Una descrizione di cosa non va e cosa necessita di riparazione, tratta dal sommario del problema (facoltativamente arricchita con la sua descrizione, testo di aiuto o ragionamento AI).
pageUrl No L'URL della pagina da riparare, dalla risposta analyze.

Invita il tuo agente AI in linguaggio naturale — costruisce il batch dai risultati dell'analisi:

Analyze http://localhost:3000 and remediate every issue found

L'agente risolve l'invito e chiama lo strumento remediate con un payload simile 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"
    }
  ]
}

Output

Lo strumento restituisce un array di risultati per ogni problematica, ognuno associato al suo input tramite id. Un risultato ha una delle due forme:

  • Successostatus: "ok", con un oggetto remediation contenente una descrizione generale, i passaggi di rimedio e una correzione di codice concreta
  • Errorestatus: "error", con un oggetto error (code e message) per un problema che non ha potuto essere risolto
{
  "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": "..." }
    }
  ]
}

I risultati sono indipendenti: un fallimento su una problematica non blocca le indicazioni per le altre.

Utilizzo dei Crediti

Lo strumento remediate fa parte del Sistema di Gestione dei Crediti AI. Ogni problematica in un batch consuma crediti dall'allocazione mensile della tua organizzazione. Gli amministratori possono monitorare l'utilizzo dei crediti tramite il Portale dell'Account Axe.