Pasang
Prasyarat
-
Aliran kerja terurus didayakan pada instance IBM Quantum® Platform anda. Hubungi pentadbir anda untuk mendayakannya.
-
Kunci API dan CRN bagi instance anda. Lihat Cari bukti kelayakan akses anda.
-
Python 3.10 atau lebih baharu, dalam persekitaran maya yang aktif. Lihat Pasang Qiskit untuk cara menyediakan persekitaran.
Mula pantas dengan kemahiran AI
Anda boleh menggunakan kemahiran AI dalam repositori templat Qiskit Function untuk membantu anda memasang qiskit-ibm-catalog, membungkus kod tempatan sedia ada anda, dan men-deploynya sebagai aliran kerja terurus.
Pasang pakej klien
Pasang pakej qiskit-ibm-catalog:
pip install qiskit-ibm-catalog
Arahan ini turut memasang qiskit-serverless, qiskit, dan qiskit-ibm-runtime sebagai dependensi. Anda tidak perlu memasang qiskit-serverless secara berasingan. Contoh dalam panduan ini memerlukan qiskit-ibm-catalog 0.22.0 atau lebih baharu, yang memasang qiskit-serverless 0.38 dan qiskit-ibm-runtime 0.51.
Anda menggunakan dua daripada pakej ini secara langsung, di tempat yang berbeza:
-
qiskit-ibm-catalogialah klien yang anda gunakan pada komputer tempatan anda untuk memuat naik aliran kerja, menjalankannya, dan mendapatkan hasilnya. -
qiskit-serverlessberjalan di dalam kod aliran kerja anda. Ia menyediakan pembantu sepertiget_arguments(),update_status(), dansave_result().
Kemas kini pakej klien
Oleh kerana aliran kerja terurus berada dalam beta, pakej klien kerap berubah. Untuk menyemak versi yang anda ada, jalankan arahan berikut:
pip show qiskit-ibm-catalog
Or, in Python:
import qiskit_ibm_catalog
print(qiskit_ibm_catalog.__version__)
Untuk mengemas kini kepada versi terkini, jalankan arahan berikut:
pip install --upgrade qiskit-ibm-catalog
Jika versi baharu qiskit-ibm-catalog memerlukan versi qiskit-serverless yang lebih baharu, arahan ini turut mengemas kini qiskit-serverless.
Sahkan diri
Jangan sertakan kunci API anda dalam kod aliran kerja, dalam skrip, atau dalam fail notebook. Aliran kerja yang sedang berjalan menggunakan bukti kelayakan dan instance yang anda gunakan untuk memanggil run().
Klien aliran kerja terurus menggunakan bukti kelayakan yang sama seperti qiskit-ibm-runtime. Jika anda sudah menyimpan akaun dengan QiskitRuntimeService.save_account(), klien memuatkan akaun tersimpan lalai anda, dan anda boleh terus ke Sahkan persediaan anda.
Jika anda belum menyimpan akaun, simpan kunci API dan CRN instance anda sekali sahaja dalam persekitaran yang dipercayai:
from qiskit_ibm_catalog import ManagedWorkflowClient
ManagedWorkflowClient.save_account(
token="<your-api-key>",
instance="<your-instance-crn>",
)
Kaedah ini menulis bukti kelayakan anda ke fail yang sama seperti QiskitRuntimeService.save_account(). Klien menggunakan saluran ibm_quantum_platform secara lalai, jadi anda tidak perlu menetapkan channel. Untuk menyimpan lebih daripada satu akaun, tetapkan name, dan hantar name yang sama apabila anda mencipta klien.
Untuk lebih banyak pilihan, seperti menyimpan beberapa akaun atau memilih instance secara automatik, lihat Simpan bukti kelayakan log masuk anda. Jika anda bekerja pada komputer awam atau persekitaran lain yang tidak dipercayai, jangan simpan bukti kelayakan anda. Sebaliknya, ikuti Mulakan perkhidmatan dalam persekitaran yang tidak dipercayai.
Sahkan persediaan anda
Sambung ke aliran kerja terurus dengan akaun tersimpan anda, dan senaraikan aliran kerja yang telah anda muat naik:
from qiskit_ibm_catalog import ManagedWorkflowClient
client = ManagedWorkflowClient()
client.list()
Jika anda belum memuat naik aliran kerja, output ialah senarai kosong ([]). Jika anda melihat ralat pengesahan, klien tidak menemui bukti kelayakan yang sah. Semak akaun yang anda simpan dalam bahagian Sahkan diri.
Langkah seterusnya
- Deploy aliran kerja terurus pertama anda untuk memuat naik aliran kerja, menjalankannya, dan mendapatkan hasilnya.
- Untuk bermula dengan kod yang berfungsi, deploy salah satu templat Qiskit Function, atau sesuaikan templat asas untuk aliran kerja anda sendiri.