Instal

Prasyarat

• Managed workflows diaktifkan di instance IBM Quantum® Platform kamu. Hubungi administrator kamu untuk mengaktifkannya.

• API key dan CRN dari instance kamu. Lihat Find your access credentials.

• Python 3.10 atau lebih baru, di virtual environment yang aktif. Lihat Install Qiskit untuk cara menyiapkan environment.

Mulai cepat dengan AI skills

Kamu bisa memakai AI skills di repositori template Qiskit Function untuk membantu menginstal qiskit-ibm-catalog, mengemas kode lokal yang sudah ada, dan men-deploy-nya sebagai managed workflow.

Instal paket klien

Instal paket qiskit-ibm-catalog:

pip install qiskit-ibm-catalog

Perintah ini juga menginstal qiskit-serverless, qiskit, dan qiskit-ibm-runtime sebagai dependensi. Kamu tidak perlu menginstal qiskit-serverless secara terpisah. Contoh di panduan-panduan ini membutuhkan qiskit-ibm-catalog 0.22.0 atau lebih baru, yang menginstal qiskit-serverless 0.38 dan qiskit-ibm-runtime 0.51.

Kamu memakai dua dari paket-paket ini secara langsung, di tempat yang berbeda:

• qiskit-ibm-catalog adalah klien yang kamu pakai di komputer lokal untuk mengunggah workflow, menjalankannya, dan mengambil hasilnya.

• qiskit-serverless berjalan di dalam kode workflow kamu. Paket ini menyediakan helper seperti get_arguments(), update_status(), dan save_result().

Perbarui paket klien

Karena managed workflows masih dalam beta, paket klien sering berubah. Untuk mengecek versi yang kamu punya, jalankan perintah berikut:

pip show qiskit-ibm-catalog

Or, in Python:

import qiskit_ibm_catalog

print(qiskit_ibm_catalog.__version__)

Untuk memperbarui ke versi terbaru, jalankan perintah berikut:

pip install --upgrade qiskit-ibm-catalog

Jika versi baru qiskit-ibm-catalog membutuhkan qiskit-serverless yang lebih baru, perintah ini juga memperbarui qiskit-serverless.

Autentikasi

Lindungi API key kamu

Jangan sertakan API key kamu di kode workflow, di skrip, atau di file notebook. Workflow yang berjalan memakai kredensial dan instance yang kamu pakai untuk memanggil run().

Klien managed workflows memakai kredensial yang sama dengan qiskit-ibm-runtime. Jika kamu sudah menyimpan akun dengan QiskitRuntimeService.save_account(), klien akan memuat akun tersimpan default kamu, dan kamu bisa langsung lompat ke Verify your setup.

Jika kamu belum menyimpan akun, simpan API key dan CRN instance kamu satu kali di lingkungan tepercaya:

from qiskit_ibm_catalog import ManagedWorkflowClient

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

Metode ini menulis kredensial kamu ke file yang sama dengan QiskitRuntimeService.save_account(). Klien memakai channel ibm_quantum_platform secara default, jadi kamu tidak perlu mengatur channel. Untuk menyimpan lebih dari satu akun, atur name, dan berikan name yang sama saat kamu membuat klien.

Untuk opsi lainnya, seperti menyimpan beberapa akun atau memilih instance secara otomatis, lihat Save your login credentials. Jika kamu bekerja di komputer publik atau lingkungan lain yang tidak tepercaya, jangan simpan kredensial kamu. Sebagai gantinya, ikuti Initialize the service in an untrusted environment.

Verifikasi setup kamu

Hubungkan ke managed workflows dengan akun tersimpan kamu, lalu daftar workflow yang sudah kamu unggah:

from qiskit_ibm_catalog import ManagedWorkflowClient

client = ManagedWorkflowClient()
client.list()

Jika kamu belum mengunggah workflow, outputnya adalah list kosong ([]). Jika kamu melihat error autentikasi, klien tidak menemukan kredensial yang valid. Periksa akun yang kamu simpan di bagian Authenticate.

Langkah berikutnya

Rekomendasi

• Deploy your first managed workflow untuk mengunggah workflow, menjalankannya, dan mengambil hasilnya.
• Untuk memulai dari kode yang sudah jalan, deploy salah satu template Qiskit Function, atau adaptasi base template untuk workflow kamu sendiri.