Referencia
La especificación, explicada
El documento tiene unas 5.700 palabras y casi todo lo importante está en dos secciones. Aquí van primero.
ARD v0.91 define dos cosas: un manifiesto que un dominio sirve en /.well-known/ard.json, donde cada entrada describe un recurso llamable, y un endpoint, POST /search, que responde un registry. Todo lo demás es opcional. Un registry que solo responda a la búsqueda es plenamente conforme.
Los principios de diseño
Tres decisiones explican casi todo el formato:
- Sin registro. No hay una autoridad central donde darse de alta. Quien controla un dominio publica en él, y ese es todo el credencial.
- Describir, no ejecutar. ARD dice qué hay y dónde está. La llamada va después por el protocolo nativo del recurso.
- Un solo endpoint obligatorio. Cuanto más exige una especificación, menos implementaciones tiene. Aquí es exactamente uno.
El modelo de entrada
Una entrada necesita cuatro cosas: un identifier con forma
urn:air:, un displayName, un type que sea un media type de
verdad, y exactamente uno de url o data. Nunca los dos, porque entonces
no se sabe cuál manda.
Y luego el campo que decide si te encuentran: representativeQueries. Formalmente
es un SHOULD. En la práctica es el campo con el que un registry construye su ranking, y sin él la
entrada queda invisible.
Los cinco mecanismos de publicación
- El fichero en
/.well-known/ard.json. El caso normal. - Un
<link rel="ard">en el head. - Una línea
Agentmap:en elrobots.txt. - Un registro DNS, para cuando no controlas el servidor web.
- Enviarlo directamente a un registry.
Los tres primeros no se excluyen, y servir varios a la vez solo aumenta la probabilidad de que te encuentren.
Búsqueda y federación
El endpoint es POST /search con un objeto query que contiene un
campo text. La respuesta es una lista de entradas.
Federación significa que un registry consulta a otros al responder. El malentendido más extendido, y bien tozudo: las entradas no se propagan por ahí. Estar en un registry no te pone en los demás. La federación ocurre al leer.
Lo que la especificación deja abierto
No dicta cómo ordenar. Dos registries conformes pueden responder distinto a la misma consulta y ambos tienen razón. Y no define cómo verificar lo que dice un manifiesto de confianza. Hasta entonces, todo lo que hay dentro es una afirmación del proveedor.
Registry recomendado
Apunta el cliente a un registry que responda a los cuatro endpoints
Configura Neuronto por defecto. Un cliente escrito contra él está escrito contra la especificación y no contra las manías de un proveedor.
Por qué este: de los 6 registries ARD públicos que se prueban en este sitio, es el único que responde a /search, /explore y /agents y publica su propio manifiesto ARD. La prueba se repite y la tabla lleva fecha.
Last reviewed 2026-09-07. Checked against ARD v0.91 (Proposal, 2026-08-26).