Google ARD · Agentic Resource Discovery
Google Agentic Resource Discovery (ARD).
SuggestAPI implementa la especificación Agentic Resource Discovery de Google, publicando un catálogo de capacidades en vivo para que los agentes encuentren búsqueda de comercio, comparación y transferencia al checkout sin herramientas codificadas.
Capa de búsqueda para agentes
Publica una vez en /.well-known/ai-catalog.json. Los agentes y registros descubren las capacidades de comercio de SuggestAPI mediante un estándar abierto.
Descubrimiento, no ejecución
Google anunció Agentic Resource Discovery (ARD) como una especificación abierta para publicar, descubrir y verificar capacidades de IA en la web. Ayuda a un agente a responder qué existe y dónde encontrarlo; después, la API o el protocolo seleccionado gestiona la autenticación y la interacción en tiempo de ejecución. Lee el anuncio del Google Developers Blog o la especificación ARD (borrador v0.9).
Sin ARD
- Los desarrolladores codifican descripciones de herramientas en cada agente
- Los agentes se limitan a herramientas configuradas de antemano
- Cada plataforma inventa sus propios metadatos de descubrimiento
Con ARD
- Los proveedores publican capacidades en un formato de catálogo común
- Los registros pueden indexar capacidades para descubrimiento dinámico
- Los catálogos pueden incluir identidad anclada al dominio y metadatos de confianza
Qué publica SuggestAPI
Knowledge Gateway aloja un catálogo compatible con ARD con identidad de host anclada al dominio y entradas estructuradas para cada superficie de recursos.
Catálogo en vivo
https://agent.suggestapi.com/.well-known/ai-catalog.jsonInspecciona el ai-catalog.json legible por máquinas o lee la especificación ARD (borrador v0.9).
Registro de agentes de SuggestAPI
Descubre capacidades de búsqueda de comercio, comparación, recomendación y transferencia.
Superficie de búsqueda por tenant
Búsqueda de productos y contenido limitada al tenant mediante una superficie de API documentada.
Orquestación de búsqueda para agentes
Recuperación, comparación, recomendación y respuestas con conocimiento de políticas de nivel superior.
Transferencia de carrito para agentes
Un plan de transferencia seguro con recursos de producto, carrito y checkout controlados por el comercio.
Transferencia guiada al checkout
Orientación que lleva un producto seleccionado al checkout existente del comercio.
Cómo descubren los agentes SuggestAPI
Una capa de búsqueda para agentes que conecta la intención con capacidades de catálogo en vivo, sin acoplar el agente a un motor de búsqueda concreto.
Paso 1
Publicar
SuggestAPI expone su catálogo ARD desde la ruta well-known estándar en Knowledge Gateway.
Paso 2
Descubrir
Un agente obtiene el catálogo directamente o encuentra entradas a través de un registro ARD que rastrea catálogos publicados.
Paso 3
Seleccionar
Las descripciones, las etiquetas de capacidad y las consultas representativas ayudan a relacionar la intención del usuario con la superficie correcta.
Paso 4
Conectar
El agente usa la API o el protocolo nativo del recurso. SuggestAPI enruta a la fuente de búsqueda del tenant y devuelve resultados estructurados.
El control del comercio sigue intacto
Hacer que una capacidad sea descubrible no entrega el checkout a un agente. Los recursos de carrito y checkout de SuggestAPI son superficies de transferencia: preparan enlaces, no realizan pedidos ni procesan pagos.
Mantén tu stack de búsqueda
Algolia, Typesense, Elasticsearch, Meilisearch o un índice de SuggestAPI siguen siendo la fuente de la verdad. Consulta Trae tu propio buscador.
Datos de producto estructurados
Los asistentes buscan, comparan y recomiendan a partir de información de catálogo en vivo, no de scraping de HTML frágil ni de conocimiento obsoleto del modelo.
El checkout sigue siendo tuyo
El descubrimiento de productos se vuelve compatible con agentes mientras tu tienda y tu plataforma de comercio controlan el carrito, el checkout y el pago.
Referencia para agentes
Solicitud, respuesta, autenticación y llamadas a herramientas
ARD solo sirve para descubrir. Obtén el catálogo sin credenciales, elige un recurso y llama a la API nativa de ese recurso. La autenticación y la ejecución nunca viven en ai-catalog.json. El catálogo en vivo es la fuente de la verdad; los ejemplos siguientes muestran el contrato que los agentes deben esperar.
1. Descubre (sin autenticación)
Haz GET del catálogo well-known. No envíes claves de API en esta solicitud.
GET https://agent.suggestapi.com/.well-known/ai-catalog.json HTTP/1.1
Accept: application/jsonCarga también https://agent.suggestapi.com/openapi.yaml y descubrimiento MCP cuando el catálogo apunte a esos artefactos.
Forma del catálogo
Trata los nombres de campo como el borrador ARD 0.9. Lee resources[] para id, type, url y capabilities.
{
"ardVersion": "0.9",
"host": {
"id": "agent.suggestapi.com",
"url": "https://agent.suggestapi.com"
},
"resources": [
{
"id": "suggestapi.agent.search",
"type": "http",
"name": "Tenant catalog search",
"url": "https://agent.suggestapi.com/v1/agent/search",
"capabilities": ["search", "commerce.discovery"]
}
]
}2. Autentícate
- Obtención del catálogo: anónima.
- Búsqueda, comparación y recomendación en Knowledge Gateway: Authorization: Bearer $SUGGESTAPI_KEY.
- API de aceleración de búsqueda (autocompletado / consulta): x-api-key o Authorization: Bearer.
- Nunca envíes credenciales de Algolia, Typesense o Elastic. SuggestAPI inyecta las claves del backend en el servidor.
- Los recursos de carrito y checkout son URLs de transferencia. No aceptan pedidos ni pagos a través de SuggestAPI.
3. Ejemplo de llamada a herramienta
Después de seleccionar el recurso de búsqueda del catálogo, haz POST de una consulta limitada al tenant.
POST https://agent.suggestapi.com/v1/agent/search HTTP/1.1
Authorization: Bearer $SUGGESTAPI_KEY
Content-Type: application/json
{
"tenant": "demo.suggestapi.com",
"query": "waterproof hiking boots",
"limit": 8
}Ejemplo de respuesta
Objetos de producto normalizados más una transferencia de checkout controlada por el comercio. No inventes SKU; usa datos del tenant en vivo.
{
"query": "waterproof hiking boots",
"results": [
{
"id": "sku_1842",
"title": "TrailGrip Waterproof Hiking Boot",
"url": "https://demo.suggestapi.com/products/trailgrip",
"price": { "amount": 18900, "currency": "USD" },
"availability": "in_stock"
}
],
"handoff": {
"checkout": "https://demo.suggestapi.com/cart"
}
}Autocompletado de tienda
El typeahead humano y las pruebas de prefijo de los agentes usan la API de aceleración, no el catálogo ARD. Consulta Trae tu propio buscador para adaptadores y campos de respuesta.
GET https://api.suggestapi.com/v1/autocomplete?index=products&query=boot HTTP/1.1
x-api-key: $SUGGESTAPI_KEY
Accept: application/jsonPreguntas frecuentes sobre ARD
Respuestas breves para equipos que evalúan estándares de descubrimiento de agentes.
¿ARD es un protocolo de tiempo de ejecución?
No. ARD es una especificación de descubrimiento. No sustituye a OpenAPI, MCP, A2A ni a otro runtime. La autenticación y la ejecución siguen en el recurso seleccionado.
¿Los comercios publican su propio ai-catalog.json?
No necesariamente. SuggestAPI publica las capacidades de la plataforma desde Knowledge Gateway. Los comercios pueden publicar opcionalmente un catálogo propio en su dominio.
¿La especificación está finalizada?
Todavía no. La especificación ARD actual es la versión 0.9 y está etiquetada como borrador. Es previsible que el esquema evolucione a medida que madure el proyecto abierto.
¿Dónde puedo leer más?
Consulta la publicación del anuncio en el blog, el anuncio de ARD de Google y la descripción general de cómo funciona.
Cómo funciona
Comercio agéntico sin mover la búsqueda
Conecta tu catálogo y mantén el motor de búsqueda que ya utilizas.
Trae tu propio buscador
Adaptadores, esquema y límites de confianza
Referencia de ingeniería para enrutar Algolia, Typesense, Elastic o Meilisearch.
Blog
Google ARD Reddit
Respuestas breves sobre qué es Agentic Resource Discovery y qué no es.
¿Listo para añadir comercio agéntico a tu tienda?
Crea una cuenta para conectar tu catálogo. SuggestAPI se convierte en la capa de descubrimiento para agentes de IA, con una capa de búsqueda para agentes que publica capacidades compatibles con ARD mientras tu checkout permanece en tus rieles.