تنظيم التجارب والبحث فيها باستخدام وسوم الوظائف

Package versions

الكود الموجود في هذه الصفحة طُوِّر باستخدام المتطلبات التالية. نوصي باستخدام هذه الإصدارات أو ما هو أحدث منها.

qiskit[all]~=2.3.1
qiskit-ibm-runtime~=0.45.1

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

تعيين الوسوم

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

# Added by doQumentation — required packages for this notebook
!pip install -q qiskit qiskit-ibm-runtime

from qiskit_ibm_runtime import QiskitRuntimeService, Sampler
from qiskit import QuantumCircuit
from qiskit.transpiler import generate_preset_pass_manager

service = QiskitRuntimeService()
backend = service.least_busy(simulator=False, operational=True)

qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)
qc.measure_all()

sampler = Sampler(backend)

pm = generate_preset_pass_manager(backend=backend, optimization_level=1)
isa_circuit = pm.run(qc)

# Assign tags before executing
sampler.options.environment.job_tags = ["experiment-2025", "sampler-example"]

# Submit
job = sampler.run([isa_circuit])

print(service.job(job.job_id()).tags)

['experiment-2025', 'sampler-example']

إضافة الوسوم وتحديثها

يمكنك إضافة وسوم بعد إرسال وظيفة باستخدام التابع update_tags(). يقوم هذا التابع بالكتابة فوق الوسوم الحالية، لذا إن كنت قد عيّنت وسوماً لوظيفة مسبقاً وأردت إضافة وسوم إضافية، احرص على إعادة تعيين الوسوم الأصلية أيضاً.

# Add a new tag while keeping the previously assigned tags
job.update_tags(["experiment-2025", "sampler-example", "127-qubit"])

# Confirm updated tags
print(job.tags)

['sampler-example', '127-qubit', 'experiment-2025']

استرجاع الوظائف بحسب الوسم

عرض قائمة بالوظائف التي تحمل وسوماً معينة كما يلي:

# List jobs with a specific tag or set of tags

service.jobs(job_tags=["experiment-2025", "sampler-example"])

[<RuntimeJobV2('d76cmj5bjrds73edf2og', 'sampler')>,
 <RuntimeJobV2('d6r5u84u243c73a11mug', 'sampler')>,
 <RuntimeJobV2('d6hugq2thhns7392lovg', 'sampler')>,
 <RuntimeJobV2('d68n7qtbujdc73d1b3vg', 'sampler')>,
 <RuntimeJobV2('d674nppv6o8c73d514fg', 'sampler')>,
 <RuntimeJobV2('d61mt5bc4tus73fcf3ng', 'sampler')>,
 <RuntimeJobV2('d61lhfqo8gvs73f15d30', 'sampler')>,
 <RuntimeJobV2('d5vftt1mvbjc73acdgpg', 'sampler')>,
 <RuntimeJobV2('d5k96nv853es738djj30', 'sampler')>,
 <RuntimeJobV2('d5b1s2rht8fs73a66r80', 'sampler')>]