Resolución de problemas
"Sol dijo que mandó el email pero no llegó"
Primero: abrí el link al trace al final de la respuesta de Sol. Mirá el step de output. Si el messageId es un UUID real (36 hex con guiones), el email efectivamente se envió — chequeá tu spam.
Si messageId no está o tiene forma corta/falsa, el verifier debería haberlo redactado como "[valor no verificado]". En ese caso el email no salió. Causas comunes:
Dirección destinataria mal tipeada → reintentar con email correcto
Rate limit del dominio → esperar 1 hora y reintentar
Attachment muy grande → reducir filas o dividir el export
"La capability nunca convergió"
Algunos sitios son difíciles para el motor (mucho JS, banners de cookies, clases inestables). El explore engine tiene un budget de 20 iteraciones; en sitios complejos puede darse por vencido.
Opciones:
Probar un sitio alternativo más simple con la misma data
Darle a Sol un selector específico: *"Sol, aprendé ... el selector del precio es `.price-badge > span`"*
Esperar soporte de scroll + accept-cookies (roadmap)
Nota: Sol NUNCA va a fingir que aprendió si no lo hizo. "Did not converge" es honesto.
"Un proceso está atascado corriendo por horas"
No debería pasar seguido — el motor tiene timeouts. Si pasa:
Abrí el trace, chequeá `current_step_index` para ver dónde se atascó
Si es un step de capability: chequeá la capability execution — capaz Chrome está desconectado
Email a support@agas.ar con el execution_id. Staff puede matar la ejecución y diagnosticar.
"La extension dice 'Connecting...'"
Ver sección de troubleshooting en [Extensión de Chrome](/help/extension).
"Pedí X y me dio Y"
La interpretación de Sol puede estar desfasada. La respuesta debería decir qué planeó hacer (via plan summary). Si plan ≠ intent:
Pedí lo que querías más explícitamente
Si le pediste componer un proceso, puede haber agregado un step innecesario. Podés decirle: "correlo sin el analyze step" — el composer lo rehace.
"La canary falló 2 veces, la capability quedó needs_human"
El motor no pudo producir una receta confiable para ese sitio. Opciones:
Darle a Sol un prompt más específico con hint de selector
Probar una URL de entrada distinta en el mismo sitio (ej. página de categoría en vez del home)
Archivar esa capability y buscar una fuente alternativa
"Me pasé del budget de exploración"
Los caps de budget previenen costos descontrolados. Si llegaste al límite:
Chequeá qué capability está consumiendo tokens (trace UI muestra costo por run)
Archivá capabilities que no uses
Pedí un bump temporal en support@agas.ar
"Sol es lento la primera vez"
Esperable. El aprendizaje toma 2-5 minutos (schema inference + exploración + canary). Las corridas siguientes son de 10-20 segundos (replay).
Si la primera vez tarda más de 5 min, el explore engine puede haber entrado en retry loop. Chequeá el trace — si ves 20 iteraciones sin convergencia, el sitio es probablemente muy complejo.
¿Seguís atascado?
Email a support@agas.ar con:
El execution_id (del URL del trace)
Qué le pediste a Sol
Qué esperabas vs qué pasó
Leemos cada mail. Tiempo de respuesta: <24h días hábiles.