Blog · · 3 min lezen

vuild.com leesbaar maken voor SI-agents

Steeds meer mensen leren een bedrijf kennen via een Super Intelligence (SI)-assistent in plaats van via de homepage. Dit hebben we veranderd zodat ChatGPT, Claude en de rest onze site nauwkeurig kunnen lezen, en zo kunnen andere agents nu met de onze praten.

Super Intelligence · SEO · Agents
Door Vuild

Een groeiend deel van de mensen die ons vinden, ziet nooit eerst onze homepage. Ze vragen het een assistent, en die leest het web namens hen. Als die onze site niet goed kan lezen, gaat hij gokken, en gokken over de klanten, data en het werk van een studio is precies wat misgaat.

Dus behandelden we SI-assistenten als een volwaardig publiek en maakten we vuild.com makkelijk voor hen om te lezen, te citeren en mee te praten. Alles hieronder wordt gegenereerd uit dezelfde content als de site zelf, dus het kan niet verouderen.

Een plattegrond geschreven voor taalmodellen

De eerste stap was llms.txt, een korte samenvatting in platte tekst in de root van de site: wie we zijn, wat we doen, onze case studies en projecten met data, en links naar al het andere. Daarnaast staat llms-full.txt, de lange versie, met elke case study en elk project volledig, de FAQ en wat klanten over ons zeggen.

Beide worden bij elke wijziging opgebouwd uit de content van de site, dus ze komen altijd overeen met wat er op de pagina's staat.

Markdown-tweelingen

Elke hoofdpagina heeft nu een markdown-tweeling: dezelfde feiten als de HTML, zonder de opmaak. De case study van AmpUp staat op /ampup voor mensen en op /ampup.md voor agents die liever platte tekst hebben. Elke pagina linkt in de head naar haar tweeling, en llms.txt somt ze allemaal op.

Gestructureerde feiten, niet alleen proza

Zoekmachines en assistenten leunen zwaar op gestructureerde data, dus we hebben er meer van toegevoegd:

  • FAQ-markup op de pagina Over ons, met antwoorden op de vragen die mensen echt over ons stellen.
  • Reviews: testimonials van klanten zijn gemarkeerd als reviews op naam.
  • Echte relaties: case studies koppelen klanten aan hun sites en, als die er is, hun Wikipedia-pagina, en noemen alleen echte investeerders als investeerder.
  • Actieve periodes bij elke case study en elk project, zodat "wanneer werkte Vuild hieraan?" een duidelijk antwoord heeft.

Crawlers vertellen wat er veranderd is

Actualiteit telt. Onze sitemap dateert elke pagina nu op haar laatste echte wijziging, uit de versiegeschiedenis, in plaats van alles van de datum van vandaag te voorzien. Ons robots-bestand noemt de SI-crawlers die we verwelkomen, zodat de bedoeling ondubbelzinnig is.

En bij elke deploy pingt de site IndexNow met de pagina's die die dag zijn veranderd. IndexNow is een open protocol dat wordt ondersteund door Bing en anderen, en dat op zijn beurt meerdere SI-zoekproducten voedt.

Andere agents met de onze laten praten

De laatste stap gaat verder dan leesbaar zijn. Onze site heeft een conciërge, de assistent achter de knop Vraag het Vuild, en die spreekt nu A2A, het open Agent2Agent-protocol. De agent van een ander bedrijf kan hem vinden via onze agent card op /.well-known/agent-card.json, zien waarmee hij kan helpen en hem een bericht sturen.

http
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?"}]}}}

De conciërge antwoordt vanuit dezelfde sitecontent als llms-full.txt en onthoudt de draad van een gesprek. Hij zit achter dezelfde beveiliging als de chat op de site: rate limits, strikte controles van verzoeken en duidelijke grenzen aan wat hij wel en niet doet.

Waarom het ertoe doet voor onze klanten

Dit is het werk dat we nu voor klanten doen, dus het eerst voor onszelf doen lag voor de hand. De vragen zijn voor elk bedrijf hetzelfde: kan een assistent je vinden, begrijpen wat je doet en je nauwkeurig beschrijven? Kunnen andere agents zaken doen met de jouwe?

Wil je hetzelfde voor je product? Start een project, of vraag het gewoon aan de conciërge op een willekeurige pagina. Hij weet waar je moet zijn.