Instalacja

Wymagania wstępne

• Zarządzane przepływy pracy włączone w twoich instancjach IBM Quantum® Platform. Skontaktuj się z administratorem, aby je włączył.

• Klucz API i CRN twojej instancji. Zobacz Find your access credentials.

• Python 3.10 lub nowszy, w aktywnym środowisku wirtualnym. Zobacz Install Qiskit, aby dowiedzieć się, jak skonfigurować środowisko.

Szybki start z umiejętnościami AI

Możesz użyć umiejętności AI z repozytorium szablonów Qiskit Function, aby zainstalować qiskit-ibm-catalog, spakować istniejący lokalny kod i wdrożyć go jako zarządzany przepływ pracy.

Instalacja pakietu klienta

Zainstaluj pakiet qiskit-ibm-catalog:

pip install qiskit-ibm-catalog

To polecenie instaluje również qiskit-serverless, qiskit i qiskit-ibm-runtime jako zależności. Nie musisz osobno instalować qiskit-serverless. Przykłady w tych przewodnikach wymagają qiskit-ibm-catalog 0.22.0 lub nowszego, który instaluje qiskit-serverless 0.38 i qiskit-ibm-runtime 0.51.

Dwóch z tych pakietów używasz bezpośrednio, w różnych miejscach:

• qiskit-ibm-catalog to klient, którego używasz na swoim komputerze lokalnym do przesyłania przepływów pracy, ich uruchamiania i pobierania ich wyników.

• qiskit-serverless działa wewnątrz kodu twojego przepływu pracy. Udostępnia funkcje pomocnicze, takie jak get_arguments(), update_status() i save_result().

Aktualizacja pakietu klienta

Ponieważ zarządzane przepływy pracy są w wersji beta, pakiet klienta często się zmienia. Aby sprawdzić, jaką masz wersję, uruchom następujące polecenie:

pip show qiskit-ibm-catalog

Or, in Python:

import qiskit_ibm_catalog

print(qiskit_ibm_catalog.__version__)

Aby zaktualizować do najnowszej wersji, uruchom następujące polecenie:

pip install --upgrade qiskit-ibm-catalog

Jeśli nowa wersja qiskit-ibm-catalog wymaga nowszej wersji qiskit-serverless, to polecenie aktualizuje również qiskit-serverless.

Uwierzytelnianie

Chroń swój klucz API

Nie umieszczaj klucza API w kodzie przepływu pracy, w skryptach ani w plikach notatników. Uruchomiony przepływ pracy używa danych uwierzytelniających i instancji, których użyłeś do wywołania run().

Klient zarządzanych przepływów pracy używa tych samych danych uwierzytelniających co qiskit-ibm-runtime. Jeśli masz już zapisane konto za pomocą QiskitRuntimeService.save_account(), klient wczytuje twoje domyślne zapisane konto i możesz przejść do sekcji Verify your setup.

Jeśli nie masz zapisanego konta, zapisz swój klucz API i CRN instancji jednorazowo w zaufanym środowisku:

from qiskit_ibm_catalog import ManagedWorkflowClient

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

Ta metoda zapisuje twoje dane uwierzytelniające w tym samym pliku co QiskitRuntimeService.save_account(). Klient domyślnie używa kanału ibm_quantum_platform, więc nie musisz ustawiać channel. Aby zapisać więcej niż jedno konto, ustaw name i przekaż ten sam name podczas tworzenia klienta.

Więcej opcji, takich jak zapisywanie kilku kont lub automatyczny wybór instancji, znajdziesz w Save your login credentials. Jeśli pracujesz na publicznym komputerze lub w innym niezaufanym środowisku, nie zapisuj swoich danych uwierzytelniających. Zamiast tego postępuj zgodnie z Initialize the service in an untrusted environment.

Weryfikacja konfiguracji

Połącz się z zarządzanymi przepływami pracy za pomocą zapisanego konta i wyświetl listę przesłanych przepływów pracy:

from qiskit_ibm_catalog import ManagedWorkflowClient

client = ManagedWorkflowClient()
client.list()

Jeśli nie przesłałeś jeszcze żadnego przepływu pracy, wynikiem jest pusta lista ([]). Jeśli zobaczysz błąd uwierzytelniania, klient nie znalazł prawidłowych danych uwierzytelniających. Sprawdź konto, które zapisałeś w sekcji Authenticate.

Następne kroki

Zalecenia

• Wdróż swój pierwszy zarządzany przepływ pracy, aby przesłać przepływ pracy, uruchomić go i pobrać jego wynik.
• Aby zacząć od działającego kodu, wdróż jeden z szablonów Qiskit Function lub dostosuj szablon podstawowy do własnego przepływu pracy.