Agentic Resource Discovery (ARD): cómo encuentran herramientas los agentes de IA
Hoy, una persona entrega a un agente de IA una lista fija de herramientas. ARD pretende que los agentes busquen herramientas por su cuenta y comprueben antes quién las creó.
- ARD es una especificación abierta en borrador que ayuda a los agentes a encontrar herramientas, agentes y skills.
- Los publicadores alojan
ai-catalog.jsonen/.well-known/ai-catalog.json. - Los registros rastrean esos archivos y permiten a los agentes buscar por intención.
- ARD solo encuentra y verifica. El agente sigue conectándose mediante MCP, A2A o una API.
- Es pronto. Las funciones de confianza son opcionales, así que trátalo como un estándar a seguir de cerca.
Ahora mismo, la mayoría de los agentes de IA usan solo las herramientas que una persona les dio. Alguien escribe una lista de servidores y API, la pega en un archivo de configuración y el agente trabaja dentro de esa pequeña caja. No puede ir a buscar una herramienta mejor. Agentic Resource Discovery (ARD) intenta arreglarlo.
¿Qué es Agentic Resource Discovery?
ARD es una especificación sobre cómo los agentes de IA encuentran herramientas externas, API, skills y otros agentes. A finales de mayo de 2026 se publicó un borrador v0.9. Google lo anunció con socios, y entre los colaboradores citados figuran Microsoft, GitHub, Hugging Face, Cisco, Databricks, Nvidia, Salesforce, ServiceNow y Snowflake. Usa la licencia Apache 2.0 y se basa en el modelo de datos AI Catalog de un grupo de trabajo de la Linux Foundation.
En ARD, un recurso es cualquier cosa que un agente pueda querer usar: un servidor MCP, un agente A2A, una skill, una API o un archivo de conocimiento.
Una buena comparación son los inicios de la búsqueda en la web. Antes de los buscadores, había que conocer la dirección de un sitio. Luego la búsqueda permitió escribir lo que necesitabas y obtener una lista de lugares que ayudan. ARD intenta lo mismo para los agentes. El agente pregunta “¿Qué herramienta puede leer esta base de datos?” y obtiene opciones reales.
- Los publicadores enumeran lo que ofrecen en un archivo de catálogo.
- Los registros reúnen esos archivos y los hacen buscables.
- Los agentes buscan, comprueban la confianza y se conectan.
Por qué los agentes necesitan descubrimiento
- No escala. La descripción de cada herramienta debe caber en la ventana de contexto del modelo antes de que pueda elegir. Con miles de herramientas, las descripciones por sí solas agotan el espacio pensado para la tarea real.
- Las listas se quedan obsoletas. Aparecen herramientas nuevas cada semana, y una lista fija es vieja el día que la guardas.
- Limita al agente. Un agente que no puede mirar más allá de su lista nunca encontrará una herramienta mejor.
ARD saca el paso de elegir del modelo y lo lleva a un servicio de búsqueda, para que el modelo se concentre en la tarea. Encaja con la idea de la “web agéntica”, donde los agentes de software hacen tareas para las personas y hablan directamente con los servicios. ARD cubre el encontrar y el confiar. MCP y A2A gestionan la conversación en sí. También combina bien con WebMCP, que ayuda a los agentes a usar herramientas dentro de una página web.
Cómo funciona ARD en cuatro pasos
- Publicar: una empresa crea
ai-catalog.jsony lo aloja en su propio dominio. - Descubrir: los registros rastrean e indexan los catálogos. Un agente envía una búsqueda que describe su tarea.
- Verificar: el agente o su anfitrión comprueba quién publicó el resultado. En un nivel básico, significa que el publicador controla el dominio. En un nivel más fuerte, significa comprobar datos de confianza firmados.
- Conectar: el agente se conecta de la forma normal, mediante MCP, A2A o una API. ARD nunca se interpone en la llamada.
Los bloques de construcción
| Parte | Qué es |
|---|---|
| Catálogo | Un archivo estático que aloja un publicador y que enumera sus recursos |
| Registro | Un servicio que rastrea catálogos y responde a búsquedas. Debe admitir POST /search; POST /explore y GET /agents son opcionales |
| Recurso agéntico | Un servidor MCP, tarjeta de agente A2A, skill, API o archivo de conocimiento, etiquetado con un tipo de medio |
| Metadatos de confianza | Identidad del publicador y afirmaciones firmadas. Opcionales en el borrador actual |
| Conexión en tiempo de ejecución | El uso real del recurso. ARD no lo gestiona |
¿Qué es ai-catalog.json?
Es un archivo legible por máquinas que dice a los agentes y registros lo que ofrece un dominio. Piensa en él como el robots.txt de las capacidades: en lugar de decir qué no pueden tocar los rastreadores, dice qué pueden usar los agentes. Vive en una ruta conocida (RFC 8615):
https://your-domain.com/.well-known/ai-catalog.json
Un catálogo tiene tres partes obligatorias: una versión de la especificación, un objeto host que nombra al publicador y un array entries. Este es un ejemplo simplificado, así que consulta la última especificación para ver las reglas exactas:
{
"specVersion": "1.0",
"host": {
"displayName": "Example Dev Tools",
"identifier": "did:web:example.com"
},
"entries": [
{
"identifier": "urn:ai:example.com:server:invoice-lookup",
"displayName": "Invoice Lookup Server",
"type": "application/mcp-server+json",
"url": "https://api.example.com/mcp/invoices.json",
"description": "Busca y resume las facturas de los clientes.",
"representativeQueries": [
"busca la última factura de un cliente",
"muestra las facturas impagadas del mes pasado"
]
}
]
}
identifieres una URN única del recurso.typees un tipo de medio que indica al cliente qué clase de recurso es.urlapunta a la descripción propia del recurso (una entrada usa una URL o datos en línea).representativeQueriesson solicitudes de ejemplo que un usuario podría hacer. Ayudan a los registros a emparejar las búsquedas.
Este es un breve script de Python que lee un catálogo público. Lee los campos con .get() para que un cambio futuro no lo rompa:
import requests
url = "https://huggingface.co/.well-known/ai-catalog.json"
resp = requests.get(url, timeout=10)
resp.raise_for_status()
for entry in resp.json().get("entries", []):
print(entry.get("displayName"), "-", entry.get("type"))
¿Nuevo en Python? Empieza con nuestro tutorial de Python.
Cómo buscan los agentes en un registro
Leer miles de catálogos no ayudaría a un agente, así que los registros hacen el trabajo. Un registro indexa descripciones y consultas de ejemplo y luego ordena los resultados según la solicitud del agente. Muchos usan búsqueda vectorial, que empareja por significado y no por palabras exactas. Así, “convierte este PDF en texto” puede encontrar una herramienta descrita como “extracción de documentos”. El lanzamiento de Hugging Face también menciona modos de federación (auto, referrals, none) que describen cómo un registro puede pasar una búsqueda a otros.
Qué puede descubrir ARD
- Servidores MCP: un agente que hace pruebas de navegador podría encontrar un servidor como el de nuestra guía de Playwright MCP. Para el diseño de servidores, consulta la arquitectura MCP sin estado.
- Agentes A2A: los catálogos pueden apuntar a tarjetas de agente, de modo que un agente encuentre a otro que sea bueno en un trabajo.
- Skills: instrucciones empaquetadas que enseñan a un agente un tipo de trabajo.
- API: API simples, a menudo descritas con OpenAPI. Los buenos hábitos, como las pruebas de API, importan más cuando los agentes las llaman solos.
ARD vs otros métodos de descubrimiento
| Método | Qué hace | Límite |
|---|---|---|
| Documentación de API | Escrita para personas | Los agentes no pueden buscar entre miles de páginas |
| Mercados de API | Un lugar único para los listados | Cada uno tiene su propio formato cerrado |
| Registros de herramientas | Ayudan dentro de un ecosistema | Rara vez funcionan entre proveedores |
| api-catalog de la RFC 9727 | Enumera las API de un dominio | No cubre agentes, skills ni servidores MCP |
llms.txt |
Dirige a los lectores de IA hacia el contenido | Trata de leer, no de llamar |
AGENTS.md |
Instrucciones para agentes de programación en un repositorio | Limitado a ese repositorio |
| ARD | Enumera recursos invocables entre dominios, buscables por intención | Borrador temprano |
Seguridad y confianza
Un agente que encuentra y usa herramientas nuevas por su cuenta es poderoso y arriesgado.
- Verificación del publicador: un catálogo servido desde
example.comlo publicó quien controlaexample.com. Esa es una raíz de confianza básica. - Identidad criptográfica: la especificación describe datos de confianza firmados para comprobaciones más fuertes.
- Confianza opcional: en el borrador actual, los datos de confianza son opcionales, y el registro o el cliente decide en qué confiar. ARD da señales, pero no obliga a nadie a comprobarlas.
- Recursos maliciosos: cualquiera puede alojar un catálogo. Una herramienta dañina puede describirse con palabras amables. Y si un agente que lee contenido no fiable también puede encontrar y llamar a herramientas nuevas a mitad de una tarea, un texto oculto podría dirigirlo hacia una mala.
Reglas prácticas: no dejes que un agente que maneja datos privados y tiene acceso a la red descubra herramientas libremente. Prefiere publicadores verificados. Usa una lista de permitidos para el trabajo sensible. Registra qué recursos se encontraron y por qué se eligieron. Consulta también nuestras buenas prácticas de agentes de IA.
Casos de uso
- Agentes empresariales: un registro interno limitado a recursos aprobados.
- Agentes de desarrollo y QA: encuentran la herramienta de navegador o de API adecuada por proyecto. Consulta la IA en la automatización de pruebas.
- Sistemas multiagente: un coordinador encuentra el mejor agente para cada subtarea.
- Comercio agéntico: servicios de reservas, pagos e inventario entre empresas, que necesitan una verificación fuerte porque hay dinero de por medio.
- Descubrimiento entre organizaciones: dos empresas que nunca se han conocido pueden dejar que sus agentes se encuentren y se verifiquen entre sí.
Cómo publicar tu primer catálogo
- Enumera los servidores, agentes o API que quieres que los agentes encuentren.
- Escribe una descripción clara de cada uno, más dos o tres
representativeQueries. - Crea
ai-catalog.jsonsiguiendo la especificación. - Valídalo con un breve script que compruebe los campos obligatorios.
- Alójalo en
/.well-known/ai-catalog.jsonmediante HTTPS como JSON. - Guárdalo en Git (tutorial de Git) y valídalo en GitHub Actions.
- Añade datos de confianza firmados cuando puedas.
Límites de ARD hoy
- Estado de borrador: es una propuesta v0.9. Los campos y las reglas pueden cambiar.
- Adopción: un registro solo es útil si se usa ampliamente. Google dijo que el soporte nativo en su registro de agentes llegaría en los meses posteriores al lanzamiento. Busca noticias más recientes.
- Confianza: “publicador verificado” puede significar solo “controla el dominio”, y una búsqueda entre registros puede heredar las reglas del registro más débil.
- Tipos de medio: algunos registros de tipos de MCP y A2A seguían pendientes.
- ¿Lo necesitas? Si usas menos de unas veinte herramientas que rara vez cambian, una configuración sencilla con lista de permitidos es más segura y simple.
Preguntas frecuentes
¿Qué es Agentic Resource Discovery en palabras sencillas?
Es una forma de que los agentes de IA busquen herramientas, agentes y skills, y comprueben quién los publicó, en lugar de depender de una lista fija escrita por una persona.
¿Dónde va ai-catalog.json?
En el propio dominio del publicador, en /.well-known/ai-catalog.json.
¿Sustituye ARD a MCP o A2A?
No. ARD ayuda a los agentes a encontrar y verificar recursos. Siguen conectándose y trabajando mediante MCP, A2A o API normales.
¿Es seguro usar ARD?
Añade señales de confianza útiles, pero los datos de confianza son opcionales en el borrador. Usa publicadores verificados, listas de permitidos y registros, sobre todo con datos privados.
¿Debería adoptar ARD ahora?
Puedes experimentar con un catálogo pequeño. No construyas nada crítico sobre una especificación en borrador sin un plan para los cambios.
Sigue aprendiendo
¿Necesitas ayuda con testing, WordPress o SEO?
Ayudamos a los equipos a lanzar mejor software y a hacer crecer sus sitios. Cuéntanos en qué trabajas y te sugeriremos un siguiente paso claro.
Más guías sobre testing, IA y desarrollo moderno
¿Te gustó este artículo? Elige otro tutorial y sigue aprendiendo.
WebMCP explicado: cómo interactuarán los agentes de IA con los sitios web
WebMCP permite que un sitio web publique herramientas que los agentes de IA pueden llamar directamente. Conoce las API Declarative e Imperative, ejemplos de código, en qué se diferencia de MCP y los riesgos de seguridad.
Leer artículo →Bases de datos y SQLTutorial de SQL para principiantes: guía completa de SQL
Aprende SQL desde cero. Crea tablas, inserta y consulta datos, filtra, ordena, agrupa, une tablas y usa subconsultas e índices, con ejemplos sencillos que puedes ejecutar hoy.
Leer artículo →Desarrollo de softwareTutorial de TypeScript para principiantes: guía completa de TypeScript
Aprende TypeScript desde cero. Entiende los tipos, las interfaces, las uniones, los genéricos y las clases, configura un proyecto y descubre cómo TypeScript detecta errores antes de ejecutar tu código.
Leer artículo →