Organizar y buscar por etiquetas de trabajo

Versiones de paquetes

El código de esta página se desarrolló utilizando los siguientes requisitos. Recomendamos usar estas versiones o más recientes.

qiskit[all]~=2.3.0
qiskit-ibm-runtime~=0.43.1

Esta guía se enfoca en cómo añadir y actualizar etiquetas de trabajo, así como en cómo buscar por etiquetas de trabajo, para que puedas organizar, rastrear y entender mejor tus experimentos.

Asignar etiquetas

Puedes asignar una o más etiquetas a tus trabajos cuando los ejecutes para poder filtrar por una etiqueta más tarde. Es posible que desees usar etiquetas de trabajo para etiquetar configuraciones particulares de mitigación de errores, parámetros de circuito, etc.

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

Añadir y actualizar etiquetas

Puedes añadir etiquetas después de enviar un trabajo con el método update_tags(). Este método sobrescribe las etiquetas actuales, por lo que si ya has asignado etiquetas a un trabajo y deseas añadir etiquetas adicionales, asegúrate de reasignar las etiquetas originales.

# 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 trabajos por etiqueta

Muestra una lista de trabajos con ciertas etiquetas de la siguiente manera:

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