{ "cells": [ { "cell_type": "markdown", "id": "38b90986-2529-4974-9dbd-931f3089b7fa", "metadata": {}, "source": [ "---\n", "title: \"Modalità di esecuzione tramite API REST\"\n", "description: \"Come eseguire un processo di calcolo quantistico in una sessione di Compute Service di IBM Quantum.\"\n", "---\n", "\n", "\n", "\n", "# Modalità di esecuzione tramite API REST\n", "\n" ] }, { "cell_type": "markdown", "id": "d501206a-c250-4df7-befc-317678659d32", "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", " Versioni del pacchetto\n", "\n", " Il codice presente in questa pagina è stato sviluppato sulla base dei seguenti requisiti.\n", " Si consiglia di utilizzare queste versioni o quelle più recenti.\n", "\n", " ```\n", " qiskit[all]~=2.3.0\n", " ```\n", "
\n", "\n" ] }, { "cell_type": "markdown", "id": "2153584e-5711-4168-a4a5-0b94d02dd3e7", "metadata": {}, "source": [ "È possibile eseguire i carichi di lavoro primitivi di IBM Quantum utilizzando le API REST in una delle tre modalità di esecuzione disponibili, a seconda delle proprie esigenze: job, sessione e batch. In questa sezione vengono illustrate tali modalità.\n", "\n", "\n", " La presente documentazione utilizza il modulo `requests` Python per illustrare l'API REST del servizio IBM Quantum Compute. Tuttavia, questo flusso di lavoro può essere eseguito utilizzando qualsiasi linguaggio o framework che supporti l'utilizzo delle API REST. Per ulteriori dettagli, consultare la [documentazione di riferimento dell'API](/docs/api/qiskit-runtime-rest).\n", "\n", "\n", "\n", "\n", "## Modalità di lavoro con API REST\n", "\n", "In modalità job, viene inviata una singola richiesta primitiva a Estimator o Sampler senza un gestore di contesto. Per alcuni esempi, scopri come eseguire un circuito quantistico utilizzando [Estimator](/docs/guides/estimator-rest-api) e [Sampler](/docs/guides/sampler-rest-api).\n", "\n", "\n", "\n", "## Modalità sessione con API REST\n", "\n", "Una sessione è una funzionalità che consente di eseguire in modo efficiente carichi di lavoro iterativi con più processi sui computer quantistici. L'uso delle sessioni consente di evitare i ritardi causati dall'accodamento separato di ogni singolo processo, il che può rivelarsi particolarmente utile per le attività iterative che richiedono una comunicazione frequente tra risorse classiche e quantistiche. Maggiori dettagli sulle sessioni sono disponibili nella [documentazione](/docs/guides/execution-modes).\n", "\n", "\n", " Gli utenti di Open Plan non possono inviare lavori di sessione.\n", "\n", "\n", "\n", "\n", "### Avvia una sessione\n", "\n", "Si inizia creando una sessione e ottenendo un ID di sessione.\n", "\n", "```python\n", "import json\n", "import requests\n", "\n", "sessionsUrl = \"https://quantum.cloud.ibm.com/api/v1/sessions\"\n", "auth_id = \"Bearer \"\n", "backend = \"\"\n", "crn = \"\"\n", "\n", "headersList = {\n", " \"Accept\": \"application/json\",\n", " \"Content-Type\": \"application/json\",\n", " \"Authorization\": auth_id,\n", " \"Service-CRN\": crn\n", "}\n", "\n", "payload = json.dumps({\n", " \"backend\": backend,\n", " \"mode\": 'dedicated',\n", "})\n", "\n", "response = requests.request(\"POST\", sessionsUrl, data=payload, headers=headersList)\n", "\n", "sessionId = response.json()['id']\n", "\n", "print(response.json())\n", "```\n", "\n", "Emissione\n", "\n", "```text\n", "{'id': 'crw9s7cdbt40008jxesg'}\n", "```\n", "\n", "\n", "\n", "### Chiudi una sessione\n", "\n", "È buona norma chiudere il sito `Session` quando tutti i lavori sono stati completati. Questo ridurrà i tempi di attesa per gli utenti successivi.\n", "\n", "```python\n", "closureURL=\"https://quantum.cloud.ibm.com/api/v1/sessions/\"+sessionId+\"/close\"\n", "\n", "headersList = {\n", " \"Accept\": \"application/json\",\n", " \"Authorization\": auth_id,\n", " \"Service-CRN\": crn\n", "}\n", "\n", "closure_response = requests.request(\n", " \"DELETE\",\n", " closureURL,\n", " headers=headersList\n", " )\n", "\n", "print(\"Session closure response ok?:\",closure_response.ok,closure_response.text)\n", "```\n", "\n", "Emissione\n", "\n", "```text\n", "Session closure response ok?: True\n", "```\n", "\n", "\n", "\n", "## Modalità batch con API REST\n", "\n", "In alternativa, è possibile inviare un processo batch specificando il `mode` nel payload della richiesta. La modalità batch può contribuire a ridurre i tempi di elaborazione se tutti i lavori vengono forniti all'inizio. Scopri la modalità batch nella guida [introduttiva alle modalità di esecuzione](/docs/guides/execution-modes#batch-mode).\n", "\n", "```python\n", "import json\n", "import requests\n", "\n", "sessionsUrl = \"https://quantum.cloud.ibm.com/api/v1/sessions\"\n", "\n", "headersList = {\n", " \"Accept\": \"application/json\",\n", " \"Authorization\": auth_id,\n", " \"Service-CRN\": crn,\n", " 'Content-Type': 'application/json'\n", "}\n", "\n", "payload = json.dumps({\n", " \"backend\": backend,\n", " \"instance\": \"hub1/group1/project1\",\n", " \"mode\": \"batch\"\n", "})\n", "\n", "response = requests.request(\"POST\", sessionsUrl, data=payload, headers=headersList)\n", "\n", "sessionId = response.json()['id']\n", "```\n", "\n", "\n", "\n", "## Esempi di lavori inviati in una sessione\n", "\n", "Una volta impostata una sessione, è possibile inviare uno o più lavori di Sampler o Estimator alla stessa sessione specificando l'ID della sessione.\n", "\n", "\n", " `` in un `PUB` può essere un singolo parametro o un elenco di parametri. Supporta anche la trasmissione su `numpy` .\n", "\n", "\n", "\n", "\n", "### Lavori di stima in modalità sessione\n", "\n", "\n", " \n", " ```python\n", " job_input = {\n", " 'program_id': 'estimator',\n", " \"backend\": backend,\n", " \"session_id\": sessionId, # This specifies the previously created Session\n", " \"params\": {\n", " \"pubs\": [[resulting_qasm, [obs1, obs2, obs3, obs4]]], #primitive unified blocs (PUBs) containing one circuit each.\n", " \"options\":{\n", " \"transpilation\":{\"optimization_level\": 1},\n", " \"twirling\": {\"enable_gates\": True,\"enable_measure\": True},\n", " # \"dynamical_decoupling\": {\"enable\": True, \"sequence_type\": \"XpXm\"}, #(optional)\n", " },\n", " }\n", "\n", " }\n", " ```\n", " \n", "\n", " \n", " ```python\n", " job_input = {\n", " 'program_id': 'estimator',\n", " \"backend\": backend,\n", " \"session_id\": sessionId, # This specifies the previously created Session\n", " \"params\": {\n", " \"pubs\": [[resulting_qasm, [[obs1], [obs2], [obs3], [obs4]], [[vals1], [vals2]]]], #primitive unified blocs (PUBs) containing one circuit each\n", " \"options\":{\n", " \"transpilation\":{\"optimization_level\": 1},\n", " \"twirling\": {\"enable_gates\": True,\"enable_measure\": True},\n", " # \"dynamical_decoupling\": {\"enable\": True, \"sequence_type\": \"XpXm\"}, #(optional)\n", " },\n", " }\n", " }\n", " ```\n", " \n", "\n", " \n", " ```python\n", " job_input = {\n", " 'program_id': 'estimator',\n", " \"backend\": backend,\n", " \"session_id\": sessionId, # This specifies the previously created Session\n", " \"params\": {\n", " \"pubs\": [[resulting_qasm, obs1],[resulting_qasm, obs2]], #primitive unified blocs (PUBs) containing one circuit each\n", " \"options\":{\n", " \"transpilation\":{\"optimization_level\": 1},\n", " \"twirling\": {\"enable_gates\": True,\"enable_measure\": True},\n", " # \"dynamical_decoupling\": {\"enable\": True, \"sequence_type\": \"XpXm\"}, #(optional)\n", " },\n", " }\n", " }\n", " ```\n", " \n", "\n", "\n", "\n", "\n", "### Lavori di campionamento in modalità sessione\n", "\n", "\n", " \n", " ```python\n", " job_input = {\n", " 'program_id': 'sampler',\n", " \"backend\": backend,\n", " \"session_id\": sessionId, # This specifies the previously created Session\n", " \"params\": {\n", " \"pubs\": [[resulting_qasm]], #primitive unified blocs (PUBs) containing one circuit each\n", " \"options\":{\n", " \"transpilation\":{\"optimization_level\": 1},\n", " \"twirling\": {\"enable_gates\": True,\"enable_measure\": True},\n", " # \"dynamical_decoupling\": {\"enable\": True, \"sequence_type\": \"XpXm\"}, #(optional)\n", " },\n", " }\n", "\n", " }\n", " ```\n", " \n", "\n", " \n", " ```python\n", " job_input = {\n", " 'program_id': 'sampler',\n", " \"backend\": backend,\n", " \"session_id\": sessionId, # This specifies the previously created Session\n", " \"params\": {\n", " \"pubs\": [[resulting_qasm, [vals1, vals2, vals3]]], #primitive unified blocs (PUBs) containing one circuit each\n", " \"options\":{\n", " \"transpilation\":{\"optimization_level\": 1},\n", " \"twirling\": {\"enable_gates\": True,\"enable_measure\": True},\n", " # \"dynamical_decoupling\": {\"enable\": True, \"sequence_type\": \"XpXm\"}, #(optional)\n", " },\n", " }\n", " }\n", " ```\n", " \n", "\n", " \n", " ```python\n", " job_input = {\n", " 'program_id': 'sampler',\n", " \"backend\": backend,\n", " \"session_id\": sessionId, # This specifies the previously created Session\n", " \"params\": {\n", " \"pubs\": [[resulting_qasm, [val1]],[resulting_qasm,None,100]], #primitive unified blocs (PUBs) containing one circuit each\n", " \"options\":{\n", " \"transpilation\":{\"optimization_level\": 1},\n", " \"twirling\": {\"enable_gates\": True,\"enable_measure\": True},\n", " # \"dynamical_decoupling\": {\"enable\": True, \"sequence_type\": \"XpXm\"}, #(optional)\n", " },\n", " }\n", " }\n", " ```\n", " \n", "\n", "\n", "\n", "\n", "## Passi successivi\n", "\n", "\n", " * Esamina gli esempi dettagliati delle primitive [Sampler](/docs/guides/sampler-rest-api) utilizzando l'API REST.\n", " * Esamina gli esempi dettagliati delle primitive [di Estimator](/docs/guides/estimator-rest-api) utilizzando l'API REST.\n", " * Esercitatevi con le primitive lavorando alla [lezione sulla funzione Costo](/learning/courses/variational-algorithm-design/cost-functions) in IBM Quantum® Learning.\n", " * Scopri come eseguire la transpilazione in locale nella sezione \" [Transpilazione](/docs/guides/transpile) \".\n", "\n", "\n" ] }, { "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 }