{
"cells": [
{
"cell_type": "markdown",
"id": "ef283f37-0ad4-48c7-bb92-8a09baaae6e5",
"metadata": {},
"source": [
"---\n",
"title: \"Organize e pesquise por tags de trabalho\"\n",
"description: \"Atribua etiquetas de tarefa, adicione e atualize etiquetas e pesquise por etiqueta para organizar melhor seus experimentos.\"\n",
"---\n",
"\n",
"\n",
"\n",
"# Organize e pesquise por tags de trabalho\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "f4471d6b-dc12-486c-95de-22ac12e367d2",
"metadata": {
"tags": [
"version-info"
]
},
"source": [
"{/*\n",
" DO NOT EDIT THIS CELL!!!\n",
" This cell's content is generated automatically by a script. Anything you add\n",
" here will be removed next time the notebook is run. To add new content, create\n",
" a new cell before or after this one.\n",
" */}\n",
"\n",
"\n",
" \n",
" O código desta página foi desenvolvido usando os seguintes requisitos.\n",
" Recomendamos o uso dessas versões ou de versões mais recentes.\n",
"\n",
" ```\n",
" qiskit[all]~=2.3.1\n",
" qiskit-ibm-runtime~=0.45.1\n",
" ```\n",
" \n",
"\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "ec8277ad-1811-4318-8282-84d6d282bb17",
"metadata": {},
"source": [
"Este guia se concentra em como adicionar e atualizar tags de trabalho, bem como pesquisar por tags de trabalho, para que você possa organizar, acompanhar e entender melhor seus experimentos.\n",
"\n"
]
},
{
"cell_type": "markdown",
"id": "59e38320-db15-4566-b262-40d4fcf19b82",
"metadata": {},
"source": [
"\n",
"\n",
"## Designar tags\n",
"\n",
"Você pode atribuir uma ou mais tags aos seus trabalhos ao executá-los para que possa filtrar por uma tag posteriormente. Talvez você queira usar tags de trabalho para rotular configurações específicas de atenuação de erros, parâmetros de circuito e assim por diante.\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 1,
"id": "74a7a1ea-f2ae-4b8c-9499-af52840c2e74",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"['experiment-2025', 'sampler-example']\n"
]
}
],
"source": [
"from qiskit_ibm_runtime import QiskitRuntimeService, Sampler\n",
"from qiskit import QuantumCircuit\n",
"from qiskit.transpiler import generate_preset_pass_manager\n",
"\n",
"service = QiskitRuntimeService()\n",
"backend = service.least_busy(simulator=False, operational=True)\n",
"\n",
"qc = QuantumCircuit(2)\n",
"qc.h(0)\n",
"qc.cx(0, 1)\n",
"qc.measure_all()\n",
"\n",
"sampler = Sampler(backend)\n",
"\n",
"pm = generate_preset_pass_manager(backend=backend, optimization_level=1)\n",
"isa_circuit = pm.run(qc)\n",
"\n",
"# Assign tags before executing\n",
"sampler.options.environment.job_tags = [\"experiment-2025\", \"sampler-example\"]\n",
"\n",
"# Submit\n",
"job = sampler.run([isa_circuit])\n",
"\n",
"print(service.job(job.job_id()).tags)"
]
},
{
"cell_type": "markdown",
"id": "2b29f9da-3fca-4ffc-b4b2-6f0d130b5b23",
"metadata": {},
"source": [
"\n",
"\n",
"## Adicionar e atualizar etiquetas\n",
"\n",
"Você pode adicionar tags depois de enviar um trabalho com o método `update_tags()` . Esse método substitui as tags atuais, portanto, se você já tiver atribuído tags a um trabalho e quiser adicionar outras tags, não se esqueça de reatribuir as tags originais.\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 2,
"id": "205ceaf7-f79d-4452-b4b0-9688e39a4564",
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"['sampler-example', '127-qubit', 'experiment-2025']\n"
]
}
],
"source": [
"# Add a new tag while keeping the previously assigned tags\n",
"job.update_tags([\"experiment-2025\", \"sampler-example\", \"127-qubit\"])\n",
"\n",
"# Confirm updated tags\n",
"print(job.tags)"
]
},
{
"cell_type": "markdown",
"id": "9e2e8c4a-5fbb-4a15-ab75-ddb61e35b65e",
"metadata": {},
"source": [
"\n",
"\n",
"## Recuperar trabalhos por etiqueta\n",
"\n",
"Exibir uma lista de trabalhos com determinadas tags, como segue:\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 3,
"id": "b6db503e-46ef-406e-9420-ef73446df564",
"metadata": {},
"outputs": [
{
"data": {
"text/plain": [
"[,\n",
" ,\n",
" ,\n",
" ,\n",
" ,\n",
" ,\n",
" ,\n",
" ,\n",
" ,\n",
" ]"
]
},
"execution_count": 3,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# List jobs with a specific tag or set of tags\n",
"\n",
"service.jobs(job_tags=[\"experiment-2025\", \"sampler-example\"])"
]
},
{
"cell_type": "markdown",
"metadata": {},
"id": "a1b8767d",
"source": "© IBM Corp., 2017-2026"
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3"
}
},
"nbformat": 4,
"nbformat_minor": 4
}