Gamitin ang Qiskit Code Assistant sa JupyterLab

Alamin kung paano mag-install, gumamit, mag-configure, at mag-uninstall ng opisyal na Qiskit Code Assistant extension sa JupyterLab.

I-install ang JupyterLab extension

Para i-install ang JupyterLab extension, patakbuhin ang sumusunod na command mula sa terminal:

pip install qiskit-code-assistant-jupyterlab

Pagkatapos i-install ang extension, simulan ang JupyterLab:

jupyter lab

Awtomatikong naglo-load ang extension at makikita ito sa ibaba ng JupyterLab window. Tingnan ang JupyterLab documentation para sa tulong sa paggamit ng JupyterLab.

I-configure ang mga setting ng extension

Inirerekomenda na i-edit ang mga sumusunod na setting ng JupyterLab sa pamamagitan ng Settings -> Settings Editor:

• I-click ang Inline Completer, hanapin ang "Show widget" at piliin ang Always. Ibig sabihin nito, laging makikita ang inline completer widget para makapag-cycle at makapili ng completion item.

• I-click ang Code Completion at dagdagan ang value ng "Default timeout for a provider." sa 10000 o 10 segundo. Ang default na value ay 1 segundo, pero maaaring mas matagal pa ang Qiskit Code Assistant API bago makahanap ng suggestion. Ang setting na ito ay para lang sa standard context menu na tinatawag gamit ang Tab. Ang inline completer ay may default na 10 segundo.

Iba pang mga setting na maaaring baguhin:

• Maaaring baguhin ang mga keyboard shortcut mula sa Settings > Settings Editor > Keyboard Shortcuts.

• Maaaring baguhin ang IBM Quantum API token na gagamitin sa JupyterLab command palette. Para gawin ito, pindutin ang Alt + Shift + C, hanapin ang qiskit, piliin ang command na Qiskit Code Assistant: Set IBM Quantum API token, at i-paste ang iyong key.

• [Advanced] Para baguhin ang instance ng Qiskit Code Assistant service na gagamitin ng extension, i-edit ang setting na serviceUrl ng Qiskit Code Assistant.

• [Advanced] Maaaring baguhin ang mga keyboard shortcut sa pamamagitan ng paghahanap ng completer sa Keyboard Shortcuts settings (Settings -> Settings Editor -> Keyboard Shortcuts) at pagdaragdag ng mga bagong shortcut para sa mga kaugnay na command.

Magsimulang gamitin ang Qiskit Code Assistant extension para sa JupyterLab

Authentication at setup

Pagkatapos i-install ang extension, susubukan nitong i-authenticate ka. Sa default, sinusubukan ng package na mag-authenticate sa IBM Quantum services gamit ang nakatakdang API key, at ginagamit ang iyong key mula sa environment variable na QISKIT_IBM_TOKEN o mula sa file na ~/.qiskit/qiskit-ibm.json (sa ilalim ng seksyon na default-ibm-quantum). Kung kailangan mo ng tulong sa pag-configure ng iyong account, sundin ang mga tagubilin sa I-set up ang iyong IBM Cloud account.

Sa default, ginagamit ng extension ang modelong mistral-small-3.2-24b-qiskit, na makikita sa Model Picker sa ibabang status bar.

Sa unang beses na gagamitin ang modelong mistral-small-3.2-24b-qiskit, magbubukas ang isang window na naglilista ng ilang mahahalagang paghihigpit na dapat malaman mo kapag gumagamit ng modelo. I-click ang Accept para paganahin ang modelo para sa code generation.

Mag-generate ng code

Habang dine-develop ang iyong code gamit ang Qiskit, maaari kang humingi ng tulong sa Qiskit Code Assistant. Sa pangkalahatan, nagmumungkahi ang assistant ng mas magandang code bilang tugon sa mga Python comment o docstring, pero maaari mo itong gamitin kahit saan sa iyong file.

Para makakuha ng code suggestion, mag-type ng prompt, tapos pindutin ang Alt + . o Alt + \. May dalawang uri ng prompt na maaari mong gamitin:

• Mag-type ng partial code at kumuha ng suggestion para tapusin ang code. Halimbawa:

  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.

• Mag-type ng pound (#) sign, tapos i-type ang iyong prompt. Halimbawa: # Give me a random circuit of 5 qubits and a depth of 4.

Makipagtulungan sa mga code suggestion

Gamitin ang sumusunod para tanggapin, i-reject, at mag-cycle sa mga suggestion:

• Ang Alt + [ at Alt + ] ay maaaring gamitin para mag-cycle sa listahan ng mga suggestion (kung mayroon pang iba).
• Ang Alt + Tab o Alt + END ay tumatanggap ng iminungkahing code at inilalagay ito sa kasalukuyang lokasyon ng cursor.

Bukod dito, pagkatapos tumakbo ang assistant, maaari mong gamitin ang mga button sa widget para mag-cycle o tanggapin ang suggestion:

tala

Minsan ay ilang segundo bago makabalik ng suggestion ang serbisyo. Makikita mo kung nagtatrabaho ang serbisyo sa pamamagitan ng pagtingin sa status bar.

Kasama rin sa JupyterLab ang tradisyonal na suggestion context menu. Gamitin ang Tab key para patakbuhin at ipakita ang context menu.

Kasama sa context menu ang mga suggestion mula sa JupyterLab kasabay ng mga mungkahi ng Qiskit Code Assistant. Ini-sanitize at tini-trim din ng context menu ang mga suggestion, kaya mas limitado ang paggamit nito para suriin ang code suggestion bago i-insert.

I-uninstall ang JupyterLab extension

Para alisin ang Qiskit Code Assistant extension mula sa JupyterLab, patakbuhin ang:

pip uninstall qiskit_code_assistant_jupyterlab

Troubleshooting

Kung nakikita mo ang frontend extension pero hindi ito gumagana, i-check kung naka-enable ang server extension:

jupyter server extension list

Kung naka-install at naka-enable ang server extension, pero hindi mo nakikita ang frontend extension, i-check kung naka-install ang frontend extension:

jupyter labextension list

Mag-contribute sa JupyterLab extension

Ang code para sa extension na ito ay publicly available at open source. Tingnan ito sa GitHub.

Mga susunod na hakbang

Mga Rekomendasyon

Tingnan ang mga halimbawa ng paggamit ng Qiskit Code Assistant para sa mga circuit, pag-configure ng error suppression, at pag-transpile gamit ang mga pass manager.