為您的使用者設定 Amazon Q 開發人員

Amazon Q Developer 是生成式 AI 對話助理。您可以在新網域或現有網域中設定 Amazon Q Developer。使用下列資訊來設定 Amazon Q Developer。

透過 Amazon Q Developer，您的使用者可以：

• 收到 step-by-step有關獨立或與其他 AWS 服務結合使用 SageMaker 功能的指引。

• 取得範例程式碼，以開始使用 ML 任務，例如資料準備、訓練、推論和 MLOps。

• 接收疑難排解協助，以偵錯並解決在 中執行程式碼時遇到的錯誤 JupyterLab。

注意

無論您使用 Free-tier 還是 Pro-tier 訂閱，Studio 中的 Amazon Q Developer 都不會使用使用者內容來改善服務。對於 IDE層級遙測共用，Amazon Q 可能會追蹤使用者使用量，例如提出的問題數量，以及建議是否接受或拒絕。此遙測資料不包含個人識別資訊，例如使用者的 IP 地址。如需資料保護和選擇退出指示的詳細資訊，請參閱中的選擇退出資料共用IDE。

您可以使用專業版或免費層訂閱設定 Amazon Q 開發人員。Pro 層是付費訂閱服務，具有更高的用量限制和其他功能。如需層間差異的詳細資訊，請參閱了解 Amazon Q Developer 的服務層。

如需有關訂閱 Amazon Q Developer Pro 的資訊，請參閱訂閱 Amazon Q Developer Pro。

設定 Amazon Q Developer Free Tier 的指示：

若要在 內設定 Amazon Q Developer Free Tier JupyterLab，請使用下列程序：

若要設定 Amazon Q Developer Free Tier

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. 導覽至啟動器，然後選擇終端機 。

5. 指定 restart-jupyter-server。

6. 重新啟動瀏覽器並導覽回 Amazon SageMaker Studio。

設定 Amazon Q Developer Pro 層的指示：

必要條件

若要在 內設定 Amazon Q Pro JupyterLab，您必須具有：

• 為您的組織設定 Amazon SageMaker 網域，並將 IAM Identity Center 設定為存取方式。

• Amazon Q Developer Pro 訂閱。

如果您要更新已為組織設定的網域，則需要更新網域，才能使用 Amazon Q Developer。您可以使用 AWS Management Console 或 AWS Command Line Interface 來更新網域。

您必須使用 Amazon Q 開發人員設定檔ARN的 。您可以在 Q 開發人員設定頁面上找到 Q 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. 選取應用程式組態 。

4. 針對 SageMaker 應用程式 的 Amazon Q Developer，選擇編輯 。

5. 選取在此網域 上啟用 Amazon Q 開發人員。

6. 提供 Q 設定檔 ARN。

7. 選擇提交。

您必須使用 Amazon Q 開發人員設定檔ARN的 。您可以在 Amazon Q 開發人員主控台ARN的 Amazon Q 帳戶詳細資訊頁面上找到 Q 設定檔的 。

組織設定是 Amazon SageMaker 網域的進階設定，可讓您使用 IAM Identity Center。如需如何設定網域的資訊，以及設定 IAM Identity Center 的相關資訊，請參閱 使用 Amazon 的自訂設定 SageMaker。

在新網域中設定 Amazon Q 開發人員時，您可以從本機機器使用 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 開發人員和 AI 編碼助理 - Amazon Q 開發人員 FAQs。

• Amazon Q 會處理美國東部 （維吉尼亞北部） 內的所有使用者互動資料。 AWS 區域如需 Amazon Q 如何處理資料及其 AWS 區域 支援的詳細資訊，請參閱 Amazon Q 開發人員的支援區域。

• Amazon Q 僅適用於 Amazon SageMaker Studio。Amazon SageMaker Studio Classic 不支援此功能。

• Amazon Q 可在 SageMaker Distribution Images 2.0 版及更新版本中運作。

• Amazon Q 可在 Jupyter AI 延伸模組中運作。使用 Amazon Q 時，您無法在延伸模組中使用其他 3P 模型。