Definición answer-firstActualizado 15 ago 2026

OpenAPI · AR-CAPA-08

Descripción machine-readable de APIs HTTP (paths, parámetros, esquemas, errores) que los agentes usan para function calling. MUST si expones API.

Contexto

OpenAPI 3.1. Alternativas válidas: AsyncAPI. Sin esto, el agente no puede llamar tu API de forma fiable.

Por qué importa para agent readiness

AR-CAPA-08 MUST si expones API (OpenAPI 3.1 o AsyncAPI). Sin esto el agente no puede hacer function calling fiable: no conoce paths, parámetros ni esquemas de error.

Qué hacer hoy

  • Audita robots.txt y añade Content-Signal si entrenar no te interesa.
  • Publica una definición answer-first por concepto clave (esta plantilla).
  • Valida con POST a isitagentready.com/api/scan sobre belmon.tech.

¿Dudas con este término? miguel@belmon.tech · Volver al glosario