Organizar e pesquisar por tags de job

Package versions

O código nesta página foi desenvolvido usando os seguintes requisitos. Recomendamos usar estas versões ou mais recentes.

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

Este guia foca em como adicionar e atualizar tags de job, bem como em como pesquisar por tags de job, para que você possa organizar, rastrear e compreender melhor seus experimentos.

Atribuir tags

Você pode atribuir uma ou mais tags aos seus jobs ao executá-los para filtrar por uma tag posteriormente. Pode ser útil usar tags de job para rotular configurações específicas de mitigação de erros, parâmetros de Circuit e assim por diante.

# 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']

Adicionar e atualizar tags

Você pode adicionar tags após submeter um job usando o método update_tags(). Esse método sobrescreve as tags atuais, portanto, se você já atribuiu tags a um job e deseja adicionar tags adicionais, certifique-se de reatribuir as tags originais.

# 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']

Recuperar jobs por tag

Exiba uma lista de jobs com determinadas tags da seguinte forma:

# 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')>]