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

# 使用 執行範例 Amazon Bedrock API 請求 AWS Command Line Interface
<a name="getting-started-api-ex-cli"></a>

本節會引導您使用 在 Amazon Bedrock 中嘗試一些常見操作 AWS Command Line Interface ，以測試您的許可和身分驗證是否已正確設定。在執行下列範例之前，您應該檢查是否符合下列必要條件：

**先決條件**
+ 您有 AWS 帳戶 和已設定身分驗證的使用者或角色，以及 Amazon Bedrock 的必要許可。否則，請依照 [開始使用 API](getting-started-api.md) 中的步驟進行。
+ 您已安裝並設定 AWS CLI的身分驗證。若要安裝 AWS CLI，請遵循[安裝或更新至最新版本 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)中的步驟。遵循 [取得憑證以授予程式設計存取權](getting-started-api.md#gs-grant-program-access) 中的步驟，確認您已設定憑證來使用 CLI。

使用您以適當許可設定的使用者或角色，測試您的 Amazon Bedrock 許可是否已正確設定。

**Topics**
+ [列出 Amazon Bedrock 必須提供的基礎模型](#getting-started-api-ex-cli-listfm)
+ [向模型提交文字提示，並使用 InvokeModel 產生文字回應](#getting-started-api-ex-cli-invoke-text)
+ [向模型提交文字提示，並使用 Converse 產生文字回應](#getting-started-api-ex-cli-converse)

## 列出 Amazon Bedrock 必須提供的基礎模型
<a name="getting-started-api-ex-cli-listfm"></a>

下列範例使用 執行 [ListFoundationModels](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListFoundationModels.html) 操作 AWS CLI。 `ListFoundationModels`列出您區域中 Amazon Bedrock 中可用的基礎模型 (FMs)。在終端機中，執行下列命令：

```
aws bedrock list-foundation-models
```

如果命令成功，回應會傳回 Amazon Bedrock 中可用的基礎模型清單。

## 向模型提交文字提示，並使用 InvokeModel 產生文字回應
<a name="getting-started-api-ex-cli-invoke-text"></a>

下列範例使用 執行 [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) 操作 AWS CLI。 `InvokeModel`可讓您提交提示以產生模型回應。在終端機中，執行下列命令：

```
aws bedrock-runtime invoke-model \
--model-id amazon.titan-text-express-v1 \
--body '{"inputText": "Describe the purpose of a \"hello world\" program in one line.", "textGenerationConfig" : {"maxTokenCount": 512, "temperature": 0.5, "topP": 0.9}}' \
--cli-binary-format raw-in-base64-out \
invoke-model-output-text.txt
```

如果命令成功，則模型產生的回應會寫入 `invoke-model-output-text.txt` 檔案。文字回應以及隨附的資訊會在 `outputText` 欄位中傳回。

## 向模型提交文字提示，並使用 Converse 產生文字回應
<a name="getting-started-api-ex-cli-converse"></a>

下列範例使用 執行 [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) 操作 AWS CLI。 `Converse`可讓您提交提示以產生模型回應。建議在支援時對 `InvokeModel` 使用 `Converse` 操作，因為它會統一跨 Amazon Bedrock 模型的推論請求，並簡化多回合對話的管理。在終端機中，執行下列命令：

```
aws bedrock-runtime converse \
--model-id amazon.titan-text-express-v1 \
--messages '[{"role": "user", "content": [{"text": "Describe the purpose of a \"hello world\" program in one line."}]}]' \
--inference-config '{"maxTokens": 512, "temperature": 0.5, "topP": 0.9}'
```

如果命令成功，則 `text` 欄位中會傳回模型產生的回應，以及隨附的資訊。