

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

# Amazon Q Developer を使用して Canvas で ML の問題を解決するための生成 AI 支援
<a name="canvas-q"></a>

Amazon SageMaker Canvas を使用すると、Amazon Q Developer と自然言語でチャットして、生成 AI を活用し、問題を解決できます。Q Developer は、目標を機械学習 (ML) タスクに変換し、ML ワークフローの各ステップを説明するアシスタントです。Q Developer を使用すると、Canvas ユーザーは、ML を活用して、組織でデータ駆動型の意思決定を行うために必要な時間、労力、データサイエンスの専門知識を低減するのに役立ちます。

Q Developer との会話を介して、データの準備、ML モデルの構築、予測の実行、モデルのデプロイなどのアクションを Canvas で開始できます。Q Developer は次のステップを提案し、各ステップの完了時にコンテキストを提供します。結果も通知します。例えば、Canvas はベストプラクティスに従ってデータセットを変換し、使用された変換とその理由を一覧表示できます。

Amazon Q Developer の Pro Tier と Free Tier の両方のユーザーは、Amazon Q Developer を SageMaker Canvas で追加料金なしで利用できます。ただし、SageMaker Canvas ワークスペースインスタンスや、モデルの構築またはデプロイに使用されるリソースなどには、標準料金が適用されます。料金の詳細については、「[Amazon SageMaker Canvas の料金](https://aws.amazon.com/sagemaker-ai/canvas/pricing/)」を参照してください。

Amazon Q の使用は、[MIT の 0 ライセンス](https://github.com/aws/mit-0)に基づいてライセンス供与され、[AWS 責任ある AI ポリシー](https://aws.amazon.com/machine-learning/responsible-ai/policy/)が適用されます。米国外から Q Developer を使用する場合、Q Developer は米国リージョン間でデータを処理します。詳細については、「[Amazon Q Developer でのクロスリージョン推論](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/cross-region-inference.html)」を参照してください。

**注記**  
SageMaker Canvas の Amazon Q Developer は、無料利用枠を使用する場合でも、Pro 利用枠のサブスクリプションを利用する場合でも、ユーザーコンテンツをサービス向上のために使用することはありません。サービステレメトリの目的で、Q Developer は質問数やレコメンデーションの承認または拒否など、お客様の使用状況を追跡する場合があります。このテレメトリデータには、ユーザーの IP アドレスなどの個人識別情報は含まれません。

## 仕組み
<a name="canvas-q-how-it-works"></a>

Amazon Q Developer は、SageMaker Canvas で利用できる、生成 AI を活用したアシスタントで、自然言語を使用してクエリを実行できます。Q Developer は、機械学習ワークフローの各ステップについて提案を行い、概念を説明し、必要に応じてオプションと詳細を提供します。Q Developer は、リグレッション、二項分類、多クラス分類のユースケースに役立ちます。

例えば、顧客離脱を予測するには、過去の顧客離脱情報のデータセットを Q Developer を介して Canvas にアップロードします。Q Developer は、データセットの問題の修正、モデルの構築、予測を行うための適切な ML モデルタイプとステップを提案します。

**重要**  
Amazon Q Developer は、SageMaker Canvas 内での機械学習の問題に関する会話を行うことを目的としています。Canvas アクションを通じてユーザーをガイドし、オプションで AWS のサービスに関する質問に回答します。Q Developer はモデル入力を英語でのみ処理します。Amazon Q Developer の利用方法については、「*Amazon Q Developer ユーザーガイド*」の「[Amazon Q Developer の機能](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/features.html)」を参照してください。

## サポート対象のリージョン
<a name="canvas-q-regions"></a>

Amazon Q Developer は、以下の SageMaker Canvas 内で利用できます AWS リージョン。
+ 米国東部 (バージニア北部)
+ 米国東部 (オハイオ)
+ 米国西部 (オレゴン)
+ アジアパシフィック (ムンバイ)
+ アジアパシフィック (ソウル)
+ アジアパシフィック (シンガポール)
+ アジアパシフィック (シドニー)
+ アジアパシフィック (東京)
+ 欧州 (フランクフルト)
+ 欧州 (アイルランド)
+ 欧州 (パリ)

## Canvas で利用可能な Amazon Q Developer の機能
<a name="canvas-q-capabilities"></a>

次のリストは、Q Developer がサポートできる Canvas タスクをまとめたものです。
+ **目的を説明する** – Q Developer は、問題を解決するための ML モデルタイプと一般的なアプローチを提案できます。
+ **データセットのインポートと分析** – データセットの保存場所を Q Developer に伝えるか、ファイルをアップロードして Canvas データセットとして保存します。外れ値や欠損値など、データセットの問題を特定するように Q Developer にプロンプトを提供します。Q Developer は、データセットに関する統計概要を提供し、特定された問題を一覧表示します。

  Q Developer は、個々の列の以下の統計に関するクエリをサポートしています。
  + 数値列 – `number of valid values`、`feature type`、`mean`、`median`、`minimum`、`maximum`、`standard deviation`、`25th percentile`、`75th percentile`、`number of outliers`
  + カテゴリ列 – `number of missing values`、`number of valid values`、`feature type`、`most frequent`、`most frequent category`、`most frequent category count`、`least frequent`、`least frequent category`、`least frequent category count`、`categories`
+ **データセットに関する問題の修正** – Canvas のデータ変換機能を使用してデータセットの修正版を作成するよう Q Developer にプロンプトを提示します。Canvas は Data Wrangler データフローを作成し、データサイエンスのベストプラクティスに従って変換を適用します。詳細については、「[データ準備](canvas-data-prep.md)」を参照してください。

  Q Developer で実行できるよりも高度なデータ分析やデータ準備タスクを実行する場合は、Data Wrangler データフローインターフェイスを使用することをお勧めします。
+ **モデルのトレーニング** – Q Developer は、問題に推奨される ML モデルタイプと提案されたモデル構築設定について説明します。推奨されるデフォルト設定を使用してクイックビルドを実行することも、設定を変更して標準ビルドを実行することもできます。準備が整ったら、Q Developer に Canvas モデルを構築するようプロンプトを提示します。

  すべてのカスタムモデルタイプがサポートされています。モデルタイプ、クイックビルドと標準ビルドの比較の詳細については、「[カスタムモデルの仕組み](canvas-build-model.md)」を参照してください。
+ **モデルの精度の評価** – モデルを構築した後、Q Developer はさまざまなメトリクスにわたってモデルスコアの概要を提供します。これらのメトリクスは、モデルの有用性と精度を判断するのに役立ちます。Q Developer は、あらゆる概念やメトリクスを詳細に説明できます。

  詳細と可視化をすべて表示するには、チャットまたは Canvas の **[My Models]** ページからモデルを開きます。詳細については、「[モデル評価](canvas-evaluate-model.md)」を参照してください。
+ **新しいデータの予測の取得** – 新しいデータセットをアップロードし、Q Developer にプロンプトを提示して Canvas の予測機能を開くことができます。

  Q Developer は、アプリケーションで新しいウィンドウを開き、単一の予測を行ったり、新しいデータセットでバッチ予測を行ったりすることができます。詳細については、「[カスタムモデルを使用した予測](canvas-make-predictions.md)」を参照してください。
+ **モデルのデプロイ** – モデルを本番環境にデプロイするには、Q Developer に Canvas 経由でモデルのデプロイを依頼します。Q Developer は、デプロイを設定できる新しいウィンドウを開きます。

  デプロイ後、1) モデルのデプロイタブの Canvas の **[My Models]** ページで **[デプロイ]** の詳細を表示するか、2) デプロイタブの **[ML Ops]** ページで **[デプロイ]** の詳細を表示します。詳細については、「[モデルをエンドポイントにデプロイする](canvas-deploy-model.md)」を参照してください。

## 前提条件
<a name="canvas-q-prereqs"></a>

Amazon Q Developer を使用して SageMaker Canvas で ML モデルを構築するには、次の前提条件を満たす必要があります。

**Canvas アプリケーションを設定する**

Canvas アプリケーションが設定されていることを確認します。Canvas アプリケーションをセットアップする方法については、「[Amazon SageMaker Canvas の開始方法](canvas-getting-started.md)」を参照してください。

**Q Developer のアクセス許可を付与する**

Canvas の使用中に Q Developer にアクセスするには、SageMaker AI ドメインまたはユーザープロファイルで使用されている AWS IAM ロールに必要なアクセス許可をアタッチする必要があります。これを行うには、このセクションで説明するコンソールを使用します。コンソールメソッドの使用が原因でアクセス許可の問題が発生した場合は、 AWS 管理ポリシー [ AmazonSageMakerCanvasSMDataScienceAssistantAccess](https://docs.aws.amazon.com/sagemaker/latest/dg/security-iam-awsmanpol-canvas.html#security-iam-awsmanpol-AmazonSageMakerCanvasSMDataScienceAssistantAccess) を IAM ロールに手動でアタッチします。

ドメインレベルでアタッチされたアクセス許可は、個々のアクセス許可がユーザープロファイルレベルで付与または取り消されない限り、ドメイン内のすべてのユーザープロファイルに適用されます。

------
#### [ SageMaker AI console method ]

アクセス許可は、SageMaker AI ドメインまたはユーザープロファイルの設定を編集することで付与できます。

SageMaker AI コンソールのドメイン設定を通じてアクセス許可を付与するには、次の手順を実行します。

1. Amazon SageMaker AI コンソール ([https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)) を開きます。

1. 左のナビゲーションペインで、**[管理設定‭]** を選択します。

1. **[管理設定]** で、**[ドメイン]** を選択します。

1. ドメインのリストで、ドメインを選択します。

1. **[ドメインの詳細]** ページで、**[アプリケーション設定]** タブを選択します。

1. **[Canvas]** セクションで、**[編集]** を選択します。

1. **[Canvas の設定を編集]** ページで、**[Amazon Q Developer]** セクションに移動し、以下を実行します。

   1. **[自然言語 ML で SageMaker Canvas の Amazon Q Developer を有効にする]** をオンにして、Canvas で Q Developer とチャットを行うアクセス許可をドメインの実行ロールに追加します。

   1. (オプション) さまざまな ( AWS のサービス 例: Athena の仕組みを説明する) について Q Developer に質問する場合は、**一般的な AWS 質問に対して Amazon Q Developer チャットを有効にする**を有効にします。
**注記**  
Q Developer に一般的な AWS クエリを実行する場合、リクエストは米国東部 (バージニア北部) を経由します AWS リージョン。データが米国東部 (バージニア北部) を経由してルーティングされないようにするには、**[Amazon Q Developer チャットで一般的な AWS の質問を有効にする]** トグルをオフにします。

------
#### [ Manual method ]

[ AmazonSageMakerCanvasSMDataScienceAssistantAccess](https://docs.aws.amazon.com/sagemaker/latest/dg/security-iam-awsmanpol-canvas.html#security-iam-awsmanpol-AmazonSageMakerCanvasSMDataScienceAssistantAccess) ポリシーを、ドメインまたはユーザープロファイルに使用される AWS IAM ロールにアタッチします。設定方法の詳細については、「*AWS IAM ユーザーガイド*」の「[IAM ID のアクセス許可の追加および削除](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)」を参照してください。

------

**(オプション) VPC から Q Developer へのアクセスを設定する**

パブリックインターネットアクセスなしで設定された VPC がある場合は、Q Developer の VPC エンドポイントを追加できます。詳細については、「[インターネットにアクセスせずに VPC で Amazon SageMaker Canvas を設定する](canvas-vpc.md)」を参照してください。

## 開始方法
<a name="canvas-q-get-started"></a>

Amazon Q Developer を使用して SageMaker Canvas で ML モデルを構築するには、次を実行します。

1. SageMaker Canvas アプリケーションを開きます。

1. 左側のナビゲーションペインで、**[Amazon Q]** を選択します。

1. **[新しい会話を開始]** をクリックして、新しいチャットを開きます。

新しいチャットを開始すると、Q Developer は問題を記述するか、データセットを提供するように求めるプロンプトを表示します。

![新しいチャットの開始時に Q Developer が提供する挨拶](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/studio/canvas/amazon-q-greeting.png)


データをインポートした後、Q Developer にデータセットに関する統計概要の提供を依頼したり、特定の列について質問したりできます。Q Developer がサポートするさまざまな統計のリストについては、前の「[Canvas で利用可能な Amazon Q Developer の機能](#canvas-q-capabilities)」セクションを参照してください。次のスクリーンショットは、製品カテゴリ列でデータセット統計と最も頻度の高いカテゴリを尋ねる例です。

![Q Developer にデータセット統計と最も頻繁なカテゴリ統計を提供するように求めるチャットダイアログ](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/studio/canvas/amazon-q-dataset-statistics.png)


Q Developer は、変換されたデータセットやモデルなど、会話中にインポートまたは作成した Canvas アーティファクトを追跡します。これは、チャットまたは他の Canvas アプリケーションタブからアクセスできます。例えば、Q Developer がデータセットの問題を修正した場合、次の場所から変換された新しいデータセットにアクセスできます。
+ Q Developer チャットインターフェイスのアーティファクトサイドバー
+ Canvas の **[データセット]** ページ。元のデータセットと変換されたデータセットの両方を表示できます。変換されたデータセットには、**[Built by Amazon Q]** ラベルが追加されています。
+ Canvas の **[Data Wrangler]** ページ。Q Developer は、ここにデータセットの新しいデータフローを作成します。

次のスクリーンショットは、チャットのサイドバーにある元のデータセットと変換されたデータセットです。

![Q Developer チャットのサイドバーに表示されるデータセットと変換されたデータセットであるアーティファクト](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/studio/canvas/amazon-q-artifacts.png)


データの準備が整ったら、Q Developer に Canvas モデルの構築を依頼します。Q Developer は、いくつかのフィールドを確認してビルド設定を確定するように求めるプロンプトを表示する場合があります。デフォルトのビルド設定を使用する場合、モデルはクイックビルドを使用して構築されます。使用するアルゴリズムの選択や目標メトリクスの変更など、ビルド設定の一部をカスタマイズする場合、モデルは標準ビルドで構築されます。

次のスクリーンショットは、いくつかのプロンプトのみで Canvas モデルビルドを開始するように Q Developer にプロンプトを提示する方法を説明しています。この例では、デフォルト設定を使用してクイックビルドを開始します。

![ユーザーが Canvas モデルビルドの開始を求めるプロンプトを提示する Q Developer との会話](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/studio/canvas/amazon-q-training-chat.png)


モデルを構築したら、チャットの自然言語またはアーティファクトサイドバーメニューを使用して追加のアクションを実行できます。例えば、モデルの詳細とメトリクスを表示したり、予測を行ったり、モデルをデプロイしたりできます。次のスクリーンショットは、これらの追加オプションを選択できるサイドバーを示しています。

![Q Developer の会話省略記号メニューが展開され、モデルの詳細、予測、デプロイを表示するオプションが表示されています。](http://docs.aws.amazon.com/ja_jp/sagemaker/latest/dg/images/studio/canvas/amazon-q-ellipsis-menu.png)


Canvas の **[My Models]** ページに移動してモデルを選択することで、これらのアクションを実行することもできます。モデルのページから、**[分析]**、**[予測]**、**[デプロイ]** タブに移動して、モデルのメトリクスと可視化を表示し、予測を行って、デプロイを管理できます。