שימוש ב-Qiskit Code Assistant ב-Visual Studio Code ועורכים תואמים

למד כיצד להתקין, להשתמש, להגדיר ולהסיר את התוסף הרשמי של Qiskit Code Assistant ב-Visual Studio Code (VS Code) ועורכים תואמים.

הערות

• זהו תכונה ניסיונית הזמינה למשתמשי IBM Quantum® Premium Plan עם חשבון בפלטפורמת IBM Quantum Platform החדשה.
• Qiskit Code Assistant נמצא בשלב גרסת תצוגה מקדימה וכפוף לשינויים.
• אם יש לך משוב או שתרצה לפנות לצוות המפתחים, השתמש בערוץ Qiskit Slack Workspace או במאגרי GitHub הציבוריים הרלוונטיים.

התקנת תוסף VS Code

להתקנת תוסף VS Code, בצע את השלבים הבאים:

התקנה ישירות מ-VS Code:

1. הפעל את VS Code.
2. לחץ על סמל Extensions בסרגל הכלים השמאלי.
3. חפש qiskit
4. מצא את "Qiskit Code Assistant (Beta)" ולחץ Install.

לחלופין, התוסף זמין גם דרך VS Code Marketplace.

התוסף מפורסם גם ב-Open VSX עבור משתמשי פורקים של VS Code כגון VSCodium, Cursor, IBM Bob, ואחרים.

התוסף נטען אוטומטית ומופיע בתחתית חלון VS Code. אם הוא אינו מופיע, טען מחדש את התוסף או היישום.

הגדרת הגדרות התוסף

ניתן להגדיר את ההגדרות הבאות:

• לשינוי קיצורי מקלדת, פתח את הגדרות קיצורי המקלדת (Cmd/Ctrl+Shift+P -> Preferences: Open Keyboard Shortcuts (JSON)) וחפש qiskit-vscode.

• ניתן לשנות את אסימון ה-API של IBM Quantum לשימוש בלוח הפקודות של VS Code. לשם כך, לחץ Cmd/Ctrl+Shift+P, חפש qiskit, בחר את הפקודה Qiskit Code Assistant: Set IBM Quantum API token, והדבק את אסימון ה-IBM Quantum API שלך.

• [מתקדם] לשינוי המופע של שירות Qiskit Code Assistant שהתוסף צריך להשתמש בו, עבור אל File -> Preferences -> Settings. בלשונית User, חפש Qiskit, וערוך את Qiskit Code Assistant: Url.

תחילת שימוש בתוסף Qiskit Code Assistant ל-VS Code

אימות והגדרה

לאחר התקנת התוסף, הוא מנסה לאמת אותך. כברירת מחדל, החבילה מנסה לאמת לשירותי IBM Quantum עם מפתח ה-API המוגדר, ומשתמשת במפתח שלך ממשתנה הסביבה QISKIT_IBM_TOKEN או מהקובץ ~/.qiskit/qiskit-ibm.json (תחת הסעיף default-ibm-quantum). אם אתה זקוק לעזרה בהגדרת החשבון שלך, עקוב אחר ההוראות בהגדרה לשימוש ב-IBM Cloud.

כברירת מחדל, התוסף משתמש במודל mistral-small-3.2-24b-qiskit, שמופיע ב-Model Picker בשורת הסטטוס בתחתית.

בפעם הראשונה שאתה משתמש במודל mistral-small-3.2-24b-qiskit, נפתחת חלון מודאלי המפרט מספר הגבלות עיקריות שעליך להיות מודע להן בעת השימוש במודל. לחץ Accept כדי לאפשר את המודל ליצירת קוד.

יצירת קוד

בזמן שאתה מפתח את הקוד שלך באמצעות Qiskit, ניתן לבקש מ-Qiskit Code Assistant לעזור לך. באופן כללי, העוזר מציע קוד טוב יותר בתגובה להערות Python או docstrings, אך ניתן להשתמש בעוזר בכל מקום בקובץ שלך.

כדי לקבל הצעת קוד, הקלד בקשה, ולאחר מכן לחץ Ctrl+.. ישנם שני סוגים של בקשות שניתן להשתמש בהן:

• הזן קוד חלקי וקבל הצעה להשלמת הקוד. לדוגמה:

  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.

• הקלד סימן פאונד (#), ולאחר מכן הקלד את הבקשה שלך. לדוגמה: # Give me a random circuit of 5 qubits and a depth of 4.

עבודה עם הצעות קוד

השתמש בפעולות הבאות כדי לקבל, לדחות ולעבור בין הצעות:

• לחץ Tab לקבלת ההצעה או לחץ ESC לדחייתה.
• לאחר קבלת הצעה, הקלד Ctrl + . שוב כדי לייצר הצעות נוספות.
• כאשר הצעה מוצגת, השתמש ב-Option/Alt + ] ו-Option/Alt + [ כדי לעבור קדימה ואחורה בהתאמה בין ההצעות (אם זמינות).
• רחף את הסמן מעל ההצעה כדי להשתמש בסרגל הכלים הקופץ לעבור בין ההצעות, כפי שמוצג:

הסרת תוסף VS Code

להסרת Qiskit Code Assistant מ-VS Code, בצע את השלבים הבאים:

1. הפעל את Visual Studio Code.
2. לחץ על סמל Extensions.
3. חפש qiskit ופתח את Qiskit Code Assistant.
4. לחץ Uninstall.

פתרון בעיות

אם אינך רואה את שורת הסטטוס של התוסף ב-VS Code, בדוק שהתוסף מותקן ומופעל תחת לשונית ה-extensions.

אם התוסף מותקן ומופעל, אך אינו מצליח לבחור מודל, ודא שמפתח ה-API הנוכחי שלך נוסף ושה-Qiskit Code Assistant: Url מוגדר כראוי.

תרומה לתוסף VS Code

הקוד של תוסף רשמי זה זמין לציבור ובקוד פתוח. עיין בו ב-GitHub.

הצעדים הבאים

המלצות

ראה דוגמאות לשימוש ב-Qiskit Code Assistant עבור מעגלים, הגדרת דיכוי שגיאות, וTranspiling עם pass managers.