---
title: "agents.json explicado: un manifiesto propio para herramientas web"
description: "Qué puede hacer un manifiesto propio agents.json, qué integración necesita y cómo se diferencia de WebMCP y A2A. Con ejemplo de restaurante."
author: "Matthias Meyer"
published: 2026-02-15
updated: 2026-09-30
updates:
  - date: 2026-09-30
    note: "Definido agents.json como manifiesto propio y corregidos los límites de ChatGPT, WebMCP, A2A y permisos."
language: es
tags: ["agents-json", "webmcp", "api", "ki-agenten", "discovery", "robots-txt"]
canonical: "https://studiomeyer.io/es/blog/agents-json-explained"
markdown_versions: ["https://studiomeyer.io/de/blog/agents-json-explained.md", "https://studiomeyer.io/en/blog/agents-json-explained.md", "https://studiomeyer.io/es/blog/agents-json-explained.md"]
publisher: "StudioMeyer, https://studiomeyer.io (llms.txt: https://studiomeyer.io/llms.txt)"
---

# agents.json explicado: un manifiesto propio para herramientas web

Una descripción legible por máquinas puede indicar a un agente qué interfaces ofrece una web. Una `agents.json` es una opción. El archivo por sí solo no implementa la interfaz ni hace que ChatGPT o Claude descubran automáticamente el sitio.

Existen distintas propuestas comunitarias e implementaciones propias con el nombre agents.json. No hay un estándar universal que obligue a todos los agentes a interpretar el formato siguiente. Aquí mostramos un **formato propio y simplificado de manifiesto** que una web puede publicar en `/.well-known/agents.json`.

## Qué describe el archivo

El manifiesto puede reunir nombre, dirección y funciones públicas documentadas. Cada función apunta a un endpoint implementado. Un restaurante ficticio podría utilizar esto:

```json
{
  "schema_version": "1.0",
  "name": "Example Restaurant",
  "url": "https://restaurant.example",
  "tools": [
    {
      "name": "get_menu",
      "description": "Retrieve the current menu",
      "endpoint": "/api/menu",
      "method": "GET",
      "parameters": {}
    },
    {
      "name": "request_reservation",
      "description": "Submit a reservation request; confirmation is pending",
      "endpoint": "/api/reservation-requests",
      "method": "POST",
      "parameters": {
        "date": { "type": "string" },
        "guests": { "type": "integer", "minimum": 1 }
      }
    }
  ]
}
```

`schema_version` indica aquí la versión de ese formato propio. No es un manifiesto WebMCP ni se convierte automáticamente en servidor MCP. La dirección `.example` y los endpoints son marcadores.

Lo esencial es el efecto: `request_reservation` envía una solicitud y no promete una reserva confirmada. El servidor debe gestionar los datos que falten, permisos y errores.

## Cómo podría utilizarlo un agente

1. El agente o la integración conoce la dirección del manifiesto.
2. Lee las funciones y elige la que corresponde a la tarea.
3. Consulta el menú mediante el endpoint GET indicado.
4. Antes de solicitar una reserva, comprueba los datos y la autorización del usuario.
5. Comunica el resultado real: solicitada, confirmada o rechazada.

Sin una integración compatible, quizá nadie consulte el archivo. Publicarlo no demuestra nuevos visitantes ni acciones automáticas.

## agents.json, Agent Card y WebMCP

| Descripción | Función |
|---|---|
| agents.json propia | Describir funciones HTTP con un formato acordado |
| Agent Card de A2A | Anunciar un agente y sus capacidades ejecutables |
| WebMCP | Registrar herramientas JavaScript en el documento abierto |

A2A 1.0 indica dirección, binding y versión del protocolo en `supportedInterfaces`. Este fragmento está recortado y no es una tarjeta completa válida:

```json
{
  "name": "Example Restaurant Agent",
  "supportedInterfaces": [
    {
      "url": "https://restaurant.example/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "skills": [
    {
      "id": "reservation-request",
      "name": "Request a reservation",
      "description": "Accepts a request; the restaurant confirms separately",
      "tags": ["restaurant", "reservation"]
    }
  ]
}
```

La [guía de A2A](https://studiomeyer.io/es/blog/a2a-protocol-explained) muestra una tarjeta completa y el proceso. Una capacidad de reserva necesita un agente que responda realmente. WebMCP utiliza en cambio `document.modelContext`; validar una agents.json propia no demuestra conformidad con WebMCP.

## Publicar y proteger

Sirve JSON en la dirección documentada. Mantén nombres, parámetros y descripciones alineados con los endpoints reales. Prueba cada función antes de anunciarla.

Un archivo público no necesita siempre `Access-Control-Allow-Origin: *`. CORS afecta a peticiones del navegador, no a los agentes normales que llaman desde servidores. Permite acceso del navegador solo cuando sea necesario. Los endpoints de lectura también pueden exigir autenticación si entregan datos de clientes.

El manifiesto no controla el acceso. La autenticación, permisos, límites de llamadas y comprobaciones de escritura pertenecen al servidor. Las descripciones y resultados pueden contener instrucciones maliciosas que el agente debe tratar como contenido no confiable.

## Complementar la web

`robots.txt` controla el rastreo y no impide de forma fiable la indexación. Los sitemaps ayudan a encontrar URL. Un manifiesto agents.json describe interacciones. Son funciones complementarias, pero no forman un estándar conjunto obligatorio.

Una web informativa sencilla quizá obtenga poco valor. Si una aplicación ofrece API útiles, prueba un proceso concreto con un agente. El archivo inicia la documentación; no garantiza tráfico de IA.

Fuentes: [A2A 1.0](https://a2a-protocol.org/v1.0.0/specification/), [WebMCP](https://webmachinelearning.github.io/webmcp/), [Google sobre robots.txt](https://developers.google.com/search/docs/crawling-indexing/robots/intro).

## Seguir leyendo, WebMCP y protocolos de agentes

- [Protocolo A2A: qué es y cómo los agentes de IA hablan con tu web](https://studiomeyer.io/es/blog/a2a-protocol-explained.md)
- [WebMCP en la Realidad: Dónde Está el Spec Realmente](https://studiomeyer.io/es/blog/webmcp-reality-check-may-2026.md)
- [WebMCP: El nuevo protocolo web para agentes de IA](https://studiomeyer.io/es/blog/webmcp-w3c-standard.md)