ユーザーの Amazon Q デベロッパーを設定する - Amazon SageMaker

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

ユーザーの Amazon Q デベロッパーを設定する

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

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

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

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

  • でコードを実行中に発生したエラーをデバッグして解決するためのトラブルシューティング支援を受け取ります JupyterLab。

注記

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

Amazon Q Developer は、Pro または Free 階層サブスクリプションで設定できます。Pro 層は、使用制限やその他の機能を備えた有料サブスクリプションサービスです。階層間の違いの詳細については、「Amazon Q Developer のサービス階層について」を参照してください。

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

内で Amazon Q デベロッパー無料利用枠を設定するには JupyterLab、次の手順を使用します。

Amazon Q デベロッパーの無料利用枠を設定するには

  1. JupyterLab スペースの作成に使用した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 スペースを開きます。

  4. Launcher に移動し、ターミナル を選択します。

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

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

前提条件

内で Amazon Q Pro を設定するには JupyterLab、以下が必要です。

  • IAM Identity Center をアクセス手段として設定して、組織の Amazon SageMaker ドメインを設定します。

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

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

Amazon Q デベロッパープロファイルARNの を使用する必要があります。Q Profile は Q Developer Settings ページARNにあります。

次の 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 コンソールに移動します。

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

  3. App Configurations を選択します。

  4. Amazon Q Developer for SageMaker Applications では、「 の編集」を選択します。

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

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

  7. [送信] を選択します。

Amazon Q デベロッパープロファイルARNの を使用する必要があります。Q Profile ARNの は、Amazon Q Developer コンソールの Amazon Q アカウントの詳細ページにあります。 https://console.aws.amazon.com/amazonq/developer

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

新しいドメインで 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}"

Amazon Q Developer は、新しいドメインまたは既存のドメイン内に設定できます。以下の情報を使用して Amazon Q Developer をセットアップします。

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

Amazon Q Developer と 間の接続を確立する必要がある場合はVPC、「Amazon Q のインターフェイスVPCエンドポイントの作成」を参照してください。

注記

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

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

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

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

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

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

  • Amazon Q は SageMaker 、Distribution Images バージョン 2.0 以降で動作します。

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