Organizar e pesquisar por tags de job

Versões dos pacotes

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

qiskit[all]~=2.3.0
qiskit-ibm-runtime~=0.43.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', 'experiment-2025', '127-qubit']

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('d5k96nv853es738djj30', 'sampler')>,
 <RuntimeJobV2('d5b1s2rht8fs73a66r80', 'sampler')>,
 <RuntimeJobV2('d4vr9uteastc73cii4n0', 'sampler')>,
 <RuntimeJobV2('d4mjv12v0j9c73e6dclg', 'sampler')>,
 <RuntimeJobV2('d4c2e8fnmdfs73aedgl0', 'sampler')>,
 <RuntimeJobV2('d42r485o35ts73c743g0', 'sampler')>,
 <RuntimeJobV2('d3nkieg3qtks738eg8t0', 'sampler')>,
 <RuntimeJobV2('d3ed8g1b641c738j6vdg', 'sampler')>,
 <RuntimeJobV2('d38q4qcda4cs73aa79v0', 'sampler')>,
 <RuntimeJobV2('d38q14g0sqis739a0ing', 'sampler')>]