التثبيت

المتطلبات الأساسية

• تفعيل سير العمل المُدارة على نُسخ IBM Quantum® Platform الخاصة بك. تواصل مع المسؤول لديك لتفعيلها.

• مفتاح API وCRN الخاص بنسختك. راجع العثور على بيانات الوصول الخاصة بك.

• Python 3.10 أو أحدث، في بيئة افتراضية نشطة. راجع تثبيت Qiskit لمعرفة كيفية إعداد بيئة.

بداية سريعة مع مهارات الذكاء الاصطناعي

يمكنك استخدام مهارات الذكاء الاصطناعي في مستودع قوالب دالة Qiskit لمساعدتك في تثبيت qiskit-ibm-catalog، وتحزيم كودك المحلي الحالي، ونشره كسير عمل مُدار.

تثبيت حزمة العميل

ثبّت حزمة 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 هو العميل الذي تستخدمه على حاسوبك المحلي لرفع سير العمل وتشغيله والحصول على نتائجه.

• يعمل qiskit-serverless داخل كود سير العمل الخاص بك. يوفر دوال مساعدة مثل get_arguments() وupdate_status() وsave_result().

تحديث حزمة العميل

لأن سير العمل المُدارة في مرحلة تجريبية (beta)، تتغير حزمة العميل كثيرًا. للتحقق من الإصدار لديك، شغّل الأمر التالي:

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 الخاص بك في كود سير العمل أو في السكربتات أو في ملفات الدفاتر. يستخدم سير العمل قيد التشغيل بيانات الاعتماد والنسخة اللتين استخدمتهما لاستدعاء run().

يستخدم عميل سير العمل المُدارة بيانات الاعتماد نفسها التي يستخدمها 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 نفسه عند إنشاء العميل.

لمزيد من الخيارات، مثل حفظ عدة حسابات أو اختيار نسخة تلقائيًا، راجع حفظ بيانات تسجيل الدخول الخاصة بك. إذا كنت تعمل على حاسوب عام أو بيئة أخرى غير موثوقة، فلا تحفظ بيانات اعتمادك. بدلًا من ذلك، اتبع تهيئة الخدمة في بيئة غير موثوقة.

تحقق من إعدادك

اتصل بسير العمل المُدارة باستخدام حسابك المحفوظ، واعرض سير العمل الذي رفعته:

from qiskit_ibm_catalog import ManagedWorkflowClient

client = ManagedWorkflowClient()
client.list()

إذا لم ترفع سير عمل بعد، فالمخرج قائمة فارغة ([]). إذا ظهر لك خطأ مصادقة، فهذا يعني أن العميل لم يجد بيانات اعتماد صالحة. تحقق من الحساب الذي حفظته في قسم المصادقة.

الخطوات التالية

توصيات

• انشر أول سير عمل مُدار لك لرفع سير عمل وتشغيله والحصول على نتيجته.
• للبدء من كود جاهز، انشر أحد قوالب Qiskit Function، أو عدِّل قالبًا أساسيًا ليناسب سير عملك.