{ "cells": [ { "cell_type": "markdown", "id": "6ec2a7ce-6d72-401c-aecd-59f2f519153a", "metadata": {}, "source": [ "---\n", "title: \"Execute sua primeira carga de trabalho do Qiskit Serverless remotamente\"\n", "description: \"Como listar os programas disponíveis no Serverless, passar entradas para esses programas, executá-los remotamente, verificar o status e recuperar resultados e registros.\"\n", "---\n", "\n", "\n", "\n", "# Execute sua primeira carga de trabalho do Qiskit Serverless remotamente\n", "\n" ] }, { "cell_type": "markdown", "id": "1ffb4bbc-6702-4424-bc38-226eb3194a07", "metadata": { "tags": [ "version-info" ] }, "source": [ "\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]~=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á recebendo uma atualização e seus recursos estão mudando rapidamente.** Durante esta fase de desenvolvimento, encontre notas de lançamento e a documentação mais recente na página [Qiskit ServerlessGitHub](https://qiskit.github.io/qiskit-serverless/index.html).\n", "\n", "\n", "Esta seção explora como usar o site `qiskit-ibm-catalog` para listar os programas disponíveis no Qiskit Serverless, passar entradas para esses programas, executá-los remotamente, verificar seu status e recuperar resultados e registros.\n", "\n", "Certifique-se de ter seguido o fluxo de trabalho descrito em [“Escreva seu primeiro programa em Qiskit Serverless ”](/docs/guides/serverless-first-program) antes de começar.\n", "\n" ] }, { "cell_type": "markdown", "id": "ec693d85-baaf-487e-aaff-3867512a4790", "metadata": {}, "source": [ "\n", "\n", "## Lista de programas disponíveis\n", "\n", "Você pode usar `QiskitServerless.list()` para obter uma lista dos programas disponíveis para execução com o `Qiskit Serverless`. Isso inclui o arquivo [`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", "## Execute um programa carregado e passe as entradas\n", "\n", "Primeiro, configure suas entradas. Seu programa tem três entradas: `circuits`, `backend`, e `optimization_level`. Você pode usar o site `random_circuit` para criar 30 circuitos aleatórios:\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": [ "Em seguida, use `QiskitRuntimeService` e `least_busy` para selecionar um `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": [ "Defina seu nível de otimização:\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": [ "Selecione seu programa com `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": [ "Em seguida, passe suas entradas e execute-o de forma pitônica da seguinte forma:\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", "## Verificar o status do trabalho\n", "\n", "Com o Qiskit Serverless `job_id`, você pode verificar o status dos trabalhos em execução. Isso inclui os seguintes status:\n", "\n", "* **`QUEUED`**: O programa remoto está na fila do Qiskit Serverless. Atualmente, a prioridade da fila é baseada no quanto você usou o Qiskit Serverless\n", "* **`INITIALIZING`**: O programa remoto está sendo iniciado; isso inclui a configuração do ambiente remoto e a instalação de dependências\n", "* **`RUNNING`**: O programa está em execução. Nesse estágio, se você tiver saídas `print()` em seu programa, poderá recuperar os registros usando `job.logs()`\n", "* **`DONE`**: O programa está concluído e você pode recuperar os dados armazenados em `save_result()` com `job.results()`\n", "\n", "Você também pode definir status de trabalho mais detalhados em [Gerenciar recursos de dados e computação do Qiskit Serverless](/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", " Atualmente, a tabela de cargas de trabalho do IBM Quantum reflete apenas as cargas de trabalho do Qiskit Runtime. Use `job.status()` para ver o status atual de sua carga de trabalho do Qiskit Serverless.\n", "\n", "\n", "Você executou com sucesso seu primeiro programa Qiskit Serverless!\n", "\n" ] }, { "cell_type": "markdown", "id": "65566f2c-8d5b-4493-819b-4389155c3d69", "metadata": {}, "source": [ "\n", "\n", "## Recuperar registros e resultados\n", "\n", "Conforme mencionado anteriormente, depois que um programa é `RUNNING`, você pode usar `job.logs()` para buscar registros criados a partir de saídas `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": [ "A qualquer momento, você também pode cancelar um trabalho:\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": [ "Quando um programa é `DONE`, você pode usar `job.results()` para buscar o resultado armazenado em `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", "## Listar tarefas executadas anteriormente com Qiskit Serverless\n", "\n", "Você pode usar `jobs()` para listar todos os trabalhos enviados ao 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óximas etapas\n", "\n", "\n", " * Explore [as ferramentas de computação e gerenciamento de dados](/docs/guides/serverless-manage-resources) disponíveis para o seu programa, incluindo paralelização.\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 }