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 (pendiente): concatenación del contenido público completo para ingestión directa, se generará como hook de build.

Schema OpenAPI — /openapi/

La API del backend Django del ecosistema publicará su contrato tipado con drf-spectacular (/api/schema/ en el backend). En cada build del hub, el schema se copiará a /openapi/ en este sitio.

Estado actual: pendiente de generación por el backend. Hasta que el backend adopte drf-spectacular, la ruta /openapi/ no contiene el schema. No asumas endpoints ni formas de payload: espera el contrato tipado.

Cuando esté disponible, el schema habilitará agentes que operan la API con validación de tipos: simulaciones de crédito, consulta de contratos, registro de actividades, etc., siempre con la autenticación del backend.

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.