Saltar a contenido

Requisitos previos#

Antes de usar el SDK de QCentroid, asegúrate de que la configuración necesaria de la plataforma ya está preparada.

1. Tener una cuenta de QCentroid#

Necesitas una API key válida de QCentroid para autenticarte con la API.

En la práctica, esto significa que necesitas:

  • una cuenta de usuario de QCentroid
  • tu API key

Sin una cuenta de QCentroid, el SDK no puede iniciar sesión ni acceder a ningún recurso de la plataforma.

2. Tener al menos un caso de uso creado en QCentroid#

El SDK ejecuta jobs contra un caso de uso existente en QCentroid.

Esto significa que el caso de uso debe existir ya en la plataforma antes de que puedas lanzar jobs desde Python.

Ejemplos:

  • listar los casos de uso disponibles con el SDK
  • seleccionar el use_case_name correcto
  • inspeccionar el schema del caso de uso antes de preparar los datos de entrada
  • ejecutar un job contra ese caso de uso existente

3. Tener al menos un solver creado para ese caso de uso#

El SDK no crea solvers en la versión inicial actual.

Para ejecutar un job, el caso de uso de destino debe tener al menos un solver disponible en QCentroid. Tu script hará referencia a ese solver por nombre al lanzar el job.

En otras palabras:

  • crea y configura primero el solver en la plataforma QCentroid
  • confirma que el name del solver está disponible para el caso de uso de destino
  • después llama al SDK para ejecutar jobs con ese solver

Usa nombres, no ids numéricos#

Al interactuar con QCentroid desde el SDK, los usuarios deben usar los identificadores name de estilo URN.

Ejemplos:

  • usa job.name
  • usa solver.name
  • usa use_case.name

Pueden existir ids internos numéricos en las respuestas de la API, pero no están pensados para usarse en los flujos normales del SDK.

Orden habitual de configuración#

El flujo de trabajo habitual es:

  1. Crea tu cuenta de QCentroid u obtén acceso desde tu organización.
  2. Crea un caso de uso en la plataforma QCentroid.
  3. Crea o configura un solver para ese caso de uso.
  4. Usa el SDK para subir datasets, lanzar jobs e inspeccionar resultados.

Alcance del SDK#

El SDK está pensado principalmente para flujos operativos como:

  • listar recursos
  • subir datasets
  • ejecutar jobs
  • comprobar el estado de jobs

La creación de casos de uso y solvers suele realizarse en la plataforma QCentroid, no a través del SDK.