View a markdown version of this page

API 入門 - Amazon Nova
取得憑證以授予程式設計存取權將 Amazon Bedrock 許可連接至使用者或角色使用 Amazon Nova 模型為文字提示詞產生回應

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

API 入門

開始使用 APIs 之前，如果您剛開始使用 AWS 或需要安裝 AWS CLI 或 AWS SDK，請遵循這些程序。如果兩者都不適用於您，請移至 取得憑證以授予程式設計存取權。

如果您沒有 AWS 帳戶，請在繼續之前建立一個帳戶。或者，您也可以前往 nova.amazon.com/dev：// 開始使用 Amazon Nova 免費建置。

註冊 AWS 帳戶

若要開始使用 AWS，您需要 AWS 帳戶。如需建立 的相關資訊 AWS 帳戶，請參閱《 AWS 帳戶管理 參考指南》中的 入門 AWS 帳戶。

若要安裝 AWS CLI，請遵循安裝或更新至最新版本 CLI AWS中的步驟。

若要安裝 AWS SDK，請選取對應至您要在 Tools to Build on AWS中使用的程式設計語言的標籤。

AWS 軟體開發套件 (SDKs) 適用於許多熱門的程式設計語言。每個 SDK 都提供 API、程式碼範例和文件，讓開發人員更輕鬆地以他們偏好的語言建置應用程式。SDK 會自動為您執行有用的任務，例如：

  • 加密簽署服務請求

  • 重試請求

  • 處理錯誤回應

取得憑證以授予程式設計存取權

如果使用者想要在 AWS 管理主控台 AWS 外部與 互動，則需要程式設計存取。授予程式設計存取權的方式取決於正在存取的使用者類型 AWS。

若要授與使用者程式化存取權，請選擇下列其中一個選項。

哪個主體需要程式設計存取權？ 到 根據
IAM 使用者 限制長期憑證的持續時間，以簽署對 AWS CLI、 AWS SDKs程式設計請求。 AWS APIs 請依照您要使用的介面所提供的指示操作。
IAM 角色 使用暫時登入資料簽署對 AWS CLI、 AWS SDKs程式設計請求。 AWS APIs 請遵循《IAM 使用者指南》中的將臨時登入資料與 AWS 資源搭配使用中的指示。
在 IAM Identity Center 中管理的使用者 使用暫時登入資料簽署對 AWS CLI、 AWS SDKs程式設計請求。 AWS APIs 請依照您要使用的介面所提供的指示操作。

將 Amazon Bedrock 許可連接至使用者或角色

設定程式設計存取的登入資料後，您需要設定使用者或 IAM 角色的許可，才能存取 Amazon Bedrock 相關動作。若要設定這些許可，請執行下列動作：

  1. 在 AWS 管理主控台首頁上，選取 IAM 服務或導覽至位於 https：//https://console.aws.amazon.com/iam/ 的 IAM 主控台。

  2. 選取使用者或角色，然後選取您的使用者或角色。

  3. 在許可索引標籤中，選擇新增許可，然後選擇新增 AWS 受管政策。選擇 AmazonBedrockFullAccess AWS 受管政策。

  4. 若要允許使用者或角色訂閱模型，請選擇建立內嵌政策，然後在 JSON 編輯器中指定下列許可：

    {
  "Version": "2012-10-17",	
  "Statement": [
    {
      "Sid": "MarketplaceBedrock",
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ViewSubscriptions",
        "aws-marketplace:Unsubscribe",
        "aws-marketplace:Subscribe"
      ],
      "Resource": "*"
    }
  ]
}

使用 Amazon Nova 模型為文字提示詞產生回應

滿足所有先決條件之後，您可以使用 Converse 請求測試對 Amazon Nova 模型提出模型調用請求。

若要安裝 AWS CLI，請依照安裝或更新至最新版本的 AWS CLI 中的步驟進行。遵循 取得憑證以授予程式設計存取權 中的步驟，確認您已設定憑證來使用 Boto3。

若要使用 AWS CLI 在 Nova 2 Lite 中產生文字提示的回應，請在終端機中執行下列命令：

aws bedrock-runtime converse \
  --model-id us.amazon.nova-2-lite-v1:0 \
  --messages '[{"role":"user","content":[{"text":"Write a short poem"}]}]' \
  --additional-model-request-fields '{"reasoningConfig":{"type":"enabled","maxReasoningEffort":"low"}}'