{ "cells": [ { "cell_type": "markdown", "id": "6ec2a7ce-6d72-401c-aecd-59f2f519153a", "metadata": {}, "source": [ "---\n", "title: \"Ejecute su primera carga de trabajo de Qiskit Serverless de forma remota\"\n", "description: \"Cómo enumerar los programas disponibles en Serverless, pasar entradas a estos programas, ejecutarlos de forma remota, comprobar su estado y recuperar resultados y registros.\"\n", "---\n", "\n", "\n", "\n", "# Ejecute su primera carga de trabajo de Qiskit Serverless de forma remota\n", "\n" ] }, { "cell_type": "markdown", "id": "1ffb4bbc-6702-4424-bc38-226eb3194a07", "metadata": { "tags": [ "version-info" ] }, "source": [ "\n", " \n", " El código de esta página se ha desarrollado teniendo en cuenta los siguientes requisitos.\n", " Recomendamos utilizar estas versiones o versiones más recientes.\n", "\n", " ```\n", " qiskit[all]~=1.4.0\n", " qiskit-ibm-runtime~=0.36.1\n", " qiskit-ibm-catalog~=0.4\n", " ```\n", " \n", "\n", "\n" ] }, { "cell_type": "markdown", "id": "33bc7389-22b7-4ddd-ae7d-1c4fd603d793", "metadata": {}, "source": [ "\n", " **Qiskit Serverless está siendo actualizado y sus características están cambiando rápidamente.** Durante esta fase de desarrollo, encontrará las notas de la versión y la documentación más reciente en la página [« Qiskit Serverless » (Notas de la versión y documentación) de GitHub](https://qiskit.github.io/qiskit-serverless/index.html).\n", "\n", "\n", "Esta sección explora cómo usar `qiskit-ibm-catalog` para listar programas disponibles en Qiskit Serverless, pasar entradas a estos programas, ejecutarlos remotamente, comprobar su estado y recuperar resultados y registros.\n", "\n", "Asegúrate de haber seguido los pasos descritos en [«Escribe tu primer programa en Qiskit Serverless »](/docs/guides/serverless-first-program) antes de empezar.\n", "\n" ] }, { "cell_type": "markdown", "id": "ec693d85-baaf-487e-aaff-3867512a4790", "metadata": {}, "source": [ "\n", "\n", "## Lista de programas disponibles\n", "\n", "Puedes utilizar `QiskitServerless.list()` para obtener una lista de los programas disponibles que se pueden ejecutar con Qiskit Serverless. Esto incluye los archivos que se han subido anteriormente [`transpile_remote_serverless`](/docs/guides/serverless-first-program).\n", "\n" ] }, { "cell_type": "code", "execution_count": 1, "id": "4eaad0dc-9b42-48fa-ad08-4e0f9c4d90bc", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "QiskitFunction(transpile_remote_serverless)" ] }, "execution_count": 1, "metadata": {}, "output_type": "execute_result" } ], "source": [ "from qiskit_ibm_catalog import QiskitServerless\n", "\n", "serverless = QiskitServerless()\n", "next(\n", " program\n", " for program in serverless.list()\n", " if program.title == \"transpile_remote_serverless\"\n", ")" ] }, { "cell_type": "markdown", "id": "e1a5d0f7-e4d9-4289-ac87-ca25e76f968d", "metadata": {}, "source": [ "\n", "\n", "## Ejecuta un programa cargado y pasa entradas\n", "\n", "En primer lugar, configura tus entradas. Su programa tiene tres entradas: `circuits`, `backend`, y `optimization_level`. Puedes utilizar `random_circuit` para crear 30 circuitos aleatorios:\n", "\n" ] }, { "cell_type": "code", "execution_count": 2, "id": "46108a95-11f8-4ecf-83bb-131c3e7ea4c2", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "\"Output" ] }, "execution_count": 2, "metadata": {}, "output_type": "execute_result" } ], "source": [ "from qiskit.circuit.random import random_circuit\n", "\n", "qc_random = [(random_circuit(4, 4, measure=True, seed=i)) for i in range(10)]\n", "qc_random[0].draw(output=\"mpl\", idle_wires=False)" ] }, { "cell_type": "markdown", "id": "61c17ded-b832-4db1-ba9a-60772362daea", "metadata": {}, "source": [ "A continuación, utilice `QiskitRuntimeService` y `least_busy` para seleccionar un `backend`:\n", "\n" ] }, { "cell_type": "code", "execution_count": null, "id": "ebefb5ac-c8a8-4350-b16f-0677f0e412e5", "metadata": {}, "outputs": [], "source": [ "from qiskit_ibm_runtime import QiskitRuntimeService\n", "\n", "service = QiskitRuntimeService()\n", "backend = service.least_busy(operational=True, simulator=False)\n", "print(backend.name)" ] }, { "cell_type": "markdown", "id": "6a6ba35b-b98b-41b1-8dd4-c7cf2fc8b637", "metadata": {}, "source": [ "Establezca su nivel de optimización:\n", "\n" ] }, { "cell_type": "code", "execution_count": 4, "id": "cab2773b-f72a-49fe-a274-169a10e89c5e", "metadata": {}, "outputs": [], "source": [ "optimization_level = 3" ] }, { "cell_type": "markdown", "id": "f522b54f-93e5-45e9-9dc7-a2287eb4c707", "metadata": {}, "source": [ "Seleccione su programa con `serverless.load('PROGRAM_NAME')`:\n", "\n" ] }, { "cell_type": "code", "execution_count": 5, "id": "e9b7e7c1-07b1-4777-bb08-1522433901c6", "metadata": {}, "outputs": [], "source": [ "transpile_remote_serverless = serverless.load(\"transpile_remote_serverless\")" ] }, { "cell_type": "markdown", "id": "8e256a2a-6b14-4194-8fee-df986c7ebc6c", "metadata": {}, "source": [ "A continuación, pasa tus entradas y ejecútalo de forma pitónica de la siguiente manera:\n", "\n" ] }, { "cell_type": "code", "execution_count": 6, "id": "85b1aace-e7d7-4e2e-bb77-44fb514d0236", "metadata": {}, "outputs": [], "source": [ "job = transpile_remote_serverless.run(\n", " circuits=qc_random,\n", " backend=backend.name,\n", " optimization_level=optimization_level,\n", ")" ] }, { "cell_type": "code", "execution_count": 7, "id": "2e8b4ec2-b7e3-4218-8742-b67f2a1d82e0", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "'118256c5-bbb0-4ea8-9e9f-51aac2220aef'" ] }, "execution_count": 7, "metadata": {}, "output_type": "execute_result" } ], "source": [ "job.job_id" ] }, { "cell_type": "markdown", "id": "87dbb375-cd24-4d0f-a2fc-c653db8345e3", "metadata": {}, "source": [ "\n", "\n", "\n", "\n", "## Comprobar estado de trabajo\n", "\n", "Con tu Qiskit Serverless `job_id`, puedes comprobar el estado de los trabajos en ejecución. Esto incluye los siguientes estados:\n", "\n", "* **`QUEUED`**: El programa remoto está en la cola de Qiskit Serverless. La prioridad de la cola se basa actualmente en cuánto has usado Qiskit Serverless\n", "* **`INITIALIZING`**: El programa remoto se está iniciando; esto incluye la configuración del entorno remoto y la instalación de dependencias\n", "* **`RUNNING`**: El programa se está ejecutando. En esta etapa, si tiene salidas `print()` en su programa, puede recuperar los registros utilizando `job.logs()`\n", "* **`DONE`**: El programa ha finalizado y puede recuperar los datos almacenados en `save_result()` con `job.results()`\n", "\n", "También puede establecer estados de trabajo más detallados en [Administrar recursos de computación y datos sin servidor de Qiskit](/docs/guides/serverless-manage-resources).\n", "\n" ] }, { "cell_type": "code", "execution_count": 8, "id": "f4877d45-c350-4855-b1ca-868a6ad8cfa4", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "'QUEUED'" ] }, "execution_count": 8, "metadata": {}, "output_type": "execute_result" } ], "source": [ "job.status()" ] }, { "cell_type": "markdown", "id": "3fa9c01e-18a4-482c-bad6-69dee5acece4", "metadata": {}, "source": [ "\n", " Actualmente, la tabla IBM Quantum workloads sólo refleja las cargas de trabajo de Qiskit Runtime. Utilice `job.status()` para ver el estado actual de su carga de trabajo Qiskit Serverless.\n", "\n", "\n", "¡Has ejecutado con éxito tu primer programa Qiskit Serverless!\n", "\n" ] }, { "cell_type": "markdown", "id": "65566f2c-8d5b-4493-819b-4389155c3d69", "metadata": {}, "source": [ "\n", "\n", "## Recuperar registros y resultados\n", "\n", "Como ya se ha mencionado, una vez que un programa es `RUNNING`, puede utilizar `job.logs()` para recuperar los registros creados a partir de las salidas de `print()` :\n", "\n" ] }, { "cell_type": "code", "execution_count": 10, "id": "cbf12a1b-bfff-4eb2-82f1-298de1e9c114", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "No logs yet.\n" ] } ], "source": [ "logs = job.logs()\n", "print(logs)" ] }, { "cell_type": "markdown", "id": "bff87452-bf98-4c7a-85c8-d280d89a7970", "metadata": {}, "source": [ "También puedes cancelar un trabajo en cualquier momento:\n", "\n" ] }, { "cell_type": "code", "execution_count": 11, "id": "bc4fbe20-456c-4ce4-bf26-dfdb8b68e89f", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "'Job has been stopped.'" ] }, "execution_count": 11, "metadata": {}, "output_type": "execute_result" } ], "source": [ "job.stop()" ] }, { "cell_type": "markdown", "id": "925a8d81-e85b-4e26-a9e1-3a01e8e0785b", "metadata": {}, "source": [ "Una vez que un programa es `DONE`, puede utilizar `job.results()` para obtener el resultado almacenado en `save_result()`:\n", "\n" ] }, { "cell_type": "code", "execution_count": 12, "id": "c0d999d9-af9e-4312-b5bb-f60f714257ba", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "{'transpiled_circuits': [,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ]}" ] }, "execution_count": 12, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# We can't get results from a cancelled job, so we'll fetch a completed one instead\n", "completed_job = next(\n", " job for job in serverless.jobs() if job.status() == \"DONE\"\n", ")\n", "completed_job.result()" ] }, { "cell_type": "markdown", "id": "ca9791df-60c2-49d8-8541-741078ea63c6", "metadata": {}, "source": [ "\n", "\n", "## Enumera los trabajos ejecutados anteriormente con Qiskit Serverless\n", "\n", "Puedes usar `jobs()` para listar todos los trabajos enviados a Qiskit Serverless:\n", "\n" ] }, { "cell_type": "code", "execution_count": 13, "id": "ba9365c4-b07d-4dc6-9594-edc07c44bc63", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "[,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ,\n", " ]" ] }, "execution_count": 13, "metadata": {}, "output_type": "execute_result" } ], "source": [ "old_jobs = serverless.jobs()\n", "old_jobs" ] }, { "cell_type": "markdown", "id": "fd3415a0-0e55-4991-8764-c9fe66eb2664", "metadata": {}, "source": [ "\n", "\n", "## Próximos pasos\n", "\n", "\n", " * Explora [las herramientas de computación y gestión de datos](/docs/guides/serverless-manage-resources) disponibles para tu programa, incluida la paralelización.\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": 2 }