Tres Enfoques de Integración
AI Evaluator soporta tres formas de integrarse con GitLab CI: Componente CI/CD (recomendado), Job Template con extends:, y curl inline (sin dependencias).
Enfoque 1: Componente del Catálogo CI/CD de GitLab (Recomendado)
Agregá el componente desde el catálogo CI/CD de GitLab con inputs: stage, api_key, agent_url, dataset, metrics, min_score.
Enfoque 2: Job Template con `extends:`
Para equipos que quieren más control, usá un template con extends: .ai-evaluate.
Enfoque 3: curl Inline (Sin Dependencias)
Usá llamadas curl directas con jq para parsear resultados. Control total sin dependencias externas.
Pipeline Multi-Etapa con Quality Gate
Pipeline completa con build → verify → deploy-staging → evaluate → deploy-prod.
Variables de GitLab CI/CD
Configurá AI_EVALUATOR_API_KEY (masked), STAGING_AGENT_URL y PROD_AGENT_URL en Settings → CI/CD → Variables.
Solución de Problemas
jq no encontrado → instalar. 401 → verificar API key. No se puede conectar → verificar URL del agente. Pipeline colgado → usar async para datasets grandes.