# Amazon Nova の開始方法 **注記** このドキュメントは Amazon Nova バージョン 1 を対象としています。Amazon Nova 2 が新しいモデルと拡張機能で利用可能になりました。Amazon Nova 2 の開始方法については、「[Amazon Nova 2 の開始方法](https://docs.aws.amazon.com/nova/latest/nova2-userguide/getting-started-nova-2.html)」を参照してください。 Amazon Nova モデルは、Amazon Bedrock [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) または [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) API オペレーションを使用した API を介して呼び出すか、[Amazon Bedrock Chat および Text プレイグラウンド](https://docs.aws.amazon.com/bedrock/latest/userguide/playgrounds.html)を介して使用することができます。 **重要** AWS または Amazon Bedrock を初めて使用する場合、まず「[Amazon Bedrock の開始方法](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html)」の手順に従って Amazon Bedrock を設定する必要があります。 または、「[https://nova.amazon.com](https://nova.amazon.com/chat)」で Amazon Bedrock を入力せずに Amazon Nova モデルを試すこともできます。 Amazon Nova の使用を開始する方法に一致するトピックを選択してください。 **Topics** + [Amazon Bedrock コンソールで Amazon Nova の使用を開始する](getting-started-console.md) + [API の開始方法](getting-started-api.md) # Amazon Bedrock コンソールで Amazon Nova の使用を開始する **注記** このドキュメントは Amazon Nova バージョン 1 を対象としています。Amazon Nova 2 が新しいモデルと拡張機能で利用可能になりました。Amazon Nova 2 の開始方法については、「[Amazon Bedrock コンソールで Amazon Nova 2 の使用を開始する](https://docs.aws.amazon.com/nova/latest/nova2-userguide/getting-started-console.html)」を参照してください。 このセクションでは、AWS コンソールのプレイグラウンドを使用し、Amazon Nova モデルにテキストプロンプトを送信してテキストまたは画像レスポンスを生成する方法について説明します。次の例を実行する前に、次の前提条件が満たされていることを確認してください。 **前提条件** + AWS アカウント を持ち、Amazon Bedrock に必要なアクセス許可を持つそのアカウントのロールにアクセスする権限がある。そうでない場合、「[Amazon Bedrock の開始方法](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html)」の手順に従ってください。 + Amazon Nova モデルへのアクセスをリクエスト済みである。そうでない場合、「[Amazon Bedrock 基盤モデルへのアクセスをリクエストする](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html#getting-started-model-access)」のステップに従い、**[Amazon Nova Lite]** および **[Amazon Nova Canvas]** へのアクセスをリクエストしてください。 + 米国東部 (バージニア北部) リージョンにいる。リージョンを変更するには、IAM ロールの横にあるコンソールの右上にあるリージョン名を選択します。米国東部 (バージニア北部) (us-east-1) を選択します。 **Topics** + [モデルアクセスのリクエスト](#getting-started-access) + [テキストプレイグラウンドを調べる](#getting-started-text) + [イメージプレイグラウンドを調べる](#getting-started-image) ## モデルアクセスのリクエスト Amazon Nova モデルへのアクセスをリクエストするには、次の手順を実行します。 1. Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/)) を開きます。 1. 左側のナビゲーションペインで **[Bedrock 設定]** の **[モデルアクセス]** を選択します。 1. **[モデルアクセスとは]** で **[特定のモデルを有効にする]** を選択します。 1. **[ベースモデル]** リストから **[Nova Lite]** および **[Nova Canvas]** を選択します。このセクションの例ではこの 2 つのモデルのみを使用していますが、すべての Amazon Nova モデルへのアクセスをリクエストできます。その後、**[Next]** (次へ) を選択します。 1. **[確認と送信]** ページで **[送信]** を選択します。 1. **[基本モデル]** テーブルを更新します。Amazon Nova モデルが **[アクセス権を付与済]** ステータスになっている場合、例の次の部分に進むことができます。 モデルへのアクセスをリクエストしたリージョンからしか、そのモデルは使用できないことに注意してください。 ## テキストプレイグラウンドを調べる 次の例は、テキストプレイグラウンドの使用方法を示します。 1. Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/)) を開きます。 1. 左側のナビゲーションペインで **[プレイグラウンド]** の **[チャット/テキスト]** を選択します。 1. **[モデルを選択]** を選択し、プロバイダーとモデルを選択します。この例では、**[Amazon]** を選択したら **[Nova Lite]** を選択します。次に、**[適用]** を選択します。 1. テキストパネルの下からデフォルトのプロンプトを選択するか、「**Describe the purpose of a "hello world" program in one line**」などのプロンプトをテキストパネルに入力します。 1. Amazon Nova の画像理解機能を探索するため、コンピュータから 25 MB 以下の JPEG、PNG、GIF、WEBP 形式で画像をアップロードできます。画像がアップロードされたら、画像について Amazon Nova に質問できます。 1. Amazon Nova のドキュメント理解機能を試すには、CSV、DOC、DOCX、HTML、MD、PDF、TXT、XLS、XLSX 形式で 4.5 MB 以下のドキュメントをアップロードしてみましょう。ドキュメントをアップロードしたら、Amazon Nova にドキュメントについて質問できます。 1. Amazon Nova の動画理解機能を試すには、コンピュータから MKV、MOV、MP4 形式で 25 MB 以下の動画を 1 つアップロードします。Amazon S3 は最大 1 GB の動画に使用できます。動画がアップロードされたら、その動画について Amazon Nova に質問できます。 1. **[実行]** を選択して、モデルで推論を実行します。生成されたテキストは、テキストパネルのプロンプトの下に表示されます。 ## イメージプレイグラウンドを調べる 次の例は、イメージプレイグラウンドの使用方法を示します。 1. Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/)) を開きます。 1. 左側のナビゲーションペインで、**[プレイグラウンド]** の **[画像/動画]** を選択します。 1. **[モデルを選択]** を選択し、プロバイダーとモデルを選択します。この例では、**[Amazon]** を選択したら **[Nova Canvas]** を選択します。次に、**[適用]** を選択します。 1. テキストパネルの下からデフォルトのプロンプトを選択するか、「**Generate an image of happy cats**」などのプロンプトをテキストパネルに入力します。 1. **[設定]** ペインで、**[画像の数]** を [**1**] に変更します。 1. **[実行]** を選択して、モデルで推論を実行します。生成されたイメージがプロンプトの上に表示されます。 # API の開始方法 **注記** このドキュメントは Amazon Nova バージョン 1 を対象としています。Amazon Nova 2 が新しいモデルと拡張機能で利用可能になりました。Amazon Nova 2 の開始方法については、「[API の開始方法](https://docs.aws.amazon.com/nova/latest/nova2-userguide/getting-started-api.html)」を参照してください。 API の使用を開始するには、プログラムによるアクセス権を付与するために認証情報が必要です。次のセクションが該当している場合、展開して指示に従ってください。該当しない場合は、その後のセクションに進みます。 ## 私は AWS を初めて使用します AWS アカウント がない場合は、以下のステップを実行して作成します。 **AWS アカウント にサインアップするには** 1. [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup) を開きます。 1. オンラインの手順に従います。 サインアップ手順の一環として、電話またはテキストメッセージを受け取り、電話キーパッドで検証コードを入力します。 AWS アカウントにサインアップすると、*AWS アカウントのルートユーザー*が作成されます。ルートユーザーには、アカウントのすべての AWS のサービス とリソースへのアクセス権があります。セキュリティのベストプラクティスとして、ユーザーに管理アクセスを割り当て、ルートユーザーのみを使用して[ルートユーザーアクセスが必要なタスク](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)を実行してください。 サインアップ処理が完了すると、AWS からユーザーに確認メールが送信されます。[https://aws.amazon.com/](https://aws.amazon.com/) の **[マイアカウント]** をクリックして、いつでもアカウントの現在のアクティビティを表示し、アカウントを管理することができます。 **AWS アカウントのルートユーザー をセキュリティで保護する** 1. **[ルートユーザー]** を選択し、AWS アカウント のメールアドレスを入力して、アカウント所有者として [AWS マネジメントコンソール](https://console.aws.amazon.com/) にサインインします。次のページでパスワードを入力します。 ルートユーザーを使用してサインインする方法については、「*AWS サインイン ユーザーガイド*」の「[ルートユーザーとしてサインインする](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial)」を参照してください。 1. ルートユーザーの多要素認証 (MFA) を有効にします。 手順については、「*IAM ユーザーガイド*」の「[AWS アカウント ルートユーザーの仮想 MFA デバイスを有効にする (コンソール)](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html)」を参照してください。 ## AWS CLI または AWS SDK をインストールする必要があります AWS CLI をインストールするには、「[Install or update to the latest version of the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)」の手順に従います。 AWS SDK をインストールするには、「[AWS での構築ツール](https://aws.amazon.com/developer/tools/)」で使用するプログラミング言語に対応するタブを選択します。AWS Software Development Kit (SDK) は、多くの一般的なプログラミング言語で使用できます。各 SDK には、デベロッパーが好みの言語でアプリケーションを簡単に構築できるようになる API、コード例、およびドキュメントが提供されています。SDK は、次のような便利なタスクを自動的に実行します。 + サービスリクエストに暗号署名する + リクエストを再試行する + エラー応答を処理する ## プログラムによるアクセス権を付与するために認証情報を取得する AWS マネジメントコンソール の外部で AWS を操作するには、プログラマチックアクセス権が必要です。プログラムによるアクセス権を付与する方法は、AWS にアクセスしているユーザーのタイプによって異なります。 ユーザーにプログラムによるアクセス権を付与するには、以下のいずれかのオプションを選択します。 **** | プログラムによるアクセス権が必要なプリンシパル | 目的 | 方法 | | --- | --- | --- | | IAM ユーザー | 長期的な認証情報の期間を制限し、AWS CLI、AWS SDK、AWS API へのプログラムによるリクエストに署名します。 | 使用するインターフェイスの指示に従ってください。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/nova/latest/userguide/getting-started-api.html) | | IAM ロール | 一時的な認証情報を使用して、AWS CLI、AWS SDK、または AWS API へのプログラムによるリクエストに署名します。 | IAM ユーザーガイドの「[AWS リソースでの一時的な認証情報の使用](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html)」の指示に従ってください。 | | ワークフォースアイデンティティ (IAM アイデンティティセンターで管理されているユーザー) | 一時的な認証情報を使用して、AWS CLI、AWS SDK、または AWS API へのプログラムによるリクエストに署名します。 | 使用するインターフェイスの指示に従ってください。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/nova/latest/userguide/getting-started-api.html) | ## IAM ユーザー用にアクセスキーを作成する方法 IAM ユーザー用にアクセスキーを使用する場合、AWS では制限付きインラインポリシーを含めて IAM ユーザーの有効期限を設定することが推奨されます。 **重要** 次の警告に注意してください。 AWS リソースにアクセスする際に、お使いのアカウントのルート認証情報を**使用しないでください**。これらの認証情報は無制限のアカウントアクセスを提供し、取り消すのが困難です。 アプリケーションファイルにリテラルアクセスキーや認証情報を**配置しないでください**。これを行うと、パブリックリポジトリにプロジェクトをアップロードするなど、誤って認証情報が公開されるリスクが発生します。 プロジェクト領域に認証情報を含むファイルを**含めないでください**。 アクセスキーを安全に管理します。[アカウント識別子を確認する](https://docs.aws.amazon.com/general/latest/gr/acct-identifiers.html)ためであっても、アクセスキーを認可されていない当事者に提供しないでください。提供すると、第三者がアカウントへの永続的なアクセスを取得する場合があります。 共有 AWS 認証情報ファイルに格納された認証情報はプレーンテキストで格納されることに注意してください。 詳細については、「AWS 全般のリファレンス」の「[AWS アクセスキーを管理するためのベストプラクティス](https://docs.aws.amazon.com/general/latest/gr/aws-access-keys-best-practices.html)」を参照してください。 **IAM ユーザーの作成** 1. AWS マネジメントコンソール ホームページで、IAM サービスを選択するか、[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) で IAM コンソールに移動します。 1. ナビゲーションペインで **[ユーザー]**、**[ユーザーの作成]** の順に選択します。 1. IAM コンソールのガイダンスに従って、AWS マネジメントコンソール へのアクセスなしで、アクセス許可もないプログラム型ユーザーを設定します。 **制限された時間枠にユーザーアクセスを制限する** 作成する IAM ユーザーアクセスキーは長期的な認証情報です。これらの認証情報が誤って処理された場合に有効期限が切れるようにするには、キーの有効性が切れる日付を指定したインラインポリシーを作成して、これらの認証情報に期限を設定することができます。 1. 先ほど作成した IAM ユーザーを開きます。**[アクセス許可]** タブで **[アクセス許可の追加]** を選択したら、**[インラインポリシーの作成]** を選択します。 1. JSON エディタで、次のアクセス許可を指定します。このポリシーを使用するには、ポリシー例の `aws:CurrentTime` タイムスタンプ値の値を独自の終了日に置き換えます。 **注記** IAM では、アクセスキーを 12 時間に制限することが推奨されます。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Deny", "Action": "*", "Resource": "*", "Condition": { "DateGreaterThan": { "aws:CurrentTime": "2024-01-01T00:00:00Z" } } } ] } ``` ------ **アクセスキーの作成** 1. **[ユーザー詳細]** のページで **[セキュリティ認証情報]** タブを選択します。[**Access keys (アクセスキー)**] セクションで、[**Create access key (アクセスキーを作成)**] を選択します。 1. これらのアクセスキーを **[その他]** として使用することを示して、**[アクセスキーの作成]** を選択します。 1. **[Retrieve access key]** (アクセスキーの取得) ページで、**[Show]** (表示) を選択し、ユーザーのシークレットアクセスキーの値を表示します。認証情報をコピーするか、csv ファイルをダウンロードできます。 **重要** この IAM ユーザーが不要になったら、削除して[AWS セキュリティのベストプラクティス](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#lock-away-credentials)に準拠させることをお勧めします。AWS にアクセスする際、[AWS IAM アイデンティティセンター](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html)を介して一時的な認証情報を使用することを、人間のユーザーに求めることをお勧めします。 ## ユーザーまたはロールに Amazon Bedrock のアクセス許可をアタッチする プログラムによるアクセス権の認証情報を設定したら、Amazon Bedrock 関連の一連のアクションにアクセスできるように、ユーザーまたは IAM ロールのアクセス許可を設定する必要があります。これらのアクセス許可を設定するには、次の手順を実行します。 1. AWS マネジメントコンソール ホームページで、IAM サービスを選択するか、[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) で IAM コンソールに移動します。 1. **[ユーザー]** または **[ロール]** を選択して、ユーザーまたはロールを指定します。 1. **[アクセス許可]** タブで **[アクセス許可の追加]** を選択してから、**[AWS 管理ポリシーの追加]** を選択します。「[AmazonBedrockFullAccess]()」のAWS 管理ポリシーを選択します。 1. ユーザーまたはロールにモデルへのサブスクライブを許可するには、**[インラインポリシーの作成]** を選択して JSON エディタで次のアクセス許可を指定します。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "MarketplaceBedrock", "Effect": "Allow", "Action": [ "aws-marketplace:ViewSubscriptions", "aws-marketplace:Unsubscribe", "aws-marketplace:Subscribe" ], "Resource": "*" } ] } ``` ------ ## Amazon Nova モデルへのアクセスをリクエストする 「[Amazon Bedrock 基盤モデルへのアクセスをリクエストする](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html#getting-started-model-access)」の手順に従って、Amazon Bedrock コンソールを介して Amazon Nova モデルへのアクセスをリクエストします。 ## Amazon Nova モデルを使用してテキストプロンプトのレスポンスを生成する すべての前提条件を満たしたら、タブを選択して [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) リクエストで Amazon Nova モデルにモデル呼び出しリクエストを行うテストを実施し、タブで指定された方法を使用します。 ------ #### [ AWS CLI ] AWS CLI をインストールするには、「[Install or update to the latest version of the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)」の手順に従います。「[プログラムによるアクセス権を付与するために認証情報を取得する](#grant-program-access)」の手順に従って、Boto3 を使用するための認証情報を設定していることを確認します。 AWS CLI を使用して Amazon Nova Lite でテキストプロンプトのレスポンスを生成するには、ターミナルで次のコマンドを実行します。 ``` aws bedrock-runtime converse \ --model-id us.amazon.nova-lite-v1:0 \ --messages '[{"role": "user", "content": [{"text": "Write a short poem"}]}]' ``` ------ #### [ Python (Boto3) ] Boto3 をインストールするには、Boto3 ドキュメントの「[クイックスタート](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html)」の手順に従います。「[プログラムによるアクセス権を付与するために認証情報を取得する](#grant-program-access)」の手順に従って、Boto3 を使用するための認証情報を設定していることを確認します。 Python SDK (Boto3) を使用し、Amazon Bedrock ランタイムクライアントを作成して Amazon Nova Lite でテキストプロンプトのレスポンスを生成するには、次の Python スクリプトを実行します。 ``` import boto3 import json client = boto3.client(service_name="bedrock-runtime") messages = [ {"role": "user", "content": [{"text": "Write a short poem"}]}, ] model_response = client.converse( modelId="us.amazon.nova-lite-v1:0", messages=messages ) print("\n[Full Response]") print(json.dumps(model_response, indent=2)) print("\n[Response Content Text]") print(model_response["output"]["message"]["content"][0]["text"]) ``` ------ #### [ LangChain ] AWS の LangChain をインストールするには、LangChain ドキュメントの「[AWS](https://python.langchain.com/docs/integrations/providers/aws/)」の手順に従います。「[プログラムによるアクセス権を付与するために認証情報を取得する](#grant-program-access)」の手順に従って、Boto3 を使用するための認証情報を設定していることを確認します。 LangChain を使用して Amazon Nova Lite でテキストプロンプトのレスポンスを生成するには、次のスクリプトを実行します。 ``` from langchain_aws import ChatBedrockConverse llm = ChatBedrockConverse(model="us.amazon.nova-lite-v1:0") messages = [ ("user", "Write a short poem") ] llm.invoke(messages) ``` ------ Amazon Nova に慣れたら、高度なタスクに進むことができます。 1. 画像または動画を記述するように、モデルにプロンプトを行ってみてください。詳細については、「[Amazon Nova のマルチモーダルサポート](modalities.md)」を参照してください。 1. Amazon Nova Canvas を使用して画像を生成してみてください。詳細については、「[Amazon Nova Canvas を使用した画像の生成](image-generation.md)」を参照してください。 1. Amazon Nova Reel を使用して動画を生成してみてください。詳細については、「[Amazon Nova Reel を使用した動画生成](video-generation.md)」を参照してください。 1. モデルにドキュメントを送信して、その内容について質問します。詳細については、「[ドキュメント理解](modalities-document.md)」を参照してください。 1. モデルにツールを提供して、ツールの使用を確認するためにプロンプトでリクエストを行います。詳細については、「[Amazon Nova でのツールの使用 (関数呼び出し)](tool-use.md)」を参照してください。