Встановлення

Передумови

• Керовані робочі процеси ввімкнено на твоїх екземплярах IBM Quantum® Platform. Зверніться до свого адміністратора, щоб його ввімкнути.

• API-ключ і CRN твого екземпляра. Дивись Пошук облікових даних для доступу.

• Python 3.10 або новіший в активному віртуальному середовищі. Про налаштування середовища дивись Встановлення Qiskit.

Швидкий старт із AI-навичками

Ти можеш скористатися AI-навичками з репозиторію шаблонів Qiskit Function, щоб встановити qiskit-ibm-catalog, упакувати наявний локальний код і розгорнути його як керований робочий процес.

Встановлення пакета клієнта

Встанови пакет qiskit-ibm-catalog:

pip install qiskit-ibm-catalog

Ця команда також встановлює qiskit-serverless, qiskit і qiskit-ibm-runtime як залежності. Окремо встановлювати qiskit-serverless не потрібно. Приклади в цих посібниках потребують qiskit-ibm-catalog 0.22.0 або новіший, який встановлює qiskit-serverless 0.38 і qiskit-ibm-runtime 0.51.

Ти напряму використовуєш два з цих пакетів, у різних місцях:

• qiskit-ibm-catalog — це клієнт, який ти використовуєш на локальному комп'ютері, щоб завантажувати робочі процеси, запускати їх і отримувати їхні результати.

• qiskit-serverless працює всередині коду твого робочого процесу. Він надає допоміжні функції, такі як get_arguments(), update_status() і save_result().

Оновлення клієнтського пакета

Оскільки managed workflows перебуває в бета-версії, клієнтський пакет часто змінюється. Щоб дізнатися, яку версію ти маєш, виконай таку команду:

pip show qiskit-ibm-catalog

Or, in Python:

import qiskit_ibm_catalog

print(qiskit_ibm_catalog.__version__)

Щоб оновити до найновішої версії, виконай таку команду:

pip install --upgrade qiskit-ibm-catalog

Якщо нова версія qiskit-ibm-catalog потребує новішої версії qiskit-serverless, ця команда також оновлює qiskit-serverless.

Автентифікація

Захисти свій ключ API

Не додавай свій ключ API до коду робочого процесу, до скриптів або до файлів ноутбуків. Запущений робочий процес використовує облікові дані та інстанс, які ти використав для виклику run().

Клієнт managed workflows використовує ті самі облікові дані, що й qiskit-ibm-runtime. Якщо ти вже зберіг обліковий запис за допомогою QiskitRuntimeService.save_account(), клієнт завантажує твій збережений обліковий запис за замовчуванням, і ти можеш перейти до Перевірки налаштування.

Якщо ти не зберігав обліковий запис, збережи свій ключ API та CRN інстанса один раз у довіреному середовищі:

from qiskit_ibm_catalog import ManagedWorkflowClient

ManagedWorkflowClient.save_account(
    token="<your-api-key>",
    instance="<your-instance-crn>",
)

Цей метод записує твої облікові дані в той самий файл, що й QiskitRuntimeService.save_account(). Клієнт за замовчуванням використовує канал ibm_quantum_platform, тому встановлювати channel не потрібно. Щоб зберегти більше одного облікового запису, задай name і передай той самий name під час створення клієнта.

Додаткові можливості, як-от збереження кількох облікових записів або автоматичний вибір інстанса, дивись у розділі Збереження облікових даних для входу. Якщо ти працюєш на публічному комп'ютері або в іншому недовіреному середовищі, не зберігай свої облікові дані. Натомість виконай інструкції з розділу Ініціалізація сервісу в недовіреному середовищі.

Перевірка налаштування

Підключися до managed workflows за допомогою збереженого облікового запису та виведи список робочих процесів, які ти завантажив:

from qiskit_ibm_catalog import ManagedWorkflowClient

client = ManagedWorkflowClient()
client.list()

Якщо ти ще не завантажував жодного робочого процесу, результатом буде порожній список ([]). Якщо ти бачиш помилку автентифікації, клієнт не знайшов дійсних облікових даних. Перевір обліковий запис, який ти зберіг, у розділі Автентифікація.

Наступні кроки

Рекомендації

• Розгорни свій перший managed workflow, щоб завантажити робочий процес, запустити його й отримати результат.
• Щоб почати з готового коду, розгорни один із шаблонів Qiskit Function або адаптуй базовий шаблон для власного робочого процесу.