Instalace

Předpoklady

• Spravované pracovní postupy povolené na tvých instancích IBM Quantum® Platform. Požádej svého administrátora o jejich povolení.

• API klíč a CRN tvé instance. Viz Zjištění přístupových údajů.

• Python 3.10 nebo novější, v aktivním virtuálním prostředí. Jak prostředí nastavit, najdeš v části Instalace Qiskit.

Rychlý start s AI skills

Můžeš využít AI skills z repozitáře šablon Qiskit Function, které ti pomohou nainstalovat qiskit-ibm-catalog, zabalit tvůj stávající lokální kód a nasadit ho jako spravovaný pracovní postup.

Instalace klientského balíčku

Nainstaluj balíček qiskit-ibm-catalog:

pip install qiskit-ibm-catalog

Tento příkaz také nainstaluje qiskit-serverless, qiskit a qiskit-ibm-runtime jako závislosti. Balíček qiskit-serverless nemusíš instalovat zvlášť. Příklady v těchto průvodcích vyžadují qiskit-ibm-catalog 0.22.0 nebo novější, který nainstaluje qiskit-serverless 0.38 a qiskit-ibm-runtime 0.51.

Dva z těchto balíčků používáš přímo, na různých místech:

• qiskit-ibm-catalog je klient, který používáš na svém lokálním počítači k nahrávání pracovních postupů, jejich spouštění a získávání jejich výsledků.

• qiskit-serverless běží uvnitř kódu tvého pracovního postupu. Poskytuje pomocné funkce jako get_arguments(), update_status() a save_result().

Aktualizace klientského balíčku

Protože jsou spravované pracovní postupy v betě, klientský balíček se často mění. Chceš-li zjistit, kterou verzi máš, spusť následující příkaz:

pip show qiskit-ibm-catalog

Or, in Python:

import qiskit_ibm_catalog

print(qiskit_ibm_catalog.__version__)

Chceš-li aktualizovat na nejnovější verzi, spusť následující příkaz:

pip install --upgrade qiskit-ibm-catalog

Pokud nová verze qiskit-ibm-catalog vyžaduje novější verzi qiskit-serverless, tento příkaz aktualizuje také qiskit-serverless.

Autentizace

Chraň svůj API klíč

Nevkládej svůj API klíč do kódu pracovního postupu, do skriptů ani do souborů notebooků. Běžící pracovní postup používá přihlašovací údaje a instanci, které jsi použil(a) při volání run().

Klient spravovaných pracovních postupů používá stejné přihlašovací údaje jako qiskit-ibm-runtime. Pokud jsi již uložil(a) účet pomocí QiskitRuntimeService.save_account(), klient načte tvůj výchozí uložený účet a můžeš přeskočit na Ověření nastavení.

Pokud jsi účet neuložil(a), ulož svůj API klíč a CRN instance jednou v důvěryhodném prostředí:

from qiskit_ibm_catalog import ManagedWorkflowClient

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

Tato metoda zapíše tvé přihlašovací údaje do stejného souboru jako QiskitRuntimeService.save_account(). Klient ve výchozím nastavení používá kanál ibm_quantum_platform, takže channel nemusíš nastavovat. Chceš-li uložit více než jeden účet, nastav name a při vytváření klienta předej stejné name.

Další možnosti, například uložení několika účtů nebo automatický výběr instance, najdeš v části Uložení přihlašovacích údajů. Pokud pracuješ na veřejném počítači nebo v jiném nedůvěryhodném prostředí, přihlašovací údaje neukládej. Místo toho postupuj podle návodu Inicializace služby v nedůvěryhodném prostředí.

Ověření nastavení

Připoj se ke spravovaným workflow pomocí uloženého účtu a vypiš workflow, která jsi nahrál(a):

from qiskit_ibm_catalog import ManagedWorkflowClient

client = ManagedWorkflowClient()
client.list()

Pokud jsi zatím nenahrál(a) žádné workflow, výstupem je prázdný seznam ([]). Pokud se zobrazí chyba autentizace, klient nenašel platné přihlašovací údaje. Zkontroluj účet, který jsi uložil(a) v části Authenticate.

Další kroky

Doporučení

• Nasaď své první spravované workflow, abys nahrál(a) workflow, spustil(a) ho a získal(a) jeho výsledek.
• Chceš-li začít z funkčního kódu, nasaď jednu ze šablon Qiskit Function nebo uprav základní šablonu pro své vlastní workflow.