{
  "cells": [
    {
      "cell_type": "markdown",
      "id": "ef283f37-0ad4-48c7-bb92-8a09baaae6e5",
      "metadata": {},
      "source": [
        "---\n",
        "title: \"Organizza e cerca per tag di lavoro\"\n",
        "description: \"Assegna tag ai lavori, aggiungi e aggiorna i tag ed effettua ricerche per tag per organizzare meglio i tuoi esperimenti.\"\n",
        "---\n",
        "\n",
        "<span id=\"organize-and-search-by-job-tags\" />\n",
        "\n",
        "# Organizza e cerca per tag di lavoro\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",
        "<Accordion>\n",
        "  <AccordionItem title=\"Versioni del pacchetto\">\n",
        "    Il codice di questa pagina è stato sviluppato in base ai seguenti requisiti.\n",
        "    Si consiglia di utilizzare queste versioni o versioni più recenti.\n",
        "\n",
        "    ```\n",
        "    qiskit[all]~=2.3.1\n",
        "    qiskit-ibm-runtime~=0.45.1\n",
        "    ```\n",
        "  </AccordionItem>\n",
        "</Accordion>\n",
        "\n"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "ec8277ad-1811-4318-8282-84d6d282bb17",
      "metadata": {},
      "source": [
        "Questa guida si concentra su come aggiungere e aggiornare i tag dei lavori e su come effettuare ricerche in base ai tag dei lavori, in modo da poter organizzare, monitorare e comprendere meglio i propri esperimenti.\n",
        "\n"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "59e38320-db15-4566-b262-40d4fcf19b82",
      "metadata": {},
      "source": [
        "<span id=\"assign-tags\" />\n",
        "\n",
        "## Assegna tag\n",
        "\n",
        "È possibile assegnare uno o più tag ai lavori quando vengono eseguiti, in modo da poterli filtrare in base a un tag in un secondo momento. È possibile utilizzare i tag di lavoro per etichettare particolari impostazioni di attenuazione degli errori, parametri del circuito e così via.\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": [
        "<span id=\"add-and-update-tags\" />\n",
        "\n",
        "## Aggiungi e aggiorna tag\n",
        "\n",
        "È possibile aggiungere tag dopo aver inviato un lavoro con il metodo `update_tags()` . Questo metodo sovrascrive i tag correnti, quindi se sono già stati assegnati dei tag a un lavoro e si desidera aggiungere altri tag, assicurarsi di riassegnare i tag originali.\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": [
        "<span id=\"retrieve-jobs-by-tag\" />\n",
        "\n",
        "## Recupera i lavori per tag\n",
        "\n",
        "Visualizza un elenco di lavori con determinati tag come segue:\n",
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 3,
      "id": "b6db503e-46ef-406e-9420-ef73446df564",
      "metadata": {},
      "outputs": [
        {
          "data": {
            "text/plain": [
              "[<RuntimeJobV2('d76cmj5bjrds73edf2og', 'sampler')>,\n",
              " <RuntimeJobV2('d6r5u84u243c73a11mug', 'sampler')>,\n",
              " <RuntimeJobV2('d6hugq2thhns7392lovg', 'sampler')>,\n",
              " <RuntimeJobV2('d68n7qtbujdc73d1b3vg', 'sampler')>,\n",
              " <RuntimeJobV2('d674nppv6o8c73d514fg', 'sampler')>,\n",
              " <RuntimeJobV2('d61mt5bc4tus73fcf3ng', 'sampler')>,\n",
              " <RuntimeJobV2('d61lhfqo8gvs73f15d30', 'sampler')>,\n",
              " <RuntimeJobV2('d5vftt1mvbjc73acdgpg', 'sampler')>,\n",
              " <RuntimeJobV2('d5k96nv853es738djj30', 'sampler')>,\n",
              " <RuntimeJobV2('d5b1s2rht8fs73a66r80', 'sampler')>]"
            ]
          },
          "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
}