Installazione

Prerequisiti

• Workflow gestiti abilitati nelle tue istanze di IBM Quantum® Platform. Contatta il tuo amministratore per abilitarli.

• Una API key e il CRN della tua istanza. Vedi Trova le tue credenziali di accesso.

• Python 3.10 o successivo, in un ambiente virtuale attivo. Vedi Installare Qiskit per sapere come configurare un ambiente.

Avvio rapido con le skill AI

Puoi usare le skill AI nel repository dei template di Qiskit Function per installare qiskit-ibm-catalog, pacchettizzare il tuo codice locale esistente e distribuirlo come workflow gestito.

Installa il pacchetto client

Installa il pacchetto qiskit-ibm-catalog:

pip install qiskit-ibm-catalog

Questo comando installa anche qiskit-serverless, qiskit e qiskit-ibm-runtime come dipendenze. Non è necessario installare qiskit-serverless separatamente. Gli esempi di queste guide richiedono qiskit-ibm-catalog 0.22.0 o successivo, che installa qiskit-serverless 0.38 e qiskit-ibm-runtime 0.51.

Usi direttamente due di questi pacchetti, in punti diversi:

• qiskit-ibm-catalog è il client che usi sul tuo computer locale per caricare i workflow, eseguirli e ottenerne i risultati.

• qiskit-serverless viene eseguito all'interno del codice del tuo workflow. Fornisce helper come get_arguments(), update_status() e save_result().

Aggiorna il pacchetto client

Poiché i workflow gestiti sono in beta, il pacchetto client cambia spesso. Per verificare quale versione hai, esegui il seguente comando:

pip show qiskit-ibm-catalog

Or, in Python:

import qiskit_ibm_catalog

print(qiskit_ibm_catalog.__version__)

Per aggiornare all'ultima versione, esegui il seguente comando:

pip install --upgrade qiskit-ibm-catalog

Se la nuova versione di qiskit-ibm-catalog richiede una versione più recente di qiskit-serverless, questo comando aggiorna anche qiskit-serverless.

Autenticazione

Proteggi la tua API key

Non includere la tua API key nel codice del workflow, negli script o nei file notebook. Un workflow in esecuzione usa le credenziali e l'istanza che hai usato per chiamare run().

Il client dei workflow gestiti usa le stesse credenziali di qiskit-ibm-runtime. Se hai già salvato un account con QiskitRuntimeService.save_account(), il client carica il tuo account salvato predefinito e puoi passare direttamente a Verifica la tua configurazione.

Se non hai salvato un account, salva la tua API key e il CRN dell'istanza una sola volta in un ambiente attendibile:

from qiskit_ibm_catalog import ManagedWorkflowClient

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

Questo metodo scrive le tue credenziali nello stesso file di QiskitRuntimeService.save_account(). Il client usa per impostazione predefinita il canale ibm_quantum_platform, quindi non è necessario impostare channel. Per salvare più di un account, imposta name e passa lo stesso name quando crei il client.

Per altre opzioni, come salvare più account o selezionare automaticamente un'istanza, vedi Salva le tue credenziali di accesso. Se lavori su un computer pubblico o in un altro ambiente non attendibile, non salvare le tue credenziali. Segui invece Inizializzare il servizio in un ambiente non attendibile.

Verifica la tua configurazione

Connettiti ai workflow gestiti con il tuo account salvato ed elenca i workflow che hai caricato:

from qiskit_ibm_catalog import ManagedWorkflowClient

client = ManagedWorkflowClient()
client.list()

Se non hai ancora caricato un workflow, l'output è un elenco vuoto ([]). Se vedi un errore di autenticazione, il client non ha trovato credenziali valide. Controlla l'account che hai salvato nella sezione Autenticazione.

Prossimi passi

Raccomandazioni

• Distribuisci il tuo primo workflow gestito per caricare un workflow, eseguirlo e ottenerne il risultato.
• Per partire da codice funzionante, distribuisci uno dei template di Qiskit Function, oppure adatta un template di base al tuo workflow.