Solución de Problemas

Guía para resolver problemas comunes en TeamDay.

Problemas de Agentes

El Agente No Responde

Síntomas:

  • El agente cuelga o no responde

Soluciones:

  1. Espera 30 segundos - a veces solo es lento
  2. Cancela y reintenta
  3. Verifica que el agente siga existiendo
  4. Intenta con un prompt más simple

Respuestas Incorrectas

Síntomas:

  • El agente da respuestas irrelevantes

Soluciones:

  1. Mejora el prompt del sistema
  2. Sé más específico en tus instrucciones
  3. Añade ejemplos de salida deseada
  4. Prueba cambiar el modelo

Token Limitado

Síntomas:

  • La respuesta se corta

Soluciones:

  1. Aumenta maxTokens en configuración
  2. Simplifica tu pregunta
  3. Divide la tarea en pasos

Problemas de Espacios

Espacio No Se Inicializa

Síntomas:

  • Espacio atrapado en "inicializando"

Soluciones:

  1. Espera 5 minutos más
  2. Recarga la página
  3. Cancela y crea uno nuevo

Archivos Desaparecidos

Síntomas:

  • Los archivos no persisten

Soluciones:

  1. Verifica que el espacio esté listo
  2. Confirma cambios a Git si corresponde
  3. Descarga desde S3 si es necesario

Permisos Denegados

Síntomas:

  • "Permiso denegado" al acceder a archivos

Soluciones:

  1. Verifica que el agente esté asignado al espacio
  2. Verifica la visibilidad del espacio
  3. Verifica que estés en la organización correcta

Problemas de Git

Clone Falla

Síntomas:

  • Error "Repositorio no encontrado"

Soluciones:

  1. Verifica la URL del repositorio
  2. Para repos privados, conecta GitHub OAuth
  3. Verifica que tengas acceso al repositorio

Commit Falla

Síntomas:

  • Error al confirmar cambios

Soluciones:

  1. Verifica que haya cambios staged
  2. Verifica el formato del mensaje de confirmación
  3. Intenta git status para más info

Push Rechazado

Síntomas:

  • Error "rejected" al empujar

Soluciones:

  1. Tira primero: git pull origin main
  2. Resuelve conflictos si hay
  3. Luego empuja de nuevo

Problemas de Misiones

Misión No Se Ejecuta

Síntomas:

  • El cronograma no se activa

Soluciones:

  1. Verifica que la misión no esté pausada
  2. Verifica el cronograma - ¿ya pasó la hora?
  3. Haz clic en "Ejecutar Ahora" para probar
  4. Verifica los logs de ejecución

Ejecución Falla

Síntomas:

  • La ejecución muestra error

Soluciones:

  1. Ve el historial para ver el error específico
  2. Verifica las instrucciones
  3. Verifica que el agente tenga acceso necesario
  4. Intenta ejecutar manualmente

Resultado Incorrecto

Síntomas:

  • La misión se ejecuta pero da resultado equivocado

Soluciones:

  1. Revisa las instrucciones
  2. Prueba manualmente con "Ejecutar Ahora"
  3. Mejora el prompt
  4. Añade más contexto

Problemas de API

401 No Autorizado

Síntomas:

  • Token rechazado

Soluciones:

  1. Verifica que el token sea válido
  2. Verifica que no haya expirado
  3. Crea un nuevo token si es necesario
  4. Verifica el encabezado Authorization

403 Prohibido

Síntomas:

  • Acceso denegado a recurso

Soluciones:

  1. Verifica que seas miembro de la org
  2. Verifica los permisos del token
  3. Verifica que el recurso exista

404 No Encontrado

Síntomas:

  • Recurso no existe

Soluciones:

  1. Verifica el ID del recurso
  2. Verifica que el recurso no haya sido eliminado
  3. Verifica la URL de la solicitud

Obtener Ayuda

Si no encuentras la solución:

  1. Revisa los logs:
    • Ve Configuración → Logs
    • Busca mensajes de error específicos
  2. Contacta soporte:
  3. Comunidad:

Próximos Pasos