התקנה

דרישות מוקדמות

• Managed workflows מופעלים ב-מופעי IBM Quantum® Platform שלך. פנה למנהל המערכת שלך כדי להפעיל אותם.

• מפתח API וה-CRN של המופע שלך. ראו מציאת פרטי הגישה שלך.

• Python 3.10 ומעלה, בסביבה וירטואלית פעילה. ראו התקנת Qiskit להנחיות להגדרת סביבה.

התחלה מהירה עם AI skills

אפשר להשתמש ב-AI skills שב-מאגר תבניות Qiskit Function כדי לעזור לך להתקין את qiskit-ibm-catalog, לארוז את הקוד המקומי הקיים שלך ולפרוס אותו כ-managed workflow.

התקנת חבילת הלקוח

התקן את החבילה qiskit-ibm-catalog:

pip install qiskit-ibm-catalog

הפקודה הזו מתקינה גם את qiskit-serverless, את qiskit ואת qiskit-ibm-runtime כתלויות. אין צורך להתקין את qiskit-serverless בנפרד. הדוגמאות במדריכים אלה דורשות qiskit-ibm-catalog בגרסה 0.22.0 ומעלה, שמתקינה את qiskit-serverless 0.38 ואת qiskit-ibm-runtime 0.51.

אתה משתמש ישירות בשתיים מהחבילות האלה, במקומות שונים:

• qiskit-ibm-catalog הוא הלקוח שבו אתה משתמש במחשב המקומי שלך כדי להעלות workflows, להריץ אותם ולקבל את התוצאות שלהם.

• qiskit-serverless רץ בתוך קוד ה-workflow שלך. הוא מספק פונקציות עזר כגון get_arguments(), update_status() ו-save_result().

עדכון חבילת הלקוח

מכיוון ש-managed workflows נמצא בגרסת בטא, חבילת הלקוח משתנה לעיתים קרובות. כדי לבדוק איזו גרסה יש לך, הרץ את הפקודה הבאה:

pip show qiskit-ibm-catalog

Or, in Python:

import qiskit_ibm_catalog

print(qiskit_ibm_catalog.__version__)

כדי לעדכן לגרסה האחרונה, הרץ את הפקודה הבאה:

pip install --upgrade qiskit-ibm-catalog

אם הגרסה החדשה של qiskit-ibm-catalog דורשת גרסה חדשה יותר של qiskit-serverless, הפקודה הזו מעדכנת גם את qiskit-serverless.

אימות

הגן על מפתח ה-API שלך

אל תכלול את מפתח ה-API שלך בקוד ה-workflow, בסקריפטים או בקובצי מחברת. workflow רץ משתמש בפרטי הכניסה ובמופע ששימשו אותך לקריאה ל-run().

הלקוח של managed workflows משתמש באותם פרטי כניסה כמו qiskit-ibm-runtime. אם כבר שמרת חשבון באמצעות QiskitRuntimeService.save_account(), הלקוח טוען את חשבון ברירת המחדל השמור שלך, ואפשר לדלג אל אימות ההגדרה שלך.

אם לא שמרת חשבון, שמור את מפתח ה-API ואת ה-CRN של המופע שלך פעם אחת בסביבה מהימנה:

from qiskit_ibm_catalog import ManagedWorkflowClient

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

השיטה הזו כותבת את פרטי הכניסה שלך לאותו קובץ כמו QiskitRuntimeService.save_account(). הלקוח משתמש בערוץ ibm_quantum_platform כברירת מחדל, כך שאין צורך להגדיר channel. כדי לשמור יותר מחשבון אחד, הגדר name, והעבר את אותו name כשאתה יוצר את הלקוח.

לאפשרויות נוספות, כגון שמירת כמה חשבונות או בחירת מופע אוטומטית, ראו שמירת פרטי הכניסה שלך. אם אתה עובד על מחשב ציבורי או בסביבה לא מהימנה אחרת, אל תשמור את פרטי הכניסה שלך. במקום זאת, עקוב אחר אתחול השירות בסביבה לא מהימנה.

אימות ההגדרה שלך

התחבר ל-managed workflows עם החשבון השמור שלך, והצג את רשימת ה-workflows שהעלית:

from qiskit_ibm_catalog import ManagedWorkflowClient

client = ManagedWorkflowClient()
client.list()

אם עוד לא העלית workflow, הפלט הוא רשימה ריקה ([]). אם אתה רואה שגיאת אימות, הלקוח לא מצא פרטי כניסה תקפים. בדוק את החשבון ששמרת בסעיף אימות.

השלבים הבאים

המלצות

• פרוס את ה-workflow המנוהל הראשון שלך כדי להעלות workflow, להריץ אותו ולקבל את התוצאה שלו.
• כדי להתחיל מקוד עובד, פרוס אחת מתבניות Qiskit Function, או התאם תבנית בסיס ל-workflow שלך.