Instalare

Cerințe preliminare

• Fluxuri de lucru gestionate activate pe instanțele tale IBM Quantum® Platform. Contactează administratorul pentru a le activa.

• O cheie API și CRN-ul instanței tale. Vezi Găsește-ți credențialele de acces.

• Python 3.10 sau mai nou, într-un mediu virtual activ. Vezi Instalează Qiskit pentru configurarea unui mediu.

Pornire rapidă cu abilități AI

Poți folosi abilitățile AI din depozitul de șabloane Qiskit Function pentru a te ajuta să instalezi qiskit-ibm-catalog, să împachetezi codul tău local existent și să-l implementezi ca flux de lucru gestionat.

Instalează pachetul client

Instalează pachetul qiskit-ibm-catalog:

pip install qiskit-ibm-catalog

Această comandă instalează și qiskit-serverless, qiskit și qiskit-ibm-runtime ca dependențe. Nu trebuie să instalezi qiskit-serverless separat. Exemplele din aceste ghiduri necesită qiskit-ibm-catalog 0.22.0 sau mai nou, care instalează qiskit-serverless 0.38 și qiskit-ibm-runtime 0.51.

Folosești direct două dintre aceste pachete, în locuri diferite:

• qiskit-ibm-catalog este clientul pe care îl folosești pe calculatorul tău local pentru a încărca fluxuri de lucru, a le rula și a obține rezultatele lor.

• qiskit-serverless rulează în interiorul codului fluxului tău de lucru. Oferă funcții auxiliare precum get_arguments(), update_status() și save_result().

Actualizează pachetul client

Deoarece fluxurile de lucru gestionate sunt în versiune beta, pachetul client se schimbă des. Pentru a verifica ce versiune ai, rulează următoarea comandă:

pip show qiskit-ibm-catalog

Or, in Python:

import qiskit_ibm_catalog

print(qiskit_ibm_catalog.__version__)

Pentru a actualiza la cea mai recentă versiune, rulează următoarea comandă:

pip install --upgrade qiskit-ibm-catalog

Dacă noua versiune de qiskit-ibm-catalog necesită o versiune mai nouă de qiskit-serverless, această comandă actualizează și qiskit-serverless.

Autentifică-te

Protejează-ți cheia API

Nu include cheia ta API în codul fluxului de lucru, în scripturi sau în fișiere notebook. Un flux de lucru în execuție folosește credențialele și instanța pe care le-ai folosit pentru a apela run().

Clientul pentru fluxuri de lucru gestionate folosește aceleași credențiale ca qiskit-ibm-runtime. Dacă ai salvat deja un cont cu QiskitRuntimeService.save_account(), clientul încarcă contul tău salvat implicit și poți trece direct la Verifică-ți configurarea.

Dacă nu ai salvat un cont, salvează o singură dată cheia API și CRN-ul instanței într-un mediu de încredere:

from qiskit_ibm_catalog import ManagedWorkflowClient

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

Această metodă scrie credențialele tale în același fișier ca QiskitRuntimeService.save_account(). Clientul folosește implicit canalul ibm_quantum_platform, așa că nu trebuie să setezi channel. Pentru a salva mai multe conturi, setează name și transmite același name când creezi clientul.

Pentru mai multe opțiuni, cum ar fi salvarea mai multor conturi sau selectarea automată a unei instanțe, vezi Salvează-ți credențialele de autentificare. Dacă lucrezi pe un calculator public sau în alt mediu care nu este de încredere, nu-ți salva credențialele. În schimb, urmează Inițializarea serviciului într-un mediu nesigur.

Verifică-ți configurarea

Conectează-te la fluxurile de lucru gestionate cu contul tău salvat și listează fluxurile de lucru pe care le-ai încărcat:

from qiskit_ibm_catalog import ManagedWorkflowClient

client = ManagedWorkflowClient()
client.list()

Dacă nu ai încărcat încă un flux de lucru, rezultatul este o listă goală ([]). Dacă vezi o eroare de autentificare, clientul nu a găsit credențiale valide. Verifică contul pe care l-ai salvat în secțiunea Autentifică-te.

Pașii următori

Recomandări

• Implementează primul tău flux de lucru gestionat pentru a încărca un flux de lucru, a-l rula și a obține rezultatul acestuia.
• Pentru a porni de la cod funcțional, implementează unul dintre șabloanele Qiskit Function sau adaptează un șablon de bază pentru propriul tău flux de lucru.