Blog · · 3 min de lectura

Cómo hicimos vuild.com legible para agentes de SI

Hoy más gente conoce una empresa a través de un asistente de Superinteligencia (SI) que por su página de inicio. Esto es lo que cambiamos para que ChatGPT, Claude y los demás lean nuestra web con precisión, y cómo otros agentes ya pueden hablar con el nuestro.

Superinteligencia · SEO · Agentes
Por Vuild

Una parte cada vez mayor de quienes nos encuentran nunca ve primero nuestra página de inicio. Preguntan a un asistente, y el asistente lee la web por ellos. Si no puede leer nuestra web con claridad, adivina, y lo que adivina sobre los clientes, las fechas y el trabajo de un estudio es justo el tipo de cosa que sale mal.

Así que tratamos a los asistentes de SI como un público de primera y pusimos fácil que lean vuild.com, la citen y hablen con ella. Todo lo que sigue se genera a partir del mismo contenido que la propia web, así que no puede quedarse desfasado.

Un mapa escrito para modelos de lenguaje

El primer paso fue llms.txt, un resumen breve en texto plano en la raíz de la web: quiénes somos, qué hacemos, nuestros casos de estudio y proyectos con fechas, y enlaces a todo lo demás. A su lado está llms-full.txt, la versión larga, con cada caso de estudio y proyecto completo, las preguntas frecuentes y lo que dicen de nosotros nuestros clientes.

Los dos se construyen a partir del contenido de la web en cada cambio, así que siempre coinciden con lo que hay en las páginas.

Gemelos en Markdown

Cada página principal tiene ahora un gemelo en Markdown: los mismos hechos que el HTML, sin la maquetación. El caso de estudio de AmpUp vive en /ampup para las personas y en /ampup.md para los agentes que prefieren texto plano. Cada página enlaza a su gemelo en su cabecera, y llms.txt los enumera todos.

Hechos estructurados, no solo prosa

Los buscadores y los asistentes se apoyan mucho en los datos estructurados, así que añadimos más:

  • Marcado de preguntas frecuentes en la página del estudio, que responde a lo que la gente pregunta de verdad sobre nosotros.
  • Reseñas: los testimonios de clientes están marcados como reseñas con nombre.
  • Relaciones reales: los casos de estudio enlazan a los clientes con sus webs y, cuando la hay, con su página de Wikipedia, y solo nombran como inversores a los inversores reales.
  • Periodos de actividad en cada caso de estudio y proyecto, para que "¿cuándo trabajó Vuild en esto?" tenga una respuesta clara.

Decirles a los rastreadores qué ha cambiado

La frescura importa. Nuestro mapa del sitio fecha ahora cada página por su último cambio real, tomado de su historial de versiones, en lugar de ponerle a todo la fecha de hoy. Nuestro archivo robots nombra a los rastreadores de SI que son bienvenidos, para que la intención sea inequívoca.

Y en cada despliegue, la web avisa a IndexNow de las páginas que han cambiado ese día. IndexNow es un protocolo abierto que admiten Bing y otros, y que a su vez alimenta varios productos de búsqueda con SI.

Dejar que otros agentes hablen con el nuestro

El último paso va más allá de ser legible. Nuestra web tiene un asistente, el que está detrás del botón Pregunta a Vuild, y ahora habla A2A, el protocolo abierto Agent2Agent. El agente de otra empresa puede encontrarlo a través de nuestra tarjeta de agente en /.well-known/agent-card.json, ver en qué puede ayudar y enviarle un mensaje.

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

El asistente responde a partir del mismo contenido de la web que llms-full.txt, y recuerda el hilo de una conversación. Tiene las mismas protecciones que el chat de la web: límites de uso, comprobaciones estrictas de las peticiones y límites claros sobre lo que hará y lo que no.

Por qué importa para nuestros clientes

Este es el trabajo que ahora hacemos para nuestros clientes, así que hacerlo primero para nosotros era lo obvio. Las preguntas son las mismas para cualquier negocio: ¿puede un asistente encontrarte, entender lo que haces y describirte con precisión? ¿Pueden otros agentes hacer negocios con el tuyo?

Si quieres lo mismo para tu producto, empieza un proyecto, o simplemente pregunta al asistente en cualquier página. Sabe adónde enviarte.