OpenAPI para agentes de IA
Un documento OpenAPI describe una API HTTP de forma legible por máquina: sus endpoints, los parámetros de cada uno, la estructura de cada respuesta y cómo autenticarse. Un agente puede leerlo para aprender a llamar a una API que nunca ha visto.
- Servicios listados con descripción OpenAPI
- 23
- Sitios que sirven un ai-plugin.json real
- 75 de 1504
De una descripción de API a herramientas
Los frameworks de agentes y varias plataformas de asistentes pueden convertir las operaciones de un documento OpenAPI en herramientas: el identificador de la operación pasa a ser el nombre de la herramienta, su resumen y su descripción indican al modelo cuándo usarla, y su esquema de parámetros se convierte en la entrada de la herramienta. El modelo rellena entonces los parámetros y la plataforma hace la solicitud HTTP.
El manifiesto de plugin
El manifiesto /.well-known/ai-plugin.json se introdujo con el sistema de plugins de ChatGPT en 2023: daba el nombre del servicio, lo describía para el modelo y apuntaba a un documento OpenAPI. Ese sistema de plugins se ha sustituido desde entonces, pero algunos sitios siguen sirviendo el archivo, que todavía indica dónde está la descripción de su API.
OpenAPI y MCP
OpenAPI describe cualquier API HTTP, sea quien sea quien la llame. MCP es un protocolo pensado para asistentes: el servidor enumera sus herramientas cuando el cliente se conecta, y el cliente las llama. Muchos servidores MCP son una capa fina sobre una API que también tiene una descripción OpenAPI, y existen herramientas que generan una a partir de la otra.
Qué hace que una descripción sea apta para agentes
Identificadores y descripciones de operaciones claros, escritos para alguien que nunca ha visto la API; ejemplos; enumeraciones para los valores permitidos; errores documentados; el esquema de autenticación declarado, no solo explicado en prosa; y operaciones pequeñas que hagan una sola cosa cada una. Una URL publicada y estable para el documento permite que agentes y directorios lo encuentren.
Servicios con descripción OpenAPI · Servicios con API pública · Explorar el directorio →
Más: ¿Qué es un servidor MCP? · ¿Qué es llms.txt? · Cómo encuentran y reservan viajes los asistentes de IA · Cómo se verifican las fichas · Transportes de MCP: stdio, Streamable HTTP y SSE · Remoto o local: qué tipo de servidor MCP usar · Cómo añadir un servidor MCP a un asistente de IA · ¿Qué es el MCP Registry oficial? · Qué contiene un archivo llms.txt · Cómo encuentran los asistentes de IA disponibilidad de viajes · Antes de conectar un servidor MCP: lista de comprobación