本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
輸入、輸出、環境變數和協助程式函數
除了構成完整演算法指令碼的檔案之外，您的混合任務還可以有額外的輸入和輸出。當您的混合任務開始時，AmazonRaket 會將作為混合任務建立一部分而提供的輸入複製到執行演算法指令碼的容器中。當混合任務完成時，演算法期間定義的所有輸出都會複製到指定的 Amazon S3 位置。
注意
演算法指標會即時回報，且不遵循此輸出程序。
Amazon Braket 也提供數個環境變數和協助程式函數，以簡化與容器輸入和輸出的互動。
本節說明 Amazon Braket Python SDK 所提供AwsQuantumJob.create函數的重要概念，及其與容器檔案結構的映射。
輸入
輸入資料：使用 input_data引數指定設定為字典的輸入資料檔案，即可將輸入資料提供給混合式演算法。使用者在 SDK 的 AwsQuantumJob.create函數中定義input_data引數。這會將輸入資料複製到環境變數 提供的位置的容器檔案系統"AMZN_BRAKET_INPUT_DIR"。如需如何在混合式演算法中使用輸入資料的幾個範例，請參閱 Amazon Braket Hybrid Jobs 中的 QAOA 和 Amazon Braket Hybrid Jobs Jupyter 筆記本中的 PennyLane
注意
當輸入資料很大 (>1GB) 時，提交混合任務之前會有很長的等待時間。這是因為本機輸入資料會先上傳至 S3 儲存貯體，然後將 S3 路徑新增至混合式任務請求，最後將混合式任務請求提交至 Braket 服務。
超參數：如果您傳入 hyperparameters，它們可在環境變數 下使用"AMZN_BRAKET_HP_FILE"。
檢查點：若要指定您想要在新混合任務中使用的job-arn檢查點，請使用 copy_checkpoints_from_job命令。此命令會透過檢查點資料複製到新混合任務checkpoint_configs3Uri的 ，使其可在任務執行AMZN_BRAKET_CHECKPOINT_DIR時環境變數指定的路徑中使用。預設值為 None，表示來自另一個混合任務的檢查點資料不會用於新的混合任務。
輸出
Quantum 任務：Quantum 任務結果存放在 S3 位置 s3://amazon-braket-<region>-<accountID>/jobs/<job-name>/tasks。
任務結果：您的演算法指令碼儲存至環境變數所提供目錄的所有內容"AMZN_BRAKET_JOB_RESULTS_DIR"都會複製到 中指定的 S3 位置output_data_config。如果您未指定此值，則預設為 s3://amazon-braket-<region>-<accountID>/jobs/<job-name>/<timestamp>/data。我們提供 SDK 協助程式函數 save_job_result ，當您從演算法指令碼呼叫 時，您可以使用它以字典的形式方便地存放結果。
檢查點：如果您想要使用檢查點，您可以將它們儲存在環境變數 提供的目錄中"AMZN_BRAKET_CHECKPOINT_DIR"。您也可以save_job_checkpoint改用 SDK 協助程式函數。
演算法指標：您可以將演算法指標定義為演算法指令碼的一部分，該指令碼會在混合任務執行時即時傳送到 Amazon CloudWatch，並在 Amazon Braket 主控台中顯示。如需如何使用演算法指標的範例，請參閱使用 Amazon Braket 混合任務來執行 QAOA 演算法。
環境變數
Amazon Braket 提供數個環境變數，以簡化與容器輸入和輸出的互動。以下程式碼列出 Braket 使用的環境變數。
-
AMZN_BRAKET_INPUT_DIR– 輸入資料目錄 opt/braket/input/data。 -
AMZN_BRAKET_JOB_RESULTS_DIR– 要寫入任務結果的輸出目錄 opt/braket/model。 -
AMZN_BRAKET_JOB_NAME– 任務的名稱。 -
AMZN_BRAKET_CHECKPOINT_DIR– 檢查點目錄。 -
AMZN_BRAKET_HP_FILE– 包含超參數的檔案。 -
AMZN_BRAKET_DEVICE_ARN– 裝置 ARN (AWS 資源名稱）。 -
AMZN_BRAKET_OUT_S3_BUCKET– 輸出 Amazon S3 儲存貯體，如CreateJob請求的 中所指定OutputDataConfig。 -
AMZN_BRAKET_SCRIPT_ENTRY_POINT–CreateJob請求的 中指定的進入點ScriptModeConfig。 -
AMZN_BRAKET_SCRIPT_COMPRESSION_TYPE–CreateJob請求的 中指定的壓縮類型ScriptModeConfig。 -
AMZN_BRAKET_SCRIPT_S3_URI– 使用者指令碼的 Amazon S3 位置，如CreateJob請求的 中所指定ScriptModeConfig。 -
AMZN_BRAKET_TASK_RESULTS_S3_URI– 軟體開發套件預設會存放任務量子任務結果的 Amazon S3 位置。 -
AMZN_BRAKET_JOB_RESULTS_S3_PATH– 存放任務結果的 Amazon S3 位置，如CreateJob請求的 中所指定OutputDataConfig。 -
AMZN_BRAKET_JOB_TOKEN– 對於在任務容器中建立CreateQuantumTask的量子任務，應該傳遞至 的jobToken參數的字串。
協助程式函數
Amazon Braket 提供多種協助程式函數，可簡化與容器輸入和輸出的互動。這些協助程式函數會從用來執行混合任務的演算法指令碼中呼叫。下列範例示範如何使用它們。
get_checkpoint_dir() # Get the checkpoint directory get_hyperparameters() # Get the hyperparameters as strings get_input_data_dir() # Get the input data directory get_job_device_arn() # Get the device specified by the hybrid job get_job_name() # Get the name of the hybrid job. get_results_dir() # Get the path to a results directory save_job_result() # Save hybrid job results save_job_checkpoint() # Save a checkpoint load_job_checkpoint() # Load a previously saved checkpoint
