{ "cells": [ { "cell_type": "markdown", "id": "cdc8dc1e-0cff-46c1-94d0-97456d278e27", "metadata": {}, "source": [ "---\n", "title: \"Escreva seu primeiro programa em Qiskit Serverless\"\n", "description: \"Como criar um programa de transpilagem paralelo e implantá-lo em IBM Quantum Platform para usar como um serviço remoto reutilizável.\"\n", "---\n", "\n", "{/* cspell:ignore mypath */}\n", "\n", "\n", "\n", "# Escreva seu primeiro programa em Qiskit Serverless\n", "\n" ] }, { "cell_type": "markdown", "id": "b6d632cb-d884-4963-9c8d-8f3a3acd8a7d", "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.3.1\n", " qiskit-ibm-runtime~=0.34.0\n", " qiskit-aer~=0.15.1\n", " qiskit-serverless~=0.18.1\n", " qiskit-ibm-catalog~=0.2\n", " qiskit-addon-sqd~=0.8.1\n", " qiskit-addon-utils~=0.1.0\n", " qiskit-addon-mpf~=0.2.0\n", " qiskit-addon-aqc-tensor~=0.1.2\n", " qiskit-addon-obp~=0.1.0\n", " scipy~=1.15.0\n", " pyscf~=2.8.0\n", " ```\n", " \n", "\n", "\n" ] }, { "cell_type": "markdown", "id": "1cc46aeb-aff6-4fab-9d78-69f2bfe98d98", "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", "Este exemplo demonstra como usar `qiskit-serverless` ferramentas para criar um programa de transpilagem paralela e, em seguida, implementá-lo `qiskit-ibm-catalog` para enviar seu programa para IBM Quantum Platform, a fim de utilizá-lo como um serviço remoto reutilizável.\n", "\n", "\n", "\n", "## Visão Geral do Fluxo de Trabalho\n", "\n", "1. Crie um diretório local e um arquivo de programa vazio (`./source_files/transpile_remote.py`)\n", "2. Adicione código ao seu programa que, quando enviado para Qiskit Serverless, irá transpilar um circuito\n", "3. Use `qiskit-ibm-catalog` para autenticar em Qiskit Serverless\n", "4. Envie o programa para Qiskit Serverless\n", "\n", "Depois de enviar seu programa, você pode executá-lo para transpilar o circuito seguindo o guia “[Execute remotamente sua primeira carga de trabalho do Qiskit Serverless](/docs/guides/serverless-run-first-workload) ”.\n", "\n" ] }, { "cell_type": "markdown", "id": "cad16f43-8548-4849-a4b8-09059a8b747c", "metadata": {}, "source": [ "\n", "\n", "## Exemplo: Transpilagem remota com Qiskit Serverless\n", "\n", "Este exemplo mostra como criar e adicionar conteúdo a um arquivo de programa que, quando enviado para Qiskit Serverless, irá transpilar um `circuit` em relação a um determinado `backend` e direcionar para `optimization_level`.\n", "\n", "\n", " O Qiskit Serverless requer a configuração dos arquivos `.py` da sua carga de trabalho em um diretório dedicado. A estrutura a seguir é um exemplo de boa prática:\n", "\n", " ```text\n", " serverless_program\n", " ├── program_uploader.ipynb\n", " └── source_files\n", " ├── transpile_remote.py\n", " └── *.py\n", " ```\n", "\n", "\n", "O Serverless carrega o conteúdo de um diretório específico (neste exemplo, o `source_files` diretório) para ser executado remotamente. Depois de configurá-los, você pode ajustá-los `transpile_remote.py` para obter entradas e retornar saídas.\n", "\n", "\n", "\n", "### Crie o diretório e um arquivo de programa vazio\n", "\n", "Primeiro, crie uma pasta chamada `source_files`, depois crie um arquivo de programa nessa pasta, de modo que seu caminho seja `./source_files/transpile_remote.py`. Este é o arquivo que você deverá enviar para Qiskit Serverless.\n", "\n" ] }, { "cell_type": "markdown", "id": "a9b3fb7d-abd6-4a3e-b9b1-b21202d8db6d", "metadata": {}, "source": [ "\n", "\n", "### Adicione código ao seu arquivo de programa\n", "\n", "Insira o código a seguir no seu arquivo de programa e salve-o.\n", "\n", "\n", " Se você estiver executando as células de código localmente em um notebook, verá o [comando ](https://ipython.readthedocs.io/en/stable/interactive/magics.html#cellmagic-writefile)`%%writefile` mágico. A execução de células com este comando especial as salva no disco, em vez de executá-las.\n", "\n", "\n" ] }, { "cell_type": "code", "execution_count": null, "id": "214eb803-d1fa-4ac0-b955-8b24717086f4", "metadata": {}, "outputs": [], "source": [ "# This cell is hidden from users, it creates a new folder\n", "from pathlib import Path\n", "\n", "Path(\"./source_files\").mkdir(exist_ok=True)" ] }, { "cell_type": "code", "execution_count": null, "id": "64722041-22ed-42bd-8d83-d8e9f5e5b55b", "metadata": { "editable": true, "slideshow": { "slide_type": "" }, "tags": [] }, "outputs": [], "source": [ "%%writefile ./source_files/transpile_remote.py\n", "# If you include the preceding `%%writefile` command (visible only when you read this\n", "# locally in a notebook), running this cell saves to disk rather than executing the code.\n", "\n", "from qiskit.transpiler import generate_preset_pass_manager\n", "\n", "def transpile_remote(circuit, optimization_level, backend):\n", " \"\"\"Transpiles an abstract circuit into an ISA circuit for a given backend.\"\"\"\n", " pass_manager = generate_preset_pass_manager(\n", " optimization_level=optimization_level,\n", "\t\tbackend=backend\n", " )\n", " isa_circuit = pass_manager.run(circuit)\n", " return isa_circuit" ] }, { "cell_type": "markdown", "id": "7e80b5bb-0f76-43d1-a68c-97b4b22cc88a", "metadata": {}, "source": [ "\n", "\n", "### Adicione código para obter os argumentos do programa\n", "\n", "Agora adicione o código a seguir ao seu arquivo de programa, que configura os argumentos do programa.\n", "\n", "Seu site inicial `transpile_remote.py` tem três entradas: `circuits`, `backend_name`, e `optimization_level`. Atualmente, o Serverless está limitado a aceitar apenas entradas e saídas serializáveis. Por esse motivo, você não pode passar o endereço `backend` diretamente, portanto, use `backend_name` como uma cadeia de caracteres.\n", "\n" ] }, { "cell_type": "code", "execution_count": null, "id": "6819379b-d7b2-4fda-9e6b-459eec748a79", "metadata": {}, "outputs": [], "source": [ "%%writefile --append ./source_files/transpile_remote.py\n", "# If you include the preceding `%%writefile` command (visible only when you read this\n", "# locally in a notebook), running this cell saves to disk rather than executing the code.\n", "\n", "from qiskit_serverless import get_arguments, save_result, distribute_task, get\n", "\n", "# Get program arguments\n", "arguments = get_arguments()\n", "circuits = arguments.get(\"circuits\")\n", "backend_name = arguments.get(\"backend_name\")\n", "optimization_level = arguments.get(\"optimization_level\")" ] }, { "cell_type": "markdown", "id": "5ae9fb12-f06f-4f7d-8f37-1d872285deab", "metadata": {}, "source": [ "\n", "\n", "### Adicione o código que chama o backend\n", "\n", "Adicione o seguinte código ao seu arquivo de programa, que chama seu backend com `QiskitRuntimeService`.\n", "\n", "O código a seguir pressupõe que você já seguiu o processo para salvar suas credenciais usando `QiskitRuntimeService.save_account`e carregará sua conta salva padrão, a menos que você especifique o contrário. Consulte [Salvar suas credenciais de login](/docs/guides/save-credentials) e [Inicializar sua conta de serviço Qiskit Runtime](/docs/guides/initialize-account) para obter mais informações.\n", "\n" ] }, { "cell_type": "code", "execution_count": null, "id": "4b0c7d24-9b87-4e00-bb1d-f82aa967cb1d", "metadata": {}, "outputs": [], "source": [ "%%writefile --append ./source_files/transpile_remote.py\n", "# If you include the preceding `%%writefile` command (visible only when you read this\n", "# locally in a notebook), running this cell saves to disk rather than executing the code.\n", "\n", "from qiskit_ibm_runtime import QiskitRuntimeService\n", "\n", "service = QiskitRuntimeService()\n", "backend = service.backend(backend_name)" ] }, { "cell_type": "markdown", "id": "61e7cb3b-6d62-4b68-817a-39c0c1d95a9b", "metadata": {}, "source": [ "\n", "\n", "### Adicionar código para compilação\n", "\n", "Por fim, adicione o código a seguir ao seu arquivo de programa. Este código é executado `transpile_remote()` em todos os valores `circuits` passados e retorna o `transpiled_circuits` resultado:\n", "\n" ] }, { "cell_type": "code", "execution_count": null, "id": "041e7f85-e9e8-424d-8694-d54316225cc4", "metadata": {}, "outputs": [], "source": [ "%%writefile --append ./source_files/transpile_remote.py\n", "# If you include the preceding `%%writefile` command (visible only when you read this\n", "# locally in a notebook), running this cell saves to disk rather than executing the code.\n", "\n", "# Each circuit is being transpiled and will populate the array\n", "results = [\n", " transpile_remote(circuit, 1, backend)\n", " for circuit in circuits\n", "]\n", "\n", "save_result({\n", " \"transpiled_circuits\": results\n", "})" ] }, { "cell_type": "markdown", "id": "dac118ab-e447-4ddd-a5f8-d13e3953db76", "metadata": {}, "source": [ "\n", "\n", "\n", "\n", "### Faça a autenticação em Qiskit Serverless\n", "\n", "Use `qiskit-ibm-catalog` para se autenticar no `QiskitServerless` com sua chave de API (você pode usar sua chave `QiskitRuntimeService` de API ou criar uma nova chave de API no [painel]() do IBM Quantum Platform ).\n", "\n" ] }, { "cell_type": "code", "execution_count": 13, "id": "8d1385c3-09a5-42c6-a5bc-53f686d8410e", "metadata": {}, "outputs": [], "source": [ "from qiskit_ibm_catalog import QiskitServerless, QiskitFunction\n", "\n", "# Authenticate to the remote cluster and submit the pattern for remote execution\n", "serverless = QiskitServerless()" ] }, { "cell_type": "markdown", "id": "a0f64820-5fb1-41b9-9cb4-5095d0b5db43", "metadata": {}, "source": [ "\n", "\n", "### Execute o código para fazer o upload\n", "\n", "Execute o código a seguir para fazer o upload do programa. Qiskit Serverless compacta o conteúdo de `working_dir` (neste caso, `source_files`) em um `tar`, que é enviado e, em seguida, eliminado. O `entrypoint` identifica o executável principal do programa para que o `Qiskit Serverless` seja executado.\n", "\n" ] }, { "cell_type": "code", "execution_count": 8, "id": "c1cdd46d-71e9-4711-a09b-6eca569ede6a", "metadata": {}, "outputs": [], "source": [ "transpile_remote_demo = QiskitFunction(\n", " title=\"transpile_remote_serverless\",\n", " entrypoint=\"transpile_remote.py\",\n", " working_dir=\"./source_files/\",\n", ")" ] }, { "cell_type": "code", "execution_count": 9, "id": "8b675d04-bde8-4b3d-b9e5-99982ef742e1", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "QiskitFunction(transpile_remote_serverless)" ] }, "execution_count": 9, "metadata": {}, "output_type": "execute_result" } ], "source": [ "serverless.upload(transpile_remote_demo)" ] }, { "cell_type": "markdown", "id": "3a840c18-3010-4d05-91cb-592e2692c1d7", "metadata": {}, "source": [ "\n", "\n", "### Verificar upload\n", "\n", "Para verificar se o upload foi realizado com sucesso, use `serverless.list()`, conforme mostrado no código a seguir:\n", "\n" ] }, { "cell_type": "code", "execution_count": 10, "id": "afaa3935-adf7-4b28-a8f0-583a82bbe3f1", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "QiskitFunction(transpile_remote_serverless)" ] }, "execution_count": 10, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# Get program from serverless.list() that matches the title of the one we uploaded\n", "next(\n", " program\n", " for program in serverless.list()\n", " if program.title == \"transpile_remote_serverless\"\n", ")" ] }, { "cell_type": "markdown", "id": "a416b143-6f70-49dc-ab2f-ad66f042cab1", "metadata": {}, "source": [ "\n", "\n", "## Próximas etapas\n", "\n", "\n", " * Saiba como passar parâmetros e executar seu programa remotamente no tópico “[Execute remotamente sua primeira carga de trabalho do Qiskit Serverless](/docs/guides/serverless-run-first-workload) ”.\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 }