ユーザー用に Amazon Q Developer を設定する - Amazon SageMaker AI

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ユーザー用に Amazon Q Developer を設定する

Amazon Q Developer は生成 AI 会話アシスタントです。Amazon Q Developer は、新しいドメインまたは既存のドメイン内に設定できます。次の情報を使用して Amazon Q Developer をセットアップします。

Amazon Q Developer を使用すると、ユーザーは次のことができます。

  • SageMaker AI 機能を個別に、または他の AWS サービスと組み合わせて使用するためのstep-by-stepガイダンスを受け取ります。

  • データ準備、トレーニング、推論、MLOps などの ML タスクを開始するサンプルコードを取得する。

  • コードの実行中に発生したエラーをデバッグして解決するためのトラブルシューティングサポートを受けることができます。

注記

無料利用枠サブスクリプションとプロ階層サブスクリプションのどちらを使用している場合も、Studio の Amazon Q Developer がサービスを改善する目的でユーザーコンテンツを使用することはありません。IDE レベルのテレメトリ共有の場合、Amazon Q は、質問の数やレコメンデーションが受け入れられたかどうかなど、ユーザーの使用状況を追跡することがあります。このテレメトリデータには、ユーザーの IP アドレスなどの個人を特定できる情報は含まれません。データ保護とオプトアウトの手順の詳細については、「Opt out of data sharing in the IDE」を参照してください。

Amazon Q Developer は、プロ階層サブスクリプションでも無料利用枠サブスクリプションでも設定できます。プロ階層は、使用制限が高く設定され、その他の機能も備えた有料サブスクリプションサービスです。階層の違いの詳細については、「Understanding tiers of service for Amazon Q Developer」を参照してください。

Amazon Q Developer Pro のサブスクライブの詳細については、「Subscribing to Amazon Q Developer Pro」を参照してください。

Amazon Q Developer 無料利用枠を設定するには、次の手順を使用します。

Amazon Q Developer 無料利用枠を設定するには
  1. JupyterLab または Code Editor スペースの作成に使用した IAM ロールに次のポリシーを追加します。

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "q:SendMessage" ], "Resource": [ "*" ] }, { "Sid": "AmazonQDeveloperPermissions", "Effect": "Allow", "Action": [ "codewhisperer:GenerateRecommendations" ], "Resource": "*" } ] }
  2. Amazon SageMaker Studio に移動します。

  3. JupyterLab または Code Editor スペースを開きます。

  4. [ランチャー] に移動し、[ターミナル] を選択します。

  5. JupyterLab で、次の操作を行います。

    1. restart-jupyter-server を指定します。

    2. ブラウザを再起動し、Amazon SageMaker Studio に戻ります。

前提条件

Amazon Q Pro をセットアップするには、以下が必要です。

  • アクセス手段として設定された IAM Identity Center を使用して組織用に設定された Amazon SageMaker AI ドメイン。

  • Amazon Q Developer Pro サブスクリプション。

組織用に既に設定したドメインを更新する場合は、Amazon Q Developer を使用するよう更新する必要があります。 AWS Management Console または を使用してドメイン AWS Command Line Interface を更新できます。

Amazon Q Developer プロファイルの ARN を使用する必要があります。Q プロファイルの ARN は、Q Developer 設定ページにあります。

次の AWS Command Line Interface コマンドを使用してドメインを更新できます。

aws --region AWS リージョン sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=ENABLED,QProfileArn=Q-Profile-ARN}"

以下の手順に従って、 AWS Management Console内のドメインを更新することもできます。

  1. Amazon SageMaker AI コンソールに移動します。

  2. [ドメイン] を選択します。

  3. [アプリケーション設定] を選択します。

  4. Amazon Q Developer for SageMaker AI Applications で、編集を選択します。

  5. [このドメインで Amazon Q Developer を有効にする] を選択します。

  6. Q プロファイルの ARN を指定します。

  7. [Submit] を選択してください。

Amazon Q Developer プロファイルの ARN を使用する必要があります。Q プロファイルの ARN は、Amazon Q Developer コンソールの Amazon Q アカウントの詳細ページで確認できます。

組織のセットアップは、IAM Identity Center を使用できる Amazon SageMaker AI ドメインの高度なセットアップです。ドメインの設定方法と IAM アイデンティティセンターの設定については、「Amazon SageMaker AI のカスタムセットアップを使用する」を参照してください。

新しいドメインで Amazon Q Developer を設定するときは、 AWS Management Console を使用するか、ローカルマシンから次の AWS Command Line Interface コマンドを使用できます。

aws --region AWS リージョン sagemaker create-domain --domain-id domain-id --domain-name "example-domain-name" --vpc-id example-vpc-id --subnet-ids example-subnet-ids --auth-mode SSO --default-user-settings "ExecutionRole=arn:aws:iam::111122223333:role/IAM-role",--domain-settings "AmazonQSettings={status=ENABLED,qProfileArn=Q-profile-ARN" --query example-domain-ARN--output text

次の AWS CLI コマンドを使用して Amazon Q Developer を無効にできます。

aws --region AWS リージョン sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=DISABLED,QProfileArn=Q-Profile-ARN}"

最新バージョンの AWS Command Line Interfaceを使用することをお勧めします。の更新については AWS CLI、「 の最新バージョンのインストールまたは更新 AWS Command Line Interface」を参照してください。

Amazon Q Developer と VPC 間の接続を確立する必要がある場合、「Creating an interface VPC endpoint for Amazon Q」を参照してください。

注記

Amazon Q Developer には以下の制限があります。

  • 共有スペースはサポートされていません。

  • Amazon Q Developer は、コード提案が公開されているコードと類似しすぎているかどうかを検出します。リファレンストラッカーは、リポジトリ URL とライセンスを使用して提案にフラグを立てたり、除外したりすることができます。これにより、参照されているコードとその使用状況を、採用前に確認することができます。すべての参照は後で確認できるようログに記録され、コードフローが妨げられていないこと、および中断なくコーディングを維持できることを確認できます。

    コードリファレンスの詳細については、「Using code references - Amazon Q Developer」と「AI Coding Assistant - Amazon Q Developer FAQs」を参照してください。

  • Amazon Q は、米国東部 (バージニア北部) AWS リージョン内のすべてのユーザー操作データを処理します。Amazon Q がデータを処理する方法とサポートされる AWS リージョン の詳細については、「Supported Regions for Amazon Q Developer」を参照してください。

  • Amazon Q は、Amazon SageMaker Studio 内でのみ動作します。Amazon SageMaker Studio Classic 内ではサポートされません。

  • JupyterLab では、Amazon Q は SageMaker AI ディストリビューションイメージバージョン 2.0 以降で動作します。Code Editor では、Amazon Q は SageMaker AI ディストリビューションイメージバージョン 2.2.1 以降で動作します。

  • JupyterLab の Amazon Q Developer は、Jupyter AI 拡張機能内で動作します。Amazon Q を使用している間は、拡張機能内で他の 3P モデルを使用することができません。

での Amazon Q のカスタマイズ Amazon SageMaker AI

Amazon Q Developer Pro を使用する場合は、カスタマイズを作成するオプションがあります。カスタマイズにより、Amazon Q Developer は会社のコードベースに基づいて提案を提供します。Amazon Q Developer でカスタマイズを作成すると、Amazon SageMaker Studio の JupyterLab とコードエディタで を使用できるようになります。カスタマイズの設定の詳細については、「Amazon Q Developer ユーザーガイド」の「提案のカスタマイズ」を参照してください。