Installation

Voraussetzungen

• Verwaltete Workflows sind für deine IBM Quantum® Platform-Instanzen aktiviert. Wende dich an deine Administratorin oder deinen Administrator, um die Funktion zu aktivieren.

• Ein API-Schlüssel und die CRN deiner Instanz. Siehe Zugangsdaten finden.

• Python 3.10 oder neuer in einer aktiven virtuellen Umgebung. Wie du eine Umgebung einrichtest, erfährst du unter Qiskit installieren.

Schnellstart mit KI-Skills

Du kannst die KI-Skills im Qiskit-Function-Templates-Repository verwenden, um qiskit-ibm-catalog zu installieren, deinen vorhandenen lokalen Code zu verpacken und ihn als verwalteten Workflow bereitzustellen.

Das Client-Paket installieren

Installiere das Paket qiskit-ibm-catalog:

pip install qiskit-ibm-catalog

Dieser Befehl installiert außerdem qiskit-serverless, qiskit und qiskit-ibm-runtime als Abhängigkeiten. Du musst qiskit-serverless nicht separat installieren. Die Beispiele in diesen Leitfäden erfordern qiskit-ibm-catalog 0.22.0 oder neuer, das qiskit-serverless 0.38 und qiskit-ibm-runtime 0.51 installiert.

Zwei dieser Pakete verwendest du direkt, und zwar an unterschiedlichen Stellen:

• qiskit-ibm-catalog ist der Client, den du auf deinem lokalen Computer verwendest, um Workflows hochzuladen, auszuführen und ihre Ergebnisse abzurufen.

• qiskit-serverless läuft innerhalb deines Workflow-Codes. Es stellt Hilfsfunktionen wie get_arguments(), update_status() und save_result() bereit.

Das Client-Paket aktualisieren

Da sich verwaltete Workflows in der Beta-Phase befinden, ändert sich das Client-Paket häufig. Um zu prüfen, welche Version du hast, führe den folgenden Befehl aus:

pip show qiskit-ibm-catalog

Or, in Python:

import qiskit_ibm_catalog

print(qiskit_ibm_catalog.__version__)

Um auf die neueste Version zu aktualisieren, führe den folgenden Befehl aus:

pip install --upgrade qiskit-ibm-catalog

Wenn die neue Version von qiskit-ibm-catalog eine neuere Version von qiskit-serverless erfordert, aktualisiert dieser Befehl auch qiskit-serverless.

Authentifizieren

Schütze deinen API-Schlüssel

Füge deinen API-Schlüssel weder in deinen Workflow-Code noch in Skripte oder Notebook-Dateien ein. Ein laufender Workflow verwendet die Anmeldedaten und die Instanz, die du beim Aufruf von run() verwendet hast.

Der Client für verwaltete Workflows verwendet dieselben Anmeldedaten wie qiskit-ibm-runtime. Wenn du bereits ein Konto mit QiskitRuntimeService.save_account() gespeichert hast, lädt der Client dein gespeichertes Standardkonto, und du kannst direkt zu Einrichtung überprüfen springen.

Wenn du noch kein Konto gespeichert hast, speichere deinen API-Schlüssel und die Instanz-CRN einmalig in einer vertrauenswürdigen Umgebung:

from qiskit_ibm_catalog import ManagedWorkflowClient

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

Diese Methode schreibt deine Anmeldedaten in dieselbe Datei wie QiskitRuntimeService.save_account(). Der Client verwendet standardmäßig den Kanal ibm_quantum_platform, sodass du channel nicht setzen musst. Um mehr als ein Konto zu speichern, setze name und übergib beim Erstellen des Clients denselben name.

Weitere Optionen, etwa das Speichern mehrerer Konten oder die automatische Auswahl einer Instanz, findest du unter Deine Anmeldedaten speichern. Wenn du an einem öffentlichen Computer oder in einer anderen nicht vertrauenswürdigen Umgebung arbeitest, speichere deine Anmeldedaten nicht. Folge stattdessen der Anleitung Den Dienst in einer nicht vertrauenswürdigen Umgebung initialisieren.

Einrichtung überprüfen

Verbinde dich mit deinem gespeicherten Konto mit verwalteten Workflows und liste die Workflows auf, die du hochgeladen hast:

from qiskit_ibm_catalog import ManagedWorkflowClient

client = ManagedWorkflowClient()
client.list()

Wenn du noch keinen Workflow hochgeladen hast, ist die Ausgabe eine leere Liste ([]). Wenn ein Authentifizierungsfehler auftritt, hat der Client keine gültigen Anmeldedaten gefunden. Überprüfe das Konto, das du im Abschnitt Authentifizieren gespeichert hast.

Nächste Schritte

Empfehlungen

• Stelle deinen ersten verwalteten Workflow bereit, um einen Workflow hochzuladen, auszuführen und sein Ergebnis abzurufen.
• Um mit funktionierendem Code zu starten, stelle eine der Qiskit-Function-Vorlagen bereit oder passe eine Basisvorlage für deinen eigenen Workflow an.