Instalar

Requisitos previos

• Workflows gestionados habilitados en tus instancias de IBM Quantum® Platform. Contacta a tu administrador para habilitarlos.

• Una clave de API y el CRN de tu instancia. Consulta Encuentra tus credenciales de acceso.

• Python 3.10 o posterior, en un entorno virtual activo. Consulta Instalar Qiskit para saber cómo configurar un entorno.

Inicio rápido con skills de IA

Puedes usar los skills de IA del repositorio de plantillas de Qiskit Function para ayudarte a instalar qiskit-ibm-catalog, empaquetar tu código local existente y desplegarlo como un workflow gestionado.

Instalar el paquete cliente

Instala el paquete qiskit-ibm-catalog:

pip install qiskit-ibm-catalog

Este comando también instala qiskit-serverless, qiskit y qiskit-ibm-runtime como dependencias. No necesitas instalar qiskit-serverless por separado. Los ejemplos de estas guías requieren qiskit-ibm-catalog 0.22.0 o posterior, que instala qiskit-serverless 0.38 y qiskit-ibm-runtime 0.51.

Usas dos de estos paquetes directamente, en lugares distintos:

• qiskit-ibm-catalog es el cliente que usas en tu computadora local para subir workflows, ejecutarlos y obtener sus resultados.

• qiskit-serverless se ejecuta dentro del código de tu workflow. Proporciona utilidades como get_arguments(), update_status() y save_result().

Actualizar el paquete cliente

Como los workflows gestionados están en beta, el paquete cliente cambia con frecuencia. Para comprobar qué versión tienes, ejecuta el siguiente comando:

pip show qiskit-ibm-catalog

Or, in Python:

import qiskit_ibm_catalog

print(qiskit_ibm_catalog.__version__)

Para actualizar a la última versión, ejecuta el siguiente comando:

pip install --upgrade qiskit-ibm-catalog

Si la nueva versión de qiskit-ibm-catalog requiere una versión más reciente de qiskit-serverless, este comando también actualiza qiskit-serverless.

Autenticarse

Protege tu clave de API

No incluyas tu clave de API en el código de tu workflow, en scripts ni en archivos de notebook. Un workflow en ejecución usa las credenciales y la instancia que usaste para llamar a run().

El cliente de workflows gestionados usa las mismas credenciales que qiskit-ibm-runtime. Si ya guardaste una cuenta con QiskitRuntimeService.save_account(), el cliente carga tu cuenta guardada predeterminada y puedes saltar a Verificar tu configuración.

Si no has guardado una cuenta, guarda tu clave de API y el CRN de tu instancia una sola vez en un entorno de confianza:

from qiskit_ibm_catalog import ManagedWorkflowClient

ManagedWorkflowClient.save_account(
    token="<your-api-key>",
    instance="<your-instance-crn>",
)

Este método escribe tus credenciales en el mismo archivo que QiskitRuntimeService.save_account(). El cliente usa el canal ibm_quantum_platform por defecto, por lo que no necesitas establecer channel. Para guardar más de una cuenta, establece name y pasa el mismo name al crear el cliente.

Para más opciones, como guardar varias cuentas o seleccionar una instancia automáticamente, consulta Guardar tus credenciales de inicio de sesión. Si trabajas en una computadora pública u otro entorno no confiable, no guardes tus credenciales. En su lugar, sigue Inicializar el servicio en un entorno no confiable.

Verificar tu configuración

Conéctate a los workflows gestionados con tu cuenta guardada y lista los workflows que subiste:

from qiskit_ibm_catalog import ManagedWorkflowClient

client = ManagedWorkflowClient()
client.list()

Si aún no has subido ningún workflow, la salida es una lista vacía ([]). Si ves un error de autenticación, el cliente no encontró credenciales válidas. Revisa la cuenta que guardaste en la sección Autenticarse.

Próximos pasos

Recomendaciones

• Despliega tu primer workflow gestionado para cargar un workflow, ejecutarlo y obtener su resultado.
• Para empezar con código que funciona, despliega una de las plantillas de Qiskit Function o adapta una plantilla base para tu propio workflow.