翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ユーザー用に 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](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/opt-out-IDE.html)」を参照してください。
Amazon Q Developer は、プロ階層サブスクリプションでも無料利用枠サブスクリプションでも設定できます。プロ階層は、使用制限が高く設定され、その他の機能も備えた有料サブスクリプションサービスです。階層の違いの詳細については、「[Understanding tiers of service for Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-tiers.html)」を参照してください。
Amazon Q Developer Pro のサブスクライブの詳細については、「[Subscribing to Amazon Q Developer Pro](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-admin-setup-subscribe-general.html)」を参照してください。
## Amazon Q Developer 無料利用枠の設定手順:
Amazon Q Developer 無料利用枠を設定するには、次の手順を使用します。
**Amazon Q Developer 無料利用枠を設定するには**
1. JupyterLab または Code Editor スペースの作成に使用した IAM ロールに次のポリシーを追加します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"q:SendMessage"
],
"Resource": [
"*"
]
},
{
"Sid": "AmazonQDeveloperPermissions",
"Effect": "Allow",
"Action": [
"codewhisperer:GenerateRecommendations"
],
"Resource": "*"
}
]
}
```
------
1. Amazon SageMaker Studio に移動します。
1. JupyterLab または Code Editor スペースを開きます。
1. **[ランチャー]** に移動し、**[ターミナル]** を選択します。
1. JupyterLab で、以下を実行します。
1. `restart-jupyter-server` を指定します。
1. ブラウザを再起動し、Amazon SageMaker Studio に戻ります。
## Amazon Q Developer Pro 階層の設定手順:
**前提条件**
Amazon Q Pro を設定するには、以下が必要です。
アクセス手段として IAM アイデンティティセンターが設定され、組織用にセットアップされた Amazon SageMaker AI ドメイン
Amazon Q Developer Pro サブスクリプション。
組織用に既に設定したドメインを更新する場合は、Amazon Q Developer を使用するよう更新する必要があります。 AWS マネジメントコンソール または を使用してドメイン AWS Command Line Interface を更新できます。
Amazon Q Developer プロファイルの ARN を使用する必要があります。Q プロファイルの ARN は、[Q Developer 設定](https://console.aws.amazon.com/amazonq/developer/settings)ページにあります。
次の 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 マネジメントコンソール内のドメインを更新することもできます。
1. [Amazon SageMaker AI コンソール](https://console.aws.amazon.com/sagemaker)に移動します。
1. [ドメイン] を選択します。
1. **[アプリケーション設定]** を選択します。
1. **[SageMaker アプリケーションのための Amazon Q Developer]** で、**[編集]** を選択します。
1. **[このドメインで Amazon Q Developer を有効にする]** を選択します。
1. Q プロファイルの ARN を指定します。
1. [**Submit**] を選択してください。
Amazon Q Developer プロファイルの ARN を使用する必要があります。Q プロファイルの ARN は、[Amazon Q Developer](https://console.aws.amazon.com/amazonq/developer) コンソールの **Amazon Q アカウントの詳細**ページで確認できます。
**[組織向けの設定]** は、IAM アイデンティティセンターを使用できる Amazon SageMaker AI ドメインの高度なセットアップです。ドメインの設定方法と IAM アイデンティティセンターの設定については、「[Amazon SageMaker AI のカスタムセットアップを使用する](onboard-custom.md)」を参照してください。
新しいドメインで Amazon Q Developer を設定するときは、 AWS マネジメントコンソール を使用するか、ローカルマシンから次の 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](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)」を参照してください。
Amazon Q Developer と VPC 間の接続を確立する必要がある場合、「[Creating an interface VPC endpoint for Amazon Q](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/vpc-interface-endpoints.html#vpc-endpoint-create)」を参照してください。
**注記**
Amazon Q Developer には以下の制限があります。
共有スペースはサポートされていません。
Amazon Q Developer は、コードの提案の公開されているコードとの近似性を検出します。リファレンストラッカーは、リポジトリ URL とライセンスを使用して提案にフラグを立てたり、除外したりすることができます。これにより、参照されているコードとその使用状況を、採用前に確認することができます。すべての参照は後で確認できるようログに記録され、コードフローが妨げられていないこと、および中断なくコーディングを維持できることを確認できます。
コードリファレンスの詳細については、「[Using code references - Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/code-reference.html)」と「[AI Coding Assistant - Amazon Q Developer FAQs](https://aws.amazon.com/q/developer/faqs/?refid=255ccf7b-4a76-4dcb-9b07-68709e2b636b#:~:text=Can%20I%20prevent%20Amazon%20Q%20Developer%20from%20recommending%20code%20with%20code%20references%3F)」を参照してください。
Amazon Q は、米国東部 (バージニア北部) AWS リージョン内のすべてのユーザー操作データを処理します。Amazon Q がデータを処理する方法とサポートされる AWS リージョン の詳細については、「[Supported Regions for Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/regions.html)」を参照してください。
Amazon Q は、Amazon SageMaker Studio 内でのみ動作します。Amazon SageMaker Studio Classic 内ではサポートされません。
JupyterLab では、Amazon Q は SageMaker AI Distribution Images バージョン 2.0 以降で動作します。Code Editor では、Amazon Q は SageMaker AI Distribution Images バージョン 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 と Code Editor で使用できるようになります。カスタマイズの設定の詳細については、「*Amazon Q Developer ユーザーガイド*」の「[提案のカスタマイズ](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/customizations.html)」を参照してください。