ติดตั้ง
ข้อกำหนดเบื้องต้น
-
เปิดใช้งาน Managed workflows บน IBM Quantum® Platform instances ของคุณ ติดต่อผู้ดูแลระบบเพื่อเปิดใช้งาน
-
API key และ CRN ของ instance ของคุณ ดู Find your access credentials
-
Python 3.10 ขึ้นไป ใน virtual environment ที่ทำงานอยู่ ดู Install Qiskit สำหรับวิธีตั้งค่า environment
เริ่มต้นอย่างรวดเร็วด้วย AI skills
คุณสามารถใช้ AI skills ใน Qiskit Function templates repository เพื่อช่วยติดตั้ง qiskit-ibm-catalog แพ็กเกจโค้ดในเครื่องที่คุณมีอยู่ และ deploy เป็น managed workflow
ติดตั้ง client package
ติดตั้ง package qiskit-ibm-catalog:
pip install qiskit-ibm-catalog
คำสั่งนี้ยังติดตั้ง qiskit-serverless, qiskit และ qiskit-ibm-runtime เป็น dependencies ด้วย คุณไม่ต้องติดตั้ง qiskit-serverless แยกต่างหาก ตัวอย่างในคู่มือเหล่านี้ต้องใช้ qiskit-ibm-catalog 0.22.0 ขึ้นไป ซึ่งจะติดตั้ง qiskit-serverless 0.38 และ qiskit-ibm-runtime 0.51
คุณใช้ package สองตัวในนี้โดยตรง ในที่ต่างกัน:
-
qiskit-ibm-catalogคือ client ที่คุณใช้บนคอมพิวเตอร์ของคุณเพื่ออัปโหลด workflow รัน และรับผลลัพธ์ -
qiskit-serverlessทำงานภายในโค้ด workflow ของคุณ โดยมี helper เช่นget_arguments(),update_status()และsave_result()
อัปเดต client package
เนื่องจาก managed workflows อยู่ในช่วง beta client package จึงเปลี่ยนแปลงบ่อย เพื่อตรวจสอบว่าคุณใช้เวอร์ชันใด ให้รันคำสั่งต่อไปนี้:
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 ด้วย
Authenticate
อย่าใส่ API key ของคุณในโค้ด workflow ในสคริปต์ หรือในไฟล์ notebook workflow ที่กำลังรันจะใช้ข้อมูลรับรองและ instance ที่คุณใช้เรียก run()
managed workflows client ใช้ข้อมูลรับรองเดียวกับ qiskit-ibm-runtime หากคุณบันทึกบัญชีด้วย QiskitRuntimeService.save_account() ไว้แล้ว client จะโหลดบัญชีที่บันทึกไว้เป็นค่าเริ่มต้นของคุณ และคุณข้ามไปที่ Verify your setup ได้
หากคุณยังไม่ได้บันทึกบัญชี ให้บันทึก API key และ CRN ของ instance เพียงครั้งเดียวในสภาพแวดล้อมที่เชื่อถือได้:
from qiskit_ibm_catalog import ManagedWorkflowClient
ManagedWorkflowClient.save_account(
token="<your-api-key>",
instance="<your-instance-crn>",
)
วิธีนี้เขียนข้อมูลรับรองของคุณลงในไฟล์เดียวกับ QiskitRuntimeService.save_account() client ใช้ channel ibm_quantum_platform เป็นค่าเริ่มต้น คุณจึงไม่ต้องตั้งค่า channel หากต้องการบันทึกมากกว่าหนึ่งบัญชี ให้ตั้งค่า name และส่ง name เดียวกันตอนสร้าง client
สำหรับตัวเลือกเพิ่มเติม เช่น การบันทึกหลายบัญชีหรือการเลือก instance โดยอัตโนมัติ ดู Save your login credentials หากคุณทำงานบนคอมพิวเตอร์สาธารณะหรือสภาพแวดล้อมอื่นที่เชื่อถือไม่ได้ อย่าบันทึกข้อมูลรับรองของคุณ แต่ให้ทำตาม Initialize the service in an untrusted environment
ตรวจสอบการตั้งค่าของคุณ
เชื่อมต่อกับ managed workflows ด้วยบัญชีที่บันทึกไว้ และแสดงรายการ workflow ที่คุณอัปโหลด:
from qiskit_ibm_catalog import ManagedWorkflowClient
client = ManagedWorkflowClient()
client.list()
หากคุณยังไม่เคยอัปโหลด workflow ผลลัพธ์จะเป็น list ว่าง ([]) หากคุณเห็นข้อผิดพลาดด้านการยืนยันตัวตน แสดงว่า client ไม่พบข้อมูลรับรองที่ถูกต้อง ตรวจสอบบัญชีที่คุณบันทึกไว้ในส่วน Authenticate
ขั้นตอนถัดไป
- Deploy your first managed workflow เพื่ออัปโหลด workflow รัน และรับผลลัพธ์
- หากต้องการเริ่มจากโค้ดที่ใช้งานได้ ให้ deploy หนึ่งใน Qiskit Function templates หรือปรับ base template สำหรับ workflow ของคุณเอง