Preguntas Frecuentes (FAQ)#

Primeros pasos#

Preguntas semilla

Estas son preguntas para arrancar. El FAQ se irá ampliando con las dudas reales que surjan en el hub.

¿Cómo accedo a la plataforma?: A través de https://app.sandbox.qcentroid.com/ con tu correo electrónico y contraseña.
¿Qué es lo mínimo que tengo que hacer, y para cuándo?: Documentar cada caso de uso con sus tres elementos: Business Information, Business Impact y Showcase. Casos dados de alta antes del 15 de julio; KPIs iniciales antes del 20 de julio.
¿La plataforma tiene coste?: Está incluida dentro del acuerdo del hub, sin coste de licencia, salvo el uso computacional. Los créditos de computación cuántica se valoran caso por caso.
¿Quién puede ver mis casos de uso?: Cada organización ve sus propios casos. Los administradores del hub (LKS/EKS) tienen visibilidad sobre el conjunto de casos para labores de coordinación.
¿En qué idioma relleno la información?: Los campos guía están en español. Puedes redactar el contenido en español.
¿Qué pasa si no llego al 15 de julio con todo?: El objetivo es tener la información mínima a tiempo. Prioriza dar de alta el caso y cargar la Business description; el resto de campos puedes completarlos y ajustarlos más adelante.
¿Necesito saber programar para usar la plataforma?: No para la parte obligatoria (documentar el caso). Programar solo es necesario si quieres registrar y ejecutar tus propios solvers, que es opcional.
¿Puedo ejecutar mis algoritmos fuera de la plataforma?: Sí. Puedes ejecutar en tu propio entorno e importar los resultados a un job (ver Usar la Plataforma > Opciones avanzadas > Cargar datos de ejecuciones externas).
¿Cómo se asignan los créditos de computación?: Se valoran caso por caso.

General#

¿Puedo añadir librerías adicionales a mi solver?: Sí. Añade todas las dependencias en el archivo requirements.txt, en la raíz del repositorio, siguiendo el formato pip. La plataforma las instalará automáticamente al construir el solver.
¿Puedo usar cualquier lenguaje de programación?: Los solvers se implementan en Python. El archivo de entrada qcentroid.py debe ser Python y la función run() debe mantener su firma exacta.
¿Dónde veo los errores si mi solver falla?: En la plataforma, accede al job fallido y ve a la pestaña Raw results. Verás la traza completa del error. También puedes revisar la pestaña Execution logs para ver los logs que hayas añadido con logger.info().

Créditos#

Todas las organizaciones empiezan con 0 créditos

Para obtener créditos hay que contactar con soporte técnico.

¿Cuántos créditos tiene mi organización?: Puedes consultarlo en el menú de usuario (esquina superior derecha) > Credits. Allí verás el saldo total asignado a tu organización y el desglose por usuario.
Mi job ha sido rechazado por créditos insuficientes. ¿Qué hago?: Cualquier miembro de tu organización puede reasignar créditos desde el menú de usuario > Credits.
¿Cuántos créditos consume cada ejecución?: Depende del solver y del proveedor de hardware utilizado. El coste estimado de cada solver se muestra en su página de detalle en la plataforma. Puedes consultar el coste real de cada ejecución en la pestaña Cost details de la página de detalle del job, una vez finalizado.
¿Puedo ver el historial de consumo de créditos?: Sí, en la sección Credits del menú de usuario encontrarás el historial de consumo asociado a tu cuenta.

Plataforma#

Accedo a la plataforma pero no veo mis casos de uso o solvers.: Verifica que estás accediendo con la cuenta correcta. La URL de la plataforma es https://app.sandbox.qcentroid.com/.
Lancé un Build y está tardando demasiado.: Puedes hacer clic en el botón Build de nuevo para cancelar el proceso en curso y relanzarlo. Si sigue fallando, revisa el log del build para ver el error concreto. Las causas más habituales son un requirements.txt con dependencias conflictivas o la rama configurada que no existe en el repositorio.
Mi job lleva mucho tiempo en estado Pending o Running.: Es normal que los jobs tarden según la carga del sistema y el proveedor de hardware utilizado. Si un job lleva más de 30 minutos sin avanzar, anota el Job ID para revisarlo.
¿Dónde descargo los resultados de mi job?: En la página de detalle del job, ve a la pestaña Raw results y usa el botón de descarga. Los archivos adicionales generados por el solver (gráficos, CSVs, etc.) aparecen en la pestaña Assets.
Obtuve un error 403 Forbidden al intentar acceder.: Cierra la sesión completamente y vuelve a iniciarla. Si el problema persiste, puede que tu sesión haya caducado o que la cuenta no tenga acceso al recurso.
¿Por qué hay que conectar el repositorio y añadir una Deploy Key?: La plataforma no almacena tu código: cuando lanzas un build, descarga el código directamente desde tu servidor Git. Para poder hacer esa descarga en un repositorio privado, necesita credenciales de acceso.; El mecanismo que usa es una Deploy Key: un par de claves SSH que la plataforma genera automáticamente. La clave privada la guarda la plataforma de forma segura; la clave pública la añades tú en tu servidor Git (GitHub, GitLab, Bitbucket…) como clave de solo lectura autorizada. A partir de ese momento, cada vez que la plataforma necesite descargar el código, se identifica con esa clave y el servidor Git la acepta.; Es un estándar habitual para la integración CI/CD: seguro (no se comparten contraseñas), de solo lectura (la plataforma no puede modificar tu código) y revocable en cualquier momento desde tu servidor Git.

Desarrollo#

Modifiqué el código pero la plataforma sigue ejecutando la versión antigua.

Asegúrate de haber hecho commit y push de los cambios al servidor Git, y después lanzado el proceso Build en la plataforma. La plataforma no recoge los cambios directamente, solo del repositorio Git.

Mi solver funciona bien en local pero falla en la plataforma.

Las causas más comunes son:

Una dependencia que falta en requirements.txt.

Una ruta de archivo local que no existe en el entorno de la plataforma.

Una excepción capturada localmente que en la plataforma se comporta distinto.

Diferencias en la versión de Python o de alguna librería.

Añade logs con logger.info() para tener más visibilidad del punto exacto de fallo.