Documentazione AX Protocol — installare e configurare un sito WordPress pronto per gli agentiAX Protocol — Documentazione

Convivere con SEO, cache e CDN

Quasi tutti i siti che installano AX Protocol hanno già un plugin SEO, uno strato di cache e spesso un CDN. Tutti e tre toccano esattamente i file che il protocollo genera: conviene quindi stabilire l’ordine delle operazioni prima di iniziare, invece di doverlo indagare dopo. Il tuo plugin SEO resta il proprietario di sitemap.xml e dei tag canonici. AX Protocol non sostituisce né l’uno né gli altri; aggiunge uno strato di manifesto al di sopra. Quando due componenti scrivono sullo stesso percorso, vince l’ultimo della catena: verifica sempre il file pubblicato invece di fidarti della schermata delle impostazioni.

La cache è di gran lunga la prima causa di problemi che sembrano bug del protocollo. Un manifesto messo in cache prima di una modifica alle impostazioni continuerà a essere servito agli agenti per ore, e il sito dichiarerà una struttura che non corrisponde più al suo contenuto. La regola è semplice: dopo ogni modifica, svuota tutta la cache e controlla il file pubblicato in una finestra anonima. Se usi un CDN, aggiungi anche una purge sull’edge, altrimenti l’origine serve la nuova versione mentre visitatori e agenti ricevono ancora la vecchia.

Il terzo componente è il firewall applicativo. Diversi fornitori bloccano per impostazione predefinita le richieste prive di un’impronta di browser riconosciuta, e gli agenti IA rientrano in pieno in quella categoria. Se i controlli locali passano ma la stessa richiesta da internet restituisce un 403, sospetta una regola di blocco prima di sospettare il plugin. Inizia aggiungendo i percorsi del manifesto alla lista di autorizzazione.

Verifiche manuali

La dashboard riporta ciò che il plugin ritiene di aver pubblicato. Non è la stessa cosa di ciò che un agente riceve, e le due cose divergono più spesso di quanto ci si aspetti. Quattro controlli richiedono circa cinque minuti e intercettano la maggior parte dei guasti reali.

Primo: richiedi il manifesto con un semplice client HTTP anziché con un browser e conferma di ottenere un 200 e JSON valido, non una pagina di challenge HTML. Secondo: preleva allo stesso modo una pagina di contenuto importante e verifica che il testo sostanziale sia presente nella risposta grezza — se il corpo arriva vuoto, il contenuto viene iniettato da JavaScript e gli agenti non lo vedranno mai. Terzo: segui ogni URL dichiarato nel manifesto e conferma che nessuno rediriga o restituisca 404, perché un manifesto che punta a percorsi morti è peggio di nessun manifesto. Quarto: ripeti il primo controllo dall’esterno della tua rete, idealmente da una connessione mobile, per escludere una lista di autorizzazione per IP che fa sembrare sano solo il tuo ufficio.

Annota i risultati da qualche parte. Quando fra tre mesi qualcosa si romperà, la via più rapida alla diagnosi sarà la traccia di come appariva uno stato funzionante.

Aggiornamenti, migrazioni e compatibilità nel tempo

Cambiare hosting, cambiare dominio o spostarsi su un sottodominio sono gli eventi che più facilmente rompono la configurazione del protocollo, perché gli URL assoluti salvati nelle impostazioni continuano a puntare alla vecchia posizione. Documenta la configurazione prima di una migrazione e ripercorri poi ogni percorso del manifesto per confermare che risolva al nuovo indirizzo. Se il sito è passato anche da HTTP a HTTPS, controlla i redirect duplicati lungo il percorso: una catena di redirect lunga porta alcuni agenti ad abbandonare la richiesta a metà strada.

Gli aggiornamenti del plugin sono meno rischiosi, ma non privi di rischio. La specifica è versionata, e un cambio di versione maggiore può modificare i nomi dei campi nel manifesto. Leggi la nota di rilascio prima di un aggiornamento maggiore e, se hai costruito qualcosa che consuma il tuo stesso manifesto, provalo con il nuovo output prima di andare in produzione.

Se hai tempo solo per tre cose

Se questa è una prima implementazione e non riesci a seguire ogni sezione, tre elementi portano quasi tutto il valore: un manifesto valido che risolve al percorso atteso, una descrizione dell’organizzazione in una riga, accurata, che dica che cosa fa il sito e per chi, e un catalogo di servizi che contenga le pagine che vuoi davvero veder citate. Tutto il resto — endpoint estesi, impostazioni di permessi, individuazione avanzata — si può aggiungere in modo graduale. Un sito con questi tre elementi è già ragionevolmente leggibile per gli agenti, e potrai migliorarlo sulla base di ciò che mostrano i log del server invece che a intuito.

Dove si colloca AX Protocol in un sito multilingue

Se il sito funziona in più lingue, decidi presto quale lingua descrive il manifesto. Il protocollo emette un manifesto per ogni variante linguistica, e gli agenti seguono gli stessi segnali hreflang dei motori di ricerca: un insieme di traduzioni collegato correttamente fa sì che un agente che interroga in spagnolo raggiunga la pagina spagnola anziché quella inglese. Un insieme di traduzioni rotto fa collassare ogni lingua sulla predefinita, il che è peggio che non avere traduzioni.

La verifica è rapida: preleva la radice di ogni lingua e conferma che i link alternate elenchino tutte le varianti più x-default, e che ogni variante punti a un URL che restituisce 200 in quella lingua. I siti costruiti clonando pagine da una lingua all’altra falliscono spesso questo test, perché le copie non sono mai state legate in un gruppo di traduzione e ciascuna si presenta agli agenti come un documento senza relazione.