Uma parcela crescente das pessoas que nos encontram nunca vê primeiro a nossa página inicial. Elas perguntam a um assistente, e o assistente lê a web por elas. Se ele não consegue ler o nosso site com clareza, ele chuta, e chutes sobre os clientes, as datas e os trabalhos de um estúdio são exatamente o tipo de coisa que dá errado.
Por isso tratamos os assistentes de SI como um público de primeira classe e tornamos o vuild.com fácil de ler, citar e conversar. Tudo abaixo é gerado a partir do mesmo conteúdo do próprio site, então não tem como ficar desatualizado.
Um mapa escrito para modelos de linguagem
O primeiro passo foi o llms.txt, um resumo curto em texto simples na raiz do site: quem somos, o que fazemos, nossos estudos de caso e projetos com datas, e links para todo o resto. Ao lado dele fica o llms-full.txt, a versão longa, com cada estudo de caso e projeto completos, as perguntas frequentes e o que os clientes dizem sobre nós.
Os dois são gerados a partir do conteúdo do site a cada alteração, então sempre batem com o que está nas páginas.
Gêmeos em Markdown
Cada página principal agora tem um gêmeo em Markdown: os mesmos fatos do HTML, sem o layout. O estudo de caso da AmpUp fica em /ampup para pessoas e em /ampup.md para agentes que preferem texto simples. Cada página aponta para o seu gêmeo no cabeçalho, e o llms.txt lista todos.
Fatos estruturados, não só texto
Buscadores e assistentes dependem muito de dados estruturados, então adicionamos mais:
- Marcação de perguntas frequentes na página Sobre, respondendo às perguntas que as pessoas realmente fazem sobre nós.
- Avaliações: os depoimentos de clientes são marcados como avaliações com nome.
- Relações reais: os estudos de caso ligam os clientes aos seus sites e, quando existe, à sua página na Wikipedia, e só chamam de apoiadores quem realmente apoiou.
- Períodos de atividade em cada estudo de caso e projeto, para que "quando a Vuild trabalhou nisso?" tenha uma resposta clara.
Avisando os rastreadores sobre o que mudou
Atualidade importa. Nosso sitemap agora data cada página pela sua última alteração real, tirada do histórico de versões, em vez de carimbar tudo com a data de hoje. Nosso arquivo robots nomeia os rastreadores de SI que acolhemos, para que a intenção fique inequívoca.
E a cada deploy o site avisa o IndexNow sobre as páginas que mudaram naquele dia. O IndexNow é um protocolo aberto apoiado pelo Bing e outros, que por sua vez alimenta vários produtos de busca de SI.
Deixando outros agentes conversarem com o nosso
O último passo vai além de ser legível. Nosso site tem um concierge, o assistente por trás do botão Pergunte à Vuild, e agora ele fala A2A, o protocolo aberto Agent2Agent. O agente de outra empresa pode encontrá-lo pelo nosso agent card em /.well-known/agent-card.json, ver com o que ele pode ajudar e enviar uma mensagem.
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?"}]}}}O concierge responde a partir do mesmo conteúdo do site que o llms-full.txt e lembra o fio da conversa. Ele fica atrás das mesmas proteções do chat do site: limites de uso, verificações rigorosas das requisições e limites claros sobre o que ele faz ou não faz.
Por que isso importa para os nossos clientes
Este é o trabalho que agora fazemos para clientes, então fazer primeiro para nós mesmos era o óbvio. As perguntas são as mesmas para qualquer empresa: um assistente consegue encontrar você, entender o que você faz e descrevê-lo com precisão? Outros agentes conseguem fazer negócio com o seu?
Se você quiser o mesmo para o seu produto, inicie um projeto ou simplesmente pergunte ao concierge em qualquer página. Ele sabe para onde levar você.