Una quota crescente delle persone che ci trovano non vede mai per prima la nostra home page. Chiedono a un assistente, e l’assistente legge il web per loro. Se non riesce a leggere il nostro sito in modo pulito, tira a indovinare, e le congetture sui clienti, le date e i lavori di uno studio sono proprio il genere di cosa che va storta.
Così abbiamo trattato gli assistenti di SI come un pubblico di prima classe e abbiamo reso vuild.com facile da leggere, citare e con cui parlare. Tutto ciò che segue è generato dagli stessi contenuti del sito, quindi non può diventare obsoleto.
Una mappa scritta per i modelli linguistici
Il primo passo è stato llms.txt, un breve riepilogo in testo semplice alla radice del sito: chi siamo, cosa facciamo, i nostri case study e progetti con le date, e i link a tutto il resto. Accanto c’è llms-full.txt, la versione lunga, con ogni case study e progetto per intero, le FAQ e cosa dicono di noi i clienti.
Entrambi sono generati dai contenuti del sito a ogni modifica, quindi corrispondono sempre a ciò che c’è nelle pagine.
Gemelli in Markdown
Ogni pagina principale ha ora un gemello in Markdown: gli stessi fatti dell’HTML, senza l’impaginazione. Il case study di AmpUp si trova su /ampup per le persone e su /ampup.md per gli agenti che preferiscono il testo semplice. Ogni pagina rimanda al suo gemello nell’intestazione, e llms.txt li elenca tutti.
Fatti strutturati, non solo prosa
Motori di ricerca e assistenti si affidano molto ai dati strutturati, quindi ne abbiamo aggiunti altri:
- Markup FAQ nella pagina Chi siamo, che risponde alle domande che le persone ci fanno davvero.
- Recensioni: le testimonianze dei clienti sono marcate come recensioni con nome.
- Relazioni reali: i case study collegano i clienti ai loro siti e, dove esiste, alla loro pagina Wikipedia, e indicano come sostenitori solo i veri sostenitori.
- Periodi di attività su ogni case study e progetto, così che “quando ci ha lavorato Vuild?” abbia una risposta chiara.
Dire ai crawler cosa è cambiato
L’aggiornamento conta. La nostra sitemap ora data ogni pagina in base alla sua ultima vera modifica, presa dalla cronologia delle versioni, invece di timbrare tutto con la data di oggi. Il nostro file robots nomina i crawler di SI che accogliamo, così l’intenzione è inequivocabile.
E a ogni deploy il sito invia a IndexNow le pagine cambiate quel giorno. IndexNow è un protocollo aperto supportato da Bing e altri, che a sua volta alimenta diversi prodotti di ricerca di SI.
Far parlare altri agenti con il nostro
L’ultimo passo va oltre la leggibilità. Il nostro sito ha un concierge, l’assistente dietro il pulsante Chiedi a Vuild, e ora parla A2A, il protocollo aperto Agent2Agent. L’agente di un’altra azienda può trovarlo tramite la nostra agent card su /.well-known/agent-card.json, vedere in cosa può aiutare e mandargli un messaggio.
POST /api/a2a
Content-Type: application/json
{"jsonrpc": "2.0", "id": 1, "method": "message/send",
"params": {"message": {"role": "user", "parts": [{"kind": "text", "text": "What does Vuild do?"}]}}}Il concierge risponde dagli stessi contenuti del sito di llms-full.txt, e ricorda il filo di una conversazione. Ha le stesse protezioni della chat del sito: limiti di frequenza, controlli rigorosi sulle richieste e confini chiari su cosa farà e cosa no.
Perché conta per i nostri clienti
È il lavoro che ora facciamo per i clienti, quindi farlo prima per noi stessi era la mossa ovvia. Le domande sono le stesse per qualsiasi azienda: un assistente riesce a trovarti, a capire cosa fai e a descriverti con precisione? Altri agenti possono fare affari con il tuo?
Se vuoi lo stesso per il tuo prodotto, inizia un progetto, o chiedi semplicemente al concierge in qualsiasi pagina. Sa dove indirizzarti.