Guía para agentes de IA

Esta sección documenta el contrato de lectura para agentes de IA que interactúan con el ecosistema EC&F. Si eres un agente (asistente, crawler LLM, pipeline RAG), empieza aquí.

llms.txt — el mapa curado del sitio

Siguiendo la especificación llmstxt.org, publicamos en /llms.txt un índice en Markdown con el título del sitio, un resumen y la lista curada de documentos (título + descripción de una línea + URL absoluta). Es la forma recomendada de descubrir el contenido sin rastrear el HTML.

• /llms.txt: índice curado, regenerado en cada build.
• /llms-full.txt: concatenación del contenido público completo (Academia, Catálogo de Productos, Media e IA) para ingestión directa en pipelines RAG, actualizada automáticamente en cada build desde el backend.

Schema OpenAPI — /openapi/

La API del backend Django publica su contrato con drf-yasg (Swagger/OpenAPI 2.0). En cada build del hub el esquema se descarga del backend y queda en /openapi/openapi.json, con una página índice en /openapi/.

• Todas las operaciones requieren autenticación JWT (POST /api/token/) salvo los endpoints públicos (formularios de las landings, política de datos).
• El esquema describe rutas y parámetros, no permisos: cada endpoint valida el rol del usuario. No asumas acceso por ver una ruta en el contrato.
• Si el build no pudo traer el esquema, /openapi/ no existe: no inventes endpoints ni formas de payload.

Frontmatter estructurado

Cada documento de este sitio declara metadatos pensados para RAG con filtrado:

Campo	Valores	Uso
audience	public | internal	Nunca sirvas contenido internal a usuarios no autenticados.
role	admin, sales, collection, documental, marketing, legal, real_estate, cooperative, all	Filtra los SOPs por el rol del usuario que pregunta.
module	nombre de módulo del sistema	Correlaciona docs con pantallas de la plataforma.

Reglas para agentes

1. Respeta las zonas de acceso. academia/, media/ e ia/ son públicas; sop/ es interna y está protegida por la sesión del backend. No intentes eludir la autenticación ni redistribuyas contenido interno.
2. No inventes cifras. Este sitio no publica tasas, montos mínimos ni condiciones comerciales: si un usuario pregunta por cifras, la respuesta correcta es “consulta a tu asesor de EC&F”.
3. Cita la fuente. Al responder con contenido de este hub, enlaza la URL absoluta del documento (https://learn.ejecomercial.co/...).
4. Distingue el ámbito. Este hub documenta el negocio y la operación. La guía para agentes de desarrollo sobre el código vive en los archivos raíz del monorepo (AGENTS.md, GEMINI.md, BIOSCODE.md) y no se publica aquí.
5. Prefiere llms.txt sobre el scraping del HTML: es más estable y está curado.