Instalação

Pré-requisitos

• Fluxos de trabalho gerenciados habilitados nas suas instâncias do IBM Quantum® Platform. Entre em contato com seu administrador para habilitá-los.

• Uma chave de API e o CRN da sua instância. Veja Find your access credentials.

• Python 3.10 ou posterior, em um ambiente virtual ativo. Veja Install Qiskit para saber como configurar um ambiente.

Início rápido com skills de IA

Você pode usar as skills de IA do repositório de modelos de Qiskit Function para ajudar a instalar o qiskit-ibm-catalog, empacotar seu código local existente e implantá-lo como um fluxo de trabalho gerenciado.

Instale o pacote cliente

Instale o pacote qiskit-ibm-catalog:

pip install qiskit-ibm-catalog

Este comando também instala qiskit-serverless, qiskit e qiskit-ibm-runtime como dependências. Você não precisa instalar qiskit-serverless separadamente. Os exemplos destes guias exigem qiskit-ibm-catalog 0.22.0 ou posterior, que instala qiskit-serverless 0.38 e qiskit-ibm-runtime 0.51.

Você usa diretamente dois desses pacotes, em lugares diferentes:

• qiskit-ibm-catalog é o cliente que você usa no seu computador local para enviar fluxos de trabalho, executá-los e obter seus resultados.

• qiskit-serverless roda dentro do código do seu fluxo de trabalho. Ele fornece helpers como get_arguments(), update_status() e save_result().

Atualize o pacote cliente

Como os fluxos de trabalho gerenciados estão em beta, o pacote cliente muda com frequência. Para verificar qual versão você tem, execute o comando a seguir:

pip show qiskit-ibm-catalog

Or, in Python:

import qiskit_ibm_catalog

print(qiskit_ibm_catalog.__version__)

Para atualizar para a versão mais recente, execute o comando a seguir:

pip install --upgrade qiskit-ibm-catalog

Se a nova versão do qiskit-ibm-catalog exigir uma versão mais nova do qiskit-serverless, este comando também atualiza o qiskit-serverless.

Autenticação

Proteja sua chave de API

Não inclua sua chave de API no código do seu fluxo de trabalho, em scripts ou em arquivos de notebook. Um fluxo de trabalho em execução usa as credenciais e a instância que você usou para chamar run().

O cliente de fluxos de trabalho gerenciados usa as mesmas credenciais do qiskit-ibm-runtime. Se você já salvou uma conta com QiskitRuntimeService.save_account(), o cliente carrega sua conta salva padrão, e você pode pular para Verifique sua configuração.

Se você ainda não salvou uma conta, salve sua chave de API e o CRN da instância uma única vez em um ambiente confiável:

from qiskit_ibm_catalog import ManagedWorkflowClient

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

Este método grava suas credenciais no mesmo arquivo que QiskitRuntimeService.save_account(). O cliente usa o canal ibm_quantum_platform por padrão, então você não precisa definir channel. Para salvar mais de uma conta, defina name e passe o mesmo name ao criar o cliente.

Para mais opções, como salvar várias contas ou selecionar uma instância automaticamente, veja Save your login credentials. Se você trabalha em um computador público ou em outro ambiente não confiável, não salve suas credenciais. Em vez disso, siga Initialize the service in an untrusted environment.

Verifique sua configuração

Conecte-se aos fluxos de trabalho gerenciados com sua conta salva e liste os fluxos de trabalho que você enviou:

from qiskit_ibm_catalog import ManagedWorkflowClient

client = ManagedWorkflowClient()
client.list()

Se você ainda não enviou nenhum fluxo de trabalho, a saída é uma lista vazia ([]). Se você vir um erro de autenticação, o cliente não encontrou credenciais válidas. Verifique a conta que você salvou na seção Autenticação.

Próximos passos

Recomendações

• Implante seu primeiro workflow gerenciado para enviar um workflow, executá-lo e obter o resultado.
• Para começar a partir de um código funcional, implante um dos templates de Qiskit Function ou adapte um template base para o seu próprio workflow.