설치

사전 요구 사항

IBM Quantum® Platform 인스턴스에서 관리형 워크플로가 활성화되어 있어야 합니다. 활성화하려면 관리자에게 문의하세요.
API 키와 인스턴스의 CRN. 액세스 자격 증명 찾기를 참조하세요.
활성화된 가상 환경의 Python 3.10 이상. 환경을 설정하는 방법은 Qiskit 설치를 참조하세요.

AI 스킬로 빠르게 시작하기

Qiskit Function 템플릿 저장소의 AI 스킬을 사용하면 qiskit-ibm-catalog를 설치하고, 기존 로컬 코드를 패키징하고, 관리형 워크플로로 배포하는 데 도움을 받을 수 있습니다.

클라이언트 패키지 설치

qiskit-ibm-catalog 패키지를 설치합니다:

pip install qiskit-ibm-catalog

이 명령은 종속성으로 qiskit-serverless, qiskit, qiskit-ibm-runtime도 함께 설치합니다. qiskit-serverless를 별도로 설치할 필요가 없습니다. 이 가이드의 예제에는 qiskit-ibm-catalog 0.22.0 이상이 필요하며, 이 버전은 qiskit-serverless 0.38과 qiskit-ibm-runtime 0.51을 설치합니다.

이 패키지 중 두 개를 서로 다른 곳에서 직접 사용합니다:

qiskit-ibm-catalog는 로컬 컴퓨터에서 워크플로를 업로드하고, 실행하고, 결과를 가져오는 데 사용하는 클라이언트입니다.
qiskit-serverless는 워크플로 코드 내부에서 실행됩니다. get_arguments(), update_status(), save_result() 같은 헬퍼를 제공합니다.

클라이언트 패키지 업데이트

관리형 워크플로는 베타 단계이므로 클라이언트 패키지가 자주 변경됩니다. 현재 버전을 확인하려면 다음 명령을 실행합니다:

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도 함께 업데이트합니다.

인증

API 키를 보호하세요

워크플로 코드, 스크립트, 노트북 파일에 API 키를 포함하지 마세요. 실행 중인 워크플로는 run()을 호출할 때 사용한 자격 증명과 인스턴스를 사용합니다.

관리형 워크플로 클라이언트는 qiskit-ibm-runtime과 동일한 자격 증명을 사용합니다. 이미 QiskitRuntimeService.save_account()로 계정을 저장했다면 클라이언트가 기본 저장 계정을 불러오므로, 설정 확인으로 건너뛰어도 됩니다.

계정을 저장하지 않았다면, 신뢰할 수 있는 환경에서 API 키와 인스턴스 CRN을 한 번 저장합니다:

from qiskit_ibm_catalog import ManagedWorkflowClient

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

이 메서드는 QiskitRuntimeService.save_account()와 같은 파일에 자격 증명을 기록합니다. 클라이언트는 기본적으로 ibm_quantum_platform 채널을 사용하므로 channel을 설정할 필요가 없습니다. 둘 이상의 계정을 저장하려면 name을 설정하고, 클라이언트를 만들 때 동일한 name을 전달하세요.

여러 계정 저장이나 인스턴스 자동 선택 같은 더 많은 옵션은 로그인 자격 증명 저장을 참조하세요. 공용 컴퓨터나 신뢰할 수 없는 다른 환경에서 작업하는 경우 자격 증명을 저장하지 마세요. 대신 신뢰할 수 없는 환경에서 서비스 초기화를 따르세요.

설정 확인

저장된 계정으로 관리형 워크플로에 연결하고, 업로드한 워크플로를 나열합니다:

from qiskit_ibm_catalog import ManagedWorkflowClient

client = ManagedWorkflowClient()
client.list()

아직 워크플로를 업로드하지 않았다면 출력은 빈 목록([])입니다. 인증 오류가 표시되면 클라이언트가 유효한 자격 증명을 찾지 못한 것입니다. 인증 섹션에서 저장한 계정을 확인하세요.

다음 단계

권장 사항

첫 번째 관리형 워크플로 배포에서 워크플로를 업로드하고, 실행하고, 결과를 가져옵니다.
작동하는 코드로 시작하려면 Qiskit Function 템플릿 중 하나를 배포하거나, 기본 템플릿을 자신의 워크플로에 맞게 수정하세요.

사전 요구 사항​

AI 스킬로 빠르게 시작하기​

클라이언트 패키지 설치​

클라이언트 패키지 업데이트​

인증​

설정 확인​

다음 단계​