Partilhar via


Configurar a Quantum Development Kit extensão

Neste artigo, você aprenderá a instalar a extensão do Azure Quantum Development Kit (QDK) para Visual Studio Code e adicionar suporte para Python, Jupyter Notebooks e a CLI do Azure.

Pré-requisitos

  • A versão mais recente do Visual Studio Code.
  • Se quiser enviar trabalhos para o Azure Quantum, você também precisará de uma conta do Azure com um espaço de trabalho quântico. Para obter mais informações, consulte Criar um espaço de trabalho do Azure Quantum.

Instale a extensão QDK

Para usar o QDK no Visual Studio Code, instale a extensão QDK. Você também pode usar o QDK no VS Code para a Web sem instalar a extensão, mas você não terá todos os recursos do VS Code Desktop. Para obter mais informações, consulte Diferentes maneiras de executar Q# programas.

Nota

Se você usou versões anteriores do QDK, execute python -m pip uninstall qsharp qsharp-core qsharp-chemistry azure-quantum para evitar conflitos de versão do pacote.

Agora você pode escrever, depurar e executar Q# programas no simulador quântico interno ou, se tiver uma conta do Azure, conectar e enviar Q# programas para hardware quântico, tudo a partir do VS Code.

Para testar sua configuração, consulte Enviar Q# trabalhos para o Azure Quantum.

Adicionar suporte para Python e Jupyter Notebooks

Com o suporte a Python no Visual Studio Code, você pode incorporar ou chamar Q# código de seus programas Python ou Jupyter Notebooks e executá-los no simulador quântico interno ou conectar-se ao seu espaço de trabalho do Azure e enviar seus trabalhos para hardware quântico.

Pré-requisitos

  • Um ambiente Python (3.9 ou superior, 3.11 recomendado) com Python e Pip instalados.
  • VS Code com a extensão QDK instalada.

Instale os pacotes necessários

Para adicionar suporte a Python e Jupyter Notebook:

  1. Instale as extensões Python e Jupyter para VS Code.

  2. Abra a linha de comando.

  3. Instale o qsharp e azure-quantum pacotes:

    python -m pip install qsharp azure-quantum
    
  4. Para suporte a Qiskit ou Cirq, instale azure-quantum usando os parâmetros [qiskit] ou [cirq]:

    Importante

    Se você estiver atualizando de um ambiente Qiskit anterior, consulte Atualizar o pacote azure-quantum com suporte ao Qiskit.

    python -m pip install azure-quantum[qiskit]
    or
    python -m pip install azure-quantum[cirq]
    or
    python -m pip install azure-quantum[qiskit, cirq]
    
  5. Instale pacotes Python opcionais que você pode precisar para exibir resultados e trabalhar no Jupyter Notebooks:

    python -m pip install ipykernel ipympl jupyterlab
    

Para testar sua configuração, consulte Enviar Q# trabalhos com Python ou Enviar Q# trabalhos com o Jupyter Notebooks.

Adicionar suporte para a CLI do Azure

A CLI do Azure é um método opcional para enviar trabalhos quânticos usando uma janela de terminal no Visual Studio Code.

  1. Instale a CLI do Azure.

  2. Abra uma linha de comandos do Windows.

  3. No prompt de comando, execute o seguinte comando para atualizar para a extensão mais recente da CLI quantum do Azure:

    az extension add \
        --upgrade \
        -n quantum
    

Para testar sua configuração, consulte Enviar Q# trabalhos para o Azure Quantum.