Referenční informace: Rozšíření sady Azure Quantum Development Kit pro Visual Studio Code

Sada Azure Quantum Development Kit (QDK) využívá spolu se všemi standardními funkcemi editoru Visual Studio Code (VS Code) i funkce specifické pro Q#, když pracujete se .qs soubory. Tato referenční příručka popisuje všechny příkazy QDK, ke kterým máte přístup v paletě příkazů VS Code, spolu s dalšími funkcemi a odkazy na další obsah. Obecné pokyny pro VS Code najdete v dokumentaci k VS Code.

Tip

Většina příkazů z rozšíření QDK je přístupná z nabídky Paleta příkazů zobrazení>. .qs V souboru otevřete paletu příkazů a zadejte QDK: pokud chcete zobrazit filtrovaný seznam příkazů.

Příkazy

Většina příkazů QDK souvisí s psaním a spouštěním programů V# a jsou k dispozici pouze v případě, že .qs je soubor aktivní. Jiné příkazy fungují na pozadí a nejsou přístupné v paletě příkazů.

Následující tabulka popisuje příkazy z rozšíření QDK, které se zobrazí v paletě příkazů.

Tip

Vlastní klávesové zkratky pro příkazy VS Code můžete vytvářet pomocí klávesových zkratek nebo Ctrl +K + S. Další informace naleznete v tématu Klíčové vazby pro VS Code.

Příkaz	Akce	Poznámky	Alternativní akce uživatele
QDK: Vytvoření projektu Q#	Vytvoří projekt Q# v aktivní složce, včetně souboru manifestu qsharp.json a podsložky src s výchozím souborem main.qs.	Další informace o projektech Q# najdete v tématu Práce s projekty Q#.	V Průzkumníku souborů klikněte pravým tlačítkem na cílovou složku a vyberte Vytvořit projekt Q#.
QDK: Vytvoření poznámkového bloku Azure Quantum	Otevře ukázkový poznámkový blok Jupyter, který spustí program Q# + Python a odešle úlohu do Azure Quantum.	Další informace o poznámkových blocích Azure Quantum najdete v tématu Práce s poznámkovými bloky Azure Quantum.	–
QDK: Připojení k pracovnímu prostoru Azure Quantum	Připojte se k pracovnímu prostoru Azure Quantum pomocí účtu Azure nebo připojovacího řetězce. Po ověření se váš pracovní prostor zobrazí v Průzkumníku souborů v Quantum Workspaces.	Další informace o připojeních Azure Quantum najdete v tématu Připojení k pracovnímu prostoru Azure Quantum.	V Průzkumníku souborů najeďte myší na pracovní prostory Quantum a vyberte ikonu +.
QDK: Otevření dětského hřiště QDK	Otevře online složku ukázkových programů Q# v Průzkumníku souborů. Programy můžete upravovat a spouštět v místním kvantovém simulátoru a také nastavit zarážky a procházet kód pomocí integrovaného ladicího programu.	Další informace najdete v souboru README v ukázkové složce.	–
QDK: Aktualizace pracovních prostorů Azure Quantum	Synchronizuje nejnovější změny z připojených kvantových pracovních prostorů.	Pokud dojde k problému s připojením, zobrazí se vedle názvu pracovního prostoru ikona upozornění.	V Průzkumníku souborů najeďte myší na Pracovní prostory Quantum a vyberte ikonu aktualizace.
Průzkumník: Zaměření na zobrazení kvantových pracovních prostorů	Otevře Průzkumník souborů a zaměřuje se na připojené kvantové pracovní prostory, pokud jsou nakonfigurované. Pokud nejsou nakonfigurované žádné pracovní prostory, zobrazí se výzva k přidání existujícího pracovního prostoru.	Další informace o připojeních Azure Quantum najdete v tématu Připojení k pracovnímu prostoru Azure Quantum.	–

.qs Pokud je soubor aktivní, jsou k dispozici následující příkazy.

Příkaz	Akce	Poznámky	Alternativní akce uživatele
QDK: Zobrazit obvod	Zobrazí diagram okruhu pro program Q# před spuštěním.	Další informace najdete v tématu Vizualizace diagramů kvantových obvodů.	V nabídce vedle operace vstupního bodu nebo nad každou uživatelsky definovanou operací v programu vyberte možnost Circuit v rámci Code Lens.
QDK: Spuštění souboru a zobrazení histogramu	Spustí aktuální program Q# a zobrazí histogram výsledků v novém podokně.	Pokud chcete získat přístup k možnostem řazení a filtrování pro zobrazení histogramu, vyberte ikonu filtru v podokně histogramu.	V nabídce vedle operace vstupního bodu vyberte možnost Histogram z CodeLens.
QDK: Získání QIR pro aktuální program QDK	Otevře zdroj QIR pro aktuální kód Q# v novém okně pro úpravy. K exportu zdroje QIR musí váš program použít cílový profil Base, Adaptive RI nebo Adaptive RIF.	Další informace o QIR naleznete v tématu Kvantová zprostředkující reprezentace a na Q# vývojářském blogu.	–
QDK: Výpočet odhadů prostředků	Vyvolá integrovanou verzi estimátoru prostředků.	Další informace najdete v tématu Úvod do estimátoru prostředků Azure Quantum.	–
QDK: Nápověda	Stručný přehled rozšíření QDK v editoru VS Code	Kompletní dokumentaci k Azure Quantum najdete v dokumentaci k Azure Quantum.	–
QDK: Spuštění souboru a zobrazení diagramu okruhu	Spustí aktuální program Q# a zobrazí okruh programu s výstupy.	Další informace najdete v tématu Vizualizace diagramů kvantových obvodů.	–
QDK: Přidání souboru s pokyny pro Copilot pro Q# a OpenQASM	Otevře výzvu, která vám poskytne možnost přidat příkazy Copilot, které vám pomůžou psát a spouštět kód Q# anf OpenQASM.	Další informace najdete v tématu Nastavení režimu agenta ve VS Code pro sadu Quantum Development Kit.	–
QDK: Zobrazení dokumentace k rozhraní API	Otevře dokumentaci k rozhraní API v novém podokně. Pokud chcete hledat v tomto podokně, stiskněte Ctrl+F.	Další informace najdete v referenčních informacích k rozhraní AZURE Quantum API.	–
QDK: Zobrazit protokol změn	Otevře protokol změn na nové kartě, na které se zobrazují aktualizace sady QDK pro aktuální a předchozí verze.	Protokol změn je také k dispozici v opensourcovém úložišti QDK GitHub.	–
Ladění: Spuštění ladění	Otevře aktuální program Q# v ladicím programu.	Další informace najdete v tématu Ladění a testování kvantového kódu.	Stiskněte klávesu F5 nebo vyberte možnost Ladění kódu z nabídky vedle operace vstupního bodu nebo vyberte ikonu Spustit v pravém horním rohu a zvolte Spustit ladění.
Ladění: Spustit	Spustí aktuální program Q# ve výchozím kvantovém simulátoru.	Další informace najdete v tématu Začínáme s programy v Q#.	Stiskněte Ctrl + F5 nebo vyberte možnost Spustit funkci CodeLens z nabídky vedle operace vstupního bodu, nebo vyberte ikonu Spustit v pravém horním rohu a spusťte Spustit.

Terminály

Programy v Q# používají v editoru VS Code dvě terminálová okna:

Terminál	Akce
Konzola ladění	Zobrazí výstup spuštění nebo výstup ladění.
Problémy	Zobrazí kontroly chyb před kompilací.

Úprava kódu Q#

Většina běžných funkcí pro úpravy kódu v editoru VS Code je dostupná také při práci s programy q#:

• Kontrola chyb předkompilu
• Přejít k definici
• Reference
• Podpisy funkcí
• Informace o parametru
• Návrhy dokončení, včetně kontextových informací, člena oboru názvů a dokončování členů typu
• Linting – V souborech Q# nakonfigurujete lintování pro jednotlivé projekty v souboru manifestu. Další informace najdete v tématu Práce s projekty Q#.

Další informace najdete v části Intellisense v dokumentaci k editoru VS Code.

Běžné úkoly

Práce se soubory a projekty Q#

Úloha	Akce	Poznámky
Nový soubor Q#	Vyberte Soubor > Nový textový soubor>. Uložte soubor s příponou .qs .	Pokud nastavíte Files: Default Language = qsharp, nový soubor se automaticky nastaví na formátování Q#.
Vytvoření projektu Q#	V otevřené složce v Průzkumník souborů vyberte Vytvořit projekt Q# z palety příkazů nebo klikněte pravým tlačítkem na složku v Průzkumník souborů a vyberte Vytvořit projekt Q#.	Další informace o projektech Q# najdete v tématu Práce s projekty Q#.
Ukázkové soubory	Do prázdného .qs souboru zadejte ukázky a pak ze seznamu možností vyberte ukázkový program.	Na paletě příkazů můžete také vybrat otevřít dětské hřiště QDK a otevřít online složku ukázkových programů Q# v Průzkumníku souborů.

Připojení k Azure Quantum

Úloha	Akce	Poznámky	Alternativní akce uživatele
Připojení k pracovnímu prostoru Azure Quantum	V Průzkumníku souborů rozbalte kvantové pracovní prostory a vyberte Přidat existující pracovní prostor. Podle pokynů vyberte předplatné a pracovní prostor.	Můžete se připojit k více pracovním prostorům. Pokud chcete připojit jiný pracovní prostor, vyberte + vedle kvantových pracovních prostorů . Připojení pracovních prostorů se uchovávají mezi relacemi VS Code.	Na paletě příkazů vyberte QDK: Připojit se k pracovnímu prostoru Azure Quantum.
Připojení programově pomocí programu v Pythonu	Klikněte pravým tlačítkem na existující připojení pracovního prostoru a vyberte Kopírovat kód Pythonu pro připojení k pracovnímu prostoru. Vložte výsledný kód do programu v Pythonu.	Další informace najdete v tématu Odesílání Pythonu s úlohami Q# do Azure Quantum.	–

Spouštění programů

Úloha	Akce	Poznámky	Alternativní akce uživatele
Spuštění programu Q# v místním kvantovém simulátoru	V programu Q# vyberte ikonu Spustit v pravém horním rohu a vyberte Spustit.	Další informace o kvantovém simulátoru najdete v řídkém kvantovém simulátoru.	Stiskněte Kombinaci kláves Ctrl + F5 nebo zvolte QDK: Spustit soubor a zobrazit histogram nebo QDK: Spustit soubor a zobrazit diagram obvodu na paletě příkazů nebo zvolte možnost Spustit kód nad operací vstupního bodu.
Odlaď program	V programu Q# vyberte ikonu Spustit v pravém horním rohu a zvolte Spustit ladění.	Další informace o ladicím programu Q# ve VS Code najdete v tématu Ladění a testování kvantového kódu.	Stiskněte F5 nebo v nabídce nad operací startovního bodu zvolte lupu kódu Ladění.
Zobrazit poskytovatele a cíle ve svých pracovních prostorech	V Průzkumníku souborů vyberte Kvantové pracovní prostory, rozbalte pracovní prostor a potom rozbalte zprostředkovatele , abyste viděli dostupné zprostředkovatele v pracovním prostoru. Rozbalte jednotlivého poskytovatele a zobrazte dostupné cíle.	Najeďte myší na název cíle, abyste zobrazili jeho stav a čas fronty před odesláním úlohy.	–
Odeslání úlohy do Azure Quantum	V programu Q# vyberte pracovní prostor, poskytovatele a cíl. Pokud chcete odeslat aktuální program Q#, vyberte šipku vedle cíle.	Další informace najdete v tématu Odesílání úloh Q# do Azure Quantum.	–
Zobrazení výsledků úlohy	Rozbalte pracovní prostor a potom rozbalte položku Úlohy. Pokud chcete otevřít výstup úlohy ze služby Azure Storage, vyberte ikonu cloudu vedle názvu úlohy.	Úlohy jsou uvedené od nejnovějších po nejstarší.	–