本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 建立並提交範例 OpenQASM 3.0 量子任務
<a name="braket-openqasm-create-submit-task"></a>

您可以使用 Amazon Braket Python SDK、Boto3 或 AWS CLI ，將 OpenQASM 3.0 量子任務提交至 Amazon Braket 裝置。

**Topics**
+ [OpenQASM 3.0 程式範例](#braket-openqasm-example-program)
+ [使用 Python SDK 建立 OpenQASM 3.0 量子任務](#braket-openqasm-create-tasks-with-python-sdk)
+ [使用 Boto3 建立 OpenQASM 3.0 量子任務](#braket-openqasm-create-tasks-with-boto3)
+ [使用 AWS CLI 建立 OpenQASM 3.0 任務](#braket-openqasm-create-tasks-with-aws-cli)

## OpenQASM 3.0 程式範例
<a name="braket-openqasm-example-program"></a>

若要建立 OpenQASM 3.0 任務，您可以從準備 [GHZ 狀態](https://en.wikipedia.org/wiki/Greenberger%E2%80%93Horne%E2%80%93Zeilinger_state)的基本 OpenQASM 3.0 程式 (ghz.qasm) 開始，如下列範例所示。

```
// ghz.qasm
// Prepare a GHZ state
OPENQASM 3;

qubit[3] q;
bit[3] c;

h q[0];
cnot q[0], q[1];
cnot q[1], q[2];

c = measure q;
```

## 使用 Python SDK 建立 OpenQASM 3.0 量子任務
<a name="braket-openqasm-create-tasks-with-python-sdk"></a>

您可以使用 [Amazon Braket Python SDK](https://github.com/aws/amazon-braket-sdk-python)，將此程式提交至具有下列程式碼的 Amazon Braket 裝置。請務必將範例 Amazon S3 儲存貯體位置「amzn-s3-demo-bucket」取代為您自己的 Amazon S3 儲存貯體名稱。

```
with open("ghz.qasm", "r") as ghz:
    ghz_qasm_string = ghz.read()

# Import the device module
from braket.aws import AwsDevice
# Choose the Rigetti device
device = AwsDevice("arn:aws:braket:us-west-1::device/qpu/rigetti/Ankaa-3")
from braket.ir.openqasm import Program

program = Program(source=ghz_qasm_string)
my_task = device.run(program)

# Specify an optional s3 bucket location and number of shots
s3_location = ("amzn-s3-demo-bucket", "openqasm-tasks")
my_task = device.run(
    program,
    s3_location,
    shots=100,
)
```

## 使用 Boto3 建立 OpenQASM 3.0 量子任務
<a name="braket-openqasm-create-tasks-with-boto3"></a>

您也可以使用 [AWS Python SDK for Braket (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/braket.html)，使用 OpenQASM 3.0 字串建立量子任務，如下列範例所示。下列程式碼片段參考 ghz.qasm，以準備 [GHZ 狀態](https://en.wikipedia.org/wiki/Greenberger%E2%80%93Horne%E2%80%93Zeilinger_state)，如上所示。

```
import boto3
import json

my_bucket = "amzn-s3-demo-bucket"
s3_prefix = "openqasm-tasks"

with open("ghz.qasm") as f:
    source = f.read()

action = {
    "braketSchemaHeader": {
        "name": "braket.ir.openqasm.program",
        "version": "1"
    },
    "source": source
}
device_parameters = {}
device_arn = "arn:aws:braket:us-west-1::device/qpu/rigetti/Ankaa-3"
shots = 100

braket_client = boto3.client('braket', region_name='us-west-1')
rsp = braket_client.create_quantum_task(
    action=json.dumps(
        action
    ),
    deviceParameters=json.dumps(
        device_parameters
    ),
    deviceArn=device_arn,
    shots=shots,
    outputS3Bucket=my_bucket,
    outputS3KeyPrefix=s3_prefix,
)
```

## 使用 AWS CLI 建立 OpenQASM 3.0 任務
<a name="braket-openqasm-create-tasks-with-aws-cli"></a>

[AWS Command Line Interface (CLI)](https://aws.amazon.com/cli/) 也可以用來提交 OpenQASM 3.0 程式，如下列範例所示。

```
aws braket create-quantum-task \
    --region "us-west-1" \
    --device-arn "arn:aws:braket:us-west-1::device/qpu/rigetti/Ankaa-3" \
    --shots 100 \
    --output-s3-bucket "amzn-s3-demo-bucket" \
    --output-s3-key-prefix "openqasm-tasks" \
    --action '{
        "braketSchemaHeader": {
            "name": "braket.ir.openqasm.program",
            "version": "1"
        },
        "source": $(cat ghz.qasm)
    }'
```