I-install

Mga Kinakailangan

• Naka-enable ang managed workflows sa iyong IBM Quantum® Platform instances. Makipag-ugnayan sa iyong administrator para i-enable ito.

• Isang API key at ang CRN ng iyong instance. Tingnan ang Find your access credentials.

• Python 3.10 o mas bago, sa isang aktibong virtual environment. Tingnan ang Install Qiskit para sa pag-set up ng environment.

Mabilis na simula gamit ang AI skills

Magagamit mo ang AI skills sa Qiskit Function templates repository para tulungan kang i-install ang qiskit-ibm-catalog, i-package ang iyong kasalukuyang lokal na code, at i-deploy ito bilang managed workflow.

I-install ang client package

I-install ang package na qiskit-ibm-catalog:

pip install qiskit-ibm-catalog

Ini-install din ng command na ito ang qiskit-serverless, qiskit, at qiskit-ibm-runtime bilang mga dependency. Hindi mo na kailangang i-install nang hiwalay ang qiskit-serverless. Ang mga halimbawa sa mga gabay na ito ay nangangailangan ng qiskit-ibm-catalog 0.22.0 o mas bago, na nag-i-install ng qiskit-serverless 0.38 at qiskit-ibm-runtime 0.51.

Direktang gumagamit ka ng dalawa sa mga package na ito, sa magkaibang lugar:

• Ang qiskit-ibm-catalog ang client na ginagamit mo sa iyong lokal na computer para mag-upload ng mga workflow, patakbuhin ang mga ito, at kunin ang mga resulta nila.

• Tumatakbo ang qiskit-serverless sa loob ng code ng iyong workflow. Nagbibigay ito ng mga helper tulad ng get_arguments(), update_status(), at save_result().

I-update ang client package

Dahil nasa beta ang managed workflows, madalas magbago ang client package. Para tingnan kung anong bersyon ang mayroon ka, patakbuhin ang sumusunod na command:

pip show qiskit-ibm-catalog

Or, in Python:

import qiskit_ibm_catalog

print(qiskit_ibm_catalog.__version__)

Para mag-update sa pinakabagong bersyon, patakbuhin ang sumusunod na command:

pip install --upgrade qiskit-ibm-catalog

Kung nangangailangan ang bagong bersyon ng qiskit-ibm-catalog ng mas bagong bersyon ng qiskit-serverless, ina-update din ng command na ito ang qiskit-serverless.

Mag-authenticate

Protektahan ang iyong API key

Huwag isama ang iyong API key sa code ng iyong workflow, sa mga script, o sa mga notebook file. Ang tumatakbong workflow ay gumagamit ng mga kredensyal at instance na ginamit mo sa pagtawag ng run().

Ginagamit ng managed workflows client ang parehong kredensyal gaya ng qiskit-ibm-runtime. Kung nag-save ka na ng account gamit ang QiskitRuntimeService.save_account(), ilo-load ng client ang iyong default na saved account, at maaari kang dumiretso sa Verify your setup.

Kung hindi ka pa nakapag-save ng account, i-save nang isang beses ang iyong API key at instance CRN sa isang pinagkakatiwalaang environment:

from qiskit_ibm_catalog import ManagedWorkflowClient

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

Isinusulat ng method na ito ang iyong mga kredensyal sa parehong file ng QiskitRuntimeService.save_account(). Gumagamit ang client ng channel na ibm_quantum_platform bilang default, kaya hindi mo na kailangang i-set ang channel. Para mag-save ng higit sa isang account, i-set ang name, at ipasa ang parehong name kapag gumawa ka ng client.

Para sa higit pang opsyon, tulad ng pag-save ng ilang account o awtomatikong pagpili ng instance, tingnan ang Save your login credentials. Kung gumagamit ka ng pampublikong computer o ibang hindi pinagkakatiwalaang environment, huwag i-save ang iyong mga kredensyal. Sa halip, sundin ang Initialize the service in an untrusted environment.

I-verify ang iyong setup

Kumonekta sa managed workflows gamit ang iyong saved account, at ilista ang mga workflow na na-upload mo:

from qiskit_ibm_catalog import ManagedWorkflowClient

client = ManagedWorkflowClient()
client.list()

Kung wala ka pang na-upload na workflow, walang laman na listahan ang output ([]). Kung may makita kang authentication error, hindi nakahanap ang client ng valid na kredensyal. Suriin ang account na na-save mo sa seksyong Authenticate.

Mga susunod na hakbang

Mga Rekomendasyon

• Deploy your first managed workflow para mag-upload ng workflow, patakbuhin ito, at kunin ang resulta nito.
• Para magsimula sa gumaganang code, i-deploy ang isa sa mga Qiskit Function templates, o iangkop ang isang base template para sa sarili mong workflow.