Guna Pembantu Kod Qiskit dalam JupyterLab

Ketahui cara memasang, menggunakan, mengkonfigurasi, dan menyahpasang sambungan Pembantu Kod Qiskit rasmi dalam JupyterLab.

Pasang sambungan JupyterLab

Untuk memasang sambungan JupyterLab, jalankan perintah berikut daripada terminal:

pip install qiskit-code-assistant-jupyterlab

Selepas memasang sambungan, mulakan JupyterLab:

jupyter lab

Sambungan dimuatkan secara automatik dan disenaraikan di bahagian bawah tetingkap JupyterLab. Rujuk dokumentasi JupyterLab untuk bantuan menggunakan JupyterLab.

Konfigurasikan tetapan sambungan

Adalah disyorkan untuk mengedit tetapan JupyterLab berikut dengan pergi ke Settings -> Settings Editor:

• Klik Inline Completer, cari "Show widget" dan pilih Always. Ini bermakna widget pelengkap sebaris akan sentiasa dipaparkan supaya anda boleh mengitar dan memilih item pelengkap.

• Klik Code Completion dan tingkatkan nilai "Default timeout for a provider." kepada 10000 atau 10 saat. Nilai lalai adalah 1 saat, tetapi API Pembantu Kod Qiskit mungkin mengambil masa lebih lama untuk mencari cadangan. Tetapan ini hanya terpakai untuk menu konteks standard yang dipanggil dengan Tab. Pelengkap sebaris mempunyai lalai 10 saat.

Tetapan lain yang mungkin ingin anda ubah:

• Pintasan papan kekunci boleh diubah daripada Settings > Settings Editor > Keyboard Shortcuts.

• Anda boleh menukar token API IBM Quantum yang digunakan dalam palet perintah JupyterLab. Untuk berbuat demikian, taip Alt + Shift + C, cari qiskit, pilih perintah Qiskit Code Assistant: Set IBM Quantum API token, dan tampal kunci anda.

• [Lanjutan] Untuk menukar instans perkhidmatan Pembantu Kod Qiskit yang patut digunakan oleh sambungan, edit tetapan serviceUrl Pembantu Kod Qiskit.

• [Lanjutan] Pintasan papan kekunci boleh diubah dengan mencari completer dalam tetapan Keyboard Shortcuts (Settings -> Settings Editor -> Keyboard Shortcuts) dan menambah pintasan baharu untuk perintah yang berkaitan.

Mulakan menggunakan sambungan Pembantu Kod Qiskit untuk JupyterLab

Pengesahan dan persediaan

Selepas memasang sambungan, ia cuba mengesahkan identiti anda. Secara lalai, pakej cuba mengesahkan kepada perkhidmatan IBM Quantum dengan kunci API yang ditakrifkan, dan menggunakan kunci anda daripada pemboleh ubah persekitaran QISKIT_IBM_TOKEN atau daripada fail ~/.qiskit/qiskit-ibm.json (di bawah bahagian default-ibm-quantum). Jika anda memerlukan bantuan mengkonfigurasi akaun anda, ikuti arahan dalam Sediakan akaun IBM Cloud anda.

Secara lalai, sambungan menggunakan model mistral-small-3.2-24b-qiskit, yang disenaraikan dalam Pemilih Model di bar status bawah.

Kali pertama anda menggunakan model mistral-small-3.2-24b-qiskit, tetingkap terbuka yang menyenaraikan beberapa sekatan utama yang perlu anda ketahui semasa menggunakan model tersebut. Klik Accept untuk mengaktifkan model bagi penjanaan kod.

Jana kod

Semasa anda membangunkan kod menggunakan Qiskit, anda boleh meminta Pembantu Kod Qiskit untuk membantu anda. Secara amnya, pembantu mencadangkan kod yang lebih baik sebagai respons kepada komen atau docstring Python, tetapi anda boleh menggunakan pembantu di mana sahaja dalam fail anda.

Untuk mendapatkan cadangan kod, taip gesaan, kemudian taip Alt + . atau Alt + \. Terdapat dua jenis gesaan yang boleh anda gunakan:

• Masukkan kod separa dan dapatkan cadangan untuk melengkapkan kod tersebut. Contoh:

  from qiskit.circuit import QuantumCircuit
  from qiskit.transpiler import generate_preset_pass_manager
  from qiskit_ibm_runtime import SamplerV2 as Sampler
  from qiskit_ibm_runtime.fake_provider import FakeManilaV2
  
  # Bell Circuit
  qc = QuantumCircuit(2)
  qc.h(0)
  qc.cx(0, 1)
  
  qc.mea # Type Ctrl + . for a code suggestion.

• Taip tanda paun (#), kemudian taip gesaan anda. Contoh: # Give me a random circuit of 5 qubits and a depth of 4.

Bekerja dengan cadangan kod

Gunakan yang berikut untuk menerima, menolak, dan mengitar melalui cadangan:

• Alt + [ dan Alt + ] boleh digunakan untuk mengitar melalui senarai cadangan (jika terdapat lebih daripada satu).
• Alt + Tab atau Alt + END menerima kod yang dicadangkan dan menyisipkannya di lokasi kursor semasa.

Selain itu, selepas pembantu dijalankan, anda boleh menggunakan butang pada widget untuk mengitar atau menerima cadangan:

nota

Perkhidmatan kadangkala mungkin mengambil beberapa saat untuk mengembalikan cadangan, anda boleh melihat apabila perkhidmatan sedang bekerja dengan menyemak bar status.

Jupyterlab juga menyertakan menu konteks cadangan tradisional. Gunakan kekunci Tab untuk menjalankan dan memaparkan menu konteks.

Menu konteks menyertakan cadangan daripada JupyterLab selain cadangan yang dibuat oleh Pembantu Kod Qiskit. Menu konteks juga membersihkan dan memangkas cadangan, menjadikannya kurang berguna untuk menyemak cadangan kod sebelum menyisipkannya.

Nyahpasang sambungan JupyterLab

Untuk mengalih keluar sambungan Pembantu Kod Qiskit daripada JupyterLab, jalankan:

pip uninstall qiskit_code_assistant_jupyterlab

Penyelesaian masalah

Jika anda melihat sambungan frontend tetapi ia tidak berfungsi, semak bahawa sambungan pelayan telah didayakan:

jupyter server extension list

Jika sambungan pelayan telah dipasang dan didayakan, tetapi anda tidak melihat sambungan frontend, semak bahawa sambungan frontend telah dipasang:

jupyter labextension list

Sumbang kepada sambungan JupyterLab

Kod untuk sambungan ini tersedia secara awam dan sumber terbuka. Semak di GitHub.

Langkah seterusnya

Cadangan

Lihat contoh untuk menggunakan Pembantu Kod Qiskit untuk Circuit, mengkonfigurasi penindasan ralat, dan transpilasi dengan pengurus laluan.