Herramientas para agentes
Entrega a un agente el flujo y el contrato exacto que debe implementar.
Usa Markdown para explicar la tarea y OpenAPI para definir la llamada. Ninguno de los dos reemplaza la validación del servidor.
Fuentes disponibles
llms.txtenumera las APIs y guías públicas.llms-full.txtreúne la documentación pública en un archivo.- El menú de una página permite copiar o abrir su Markdown.
Contratos OpenAPI
Entrega solo el contrato de la API que usará el agente. Admin, Storefront y Auth no comparten todas las reglas de autenticación, contexto, paginación o error.
Qué debe tomar de cada fuente
| Fuente | Úsala para |
|---|---|
| Guía Markdown | Orden del flujo, decisiones y restricciones operativas. |
| OpenAPI | Método, ruta, parámetros, cuerpo, esquemas, respuestas y seguridad publicada. |
| Página del endpoint | Presentación legible del contrato de esa operación. |
Si un permiso, ejemplo o regla no aparece en esas fuentes, el agente debe marcarlo como desconocido. No debe inventarlo a partir del nombre del endpoint.
Instrucción recomendada
Implementa esta operación con la guía y el OpenAPI adjuntos.
Conserva método, ruta, operationId, parámetros y esquemas.
No inventes campos, permisos, respuestas ni ejemplos.
Distingue Admin, Storefront y Auth.
Antes de reintentar, comprueba la idempotencia de la operación.Flujo de trabajo
- Elige una API y una operación concreta.
- Adjunta la guía del flujo y el fragmento OpenAPI de esa operación.
- Pide un cliente tipado que use solo los campos del contrato.
- Ejecuta contra credenciales y datos de desarrollo.
- Compara la petición y la respuesta reales con el contrato publicado.
No deduzcas autorización
Que una operación aparezca en OpenAPI no concede acceso. Usa la seguridad publicada y la respuesta del servidor; no supongas nombres de permisos que el contrato no declara.
No compartas client_secret, access tokens, datos personales ni respuestas de
producción en el prompt. Sustituye los valores antes de adjuntar ejemplos.