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

# HealthOmics 入門
<a name="getting-started"></a>

若要開始使用 HealthOmics，請確定您已正確設定 [ HealthOmics 的 IAM 許可和角色](https://docs.aws.amazon.com/omics/latest/dev/setting-up-new.html#setting-up-create-iam-user)。

## 在 HealthOmics 主控台中使用 Ready2Run 工作流程
<a name="ready2run-workflow"></a>

下列練習示範如何使用 Ready2Run 工作流程。Ready2Run 工作流程已預先設定執行工作流程所需的參數和工具參考。工作流程發佈者提供範例資料，因此您不需要建立自己的資料。

1. 開啟 [HealthOmics 主控台](https://console.aws.amazon.com/omics/)。

1. 選取左上方的導覽窗格 (≡)，然後選取 **Ready2Run 工作流程**。

1. 在 **Ready2Run 工作流程**頁面上，選擇**ESMFold for up to 800 residues**工作流程。主控台會開啟該工作流程的詳細資訊頁面。

1. 詳細資訊索引標籤提供工作流程的相關資訊。若要試用工作流程，請在頁面右上角選取**開始執行**。

1. 在**指定執行詳細資訊**頁面中，輸入執行名稱。

1. 輸入或選取執行輸出的 Amazon S3 位置。

1. 針對**執行中繼資料保留模式**，選擇是否要保留或移除 Runmeta 資料。

1. 在**服務角色**面板中，選擇**建立並使用新的服務角色**。

1. 選擇**下一步**。

1. 在**新增參數值**頁面上，選擇**使用 Ready2Run 測試資料執行工作流程**。

1. 選擇**下一步**。

1. 檢閱您的輸入，然後選擇**開始執行**。

## Amazon Q CLI 的範例提示
<a name="omics-q-prompts"></a>

Amazon Q CLI 可以使用 AWS HealthOmics 自然語言命令在 中執行基因體工作流程和分析任務。下列範例提示可讓您建立工作流程、管理執行和分析基因體資料。如需 HealthOmics 的詳細資訊和範例提示，請參閱 GitHub 上的 [HealthOmics Agentic 生成式 AI 教學](https://github.com/aws-samples/aws-healthomics-tutorials/tree/main/generative-ai)課程。
+ 「建立將在 HealthOmics 上執行`main.wdl`的 WDL 1.1 工作流程檔案。工作流程會將參考基因體做為輸入和一組 fastq 檔案。它將使用 BWA 為參考基因體編製索引，然後將每對 fastq 檔案映射至參考。最後，將每個映射的 BAM 合併至單一 BAM 檔案，並輸出此檔案及其 bai 索引。」
+ 「封裝工作流程並在 HealthOmics 中建立工作流程」
+ 「更新 input.json 檔案以使用來自我的 Amazon S3 儲存貯體的真實檔案`omics-my-bucket-with-genome-data`」（提供特定的 Amazon S3 儲存貯體位置，或讓 Amazon Q 探索）
+ 「在 Amazon ECR 儲存庫中尋找合適的容器並更新 input.json 以使用這些容器」
+ 「尋找或建立適當的 IAM 角色以在執行工作流程時使用」
+ 「為我的工作流程建立執行快取」
+ 「在 HealthOmics 中執行工作流程」
+ 「檢查執行的狀態」

**警告**  
使用 Amazon Q CLI 時，請先檢閱所有產生的內容和建議的動作，再繼續。提供意見回饋以改善回應品質，並符合您工作流程的需求。如需詳細資訊，請參閱 Amazon Q [的安全考量和最佳實務](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-chat-security.html)。