사용자를 위한 Amazon Q 개발자 설정 - Amazon SageMaker

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

사용자를 위한 Amazon Q 개발자 설정

Amazon Q Developer는 생성형 AI 대화형 어시스턴트입니다. 새 도메인 또는 기존 도메인 내에서 Amazon Q Developer를 설정할 수 있습니다. 다음 정보를 사용하여 Amazon Q Developer를 설정합니다.

Amazon Q Developer를 사용하면 사용자가 다음을 수행할 수 있습니다.

  • 독립적으로 또는 다른 AWS 서비스와 함께 SageMaker 기능을 사용하는 방법에 대한 지침을 받습니다 step-by-step.

  • 샘플 코드를 가져와 데이터 준비, 훈련, 추론 및 와 같은 ML 작업을 시작합니다MLOps.

  • 에서 코드를 실행하는 동안 발생한 오류를 디버깅하고 해결하기 위한 문제 해결 지원을 받습니다 JupyterLab.

참고

Studio의 Amazon Q 개발자는 프리 티어 구독이든 프로 티어 구독이든 관계없이 서비스를 개선하기 위해 사용자 콘텐츠를 사용하지 않습니다. IDE수준 원격 측정 공유의 경우 Amazon Q는 질문 수, 추천 수락 또는 거부 여부 등 사용자의 사용량을 추적할 수 있습니다. 이 원격 측정 데이터에는 사용자의 IP 주소와 같은 개인 식별 정보가 포함되지 않습니다. 데이터 보호 및 옵트아웃 지침에 대한 자세한 내용은 의 데이터 공유 옵트아웃을 IDE참조하세요.

Pro 또는 Free Tier 구독으로 Amazon Q Developer를 설정할 수 있습니다. Pro 티어는 사용량 제한 및 기타 기능이 더 높은 유료 구독 서비스입니다. 계층 간의 차이점에 대한 자세한 내용은 Amazon Q 개발자의 서비스 계층 이해를 참조하세요.

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 개발자 설정 ARN 페이지에서 Q 프로필을 찾을 수 있습니다. 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 Management Console.

  1. Amazon SageMaker 콘솔로 이동합니다.

  2. 도메인을 선택합니다.

  3. 앱 구성 을 선택합니다.

  4. Amazon Q Developer for SageMaker Applications 에서 편집을 선택합니다.

  5. 이 도메인 에서 Amazon Q 개발자 활성화를 선택합니다.

  6. Q 프로필 을 제공합니다ARN.

  7. 제출을 선택합니다.

Amazon Q 개발자 프로필ARN의 를 사용해야 합니다. Amazon Q 개발자 콘솔ARN의 Amazon Q 계정 세부 정보 페이지에서 Q 프로필의 를 찾을 수 있습니다.

조직 설정 은 IAM Identity Center를 사용할 수 있는 Amazon SageMaker 도메인의 고급 설정입니다. 도메인을 설정하는 방법과 IAM Identity Center 설정에 대한 자세한 내용은 섹션을 참조하세요Amazon에 대한 사용자 지정 설정 사용 SageMaker.

새 도메인에서 Amazon Q Developer를 설정할 때 로컬 시스템에서 또는 다음 AWS Command Line Interface 명령을 사용할 AWS Management Console 수 있습니다.


                    
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 개발자와 간에 연결을 설정해야 하는 경우 Amazon Q용 인터페이스 VPC 엔드포인트 생성을 VPC참조하세요.

참고

Amazon Q Developer에는 다음과 같은 제한 사항이 있습니다.

  • 공유 공간을 지원하지 않습니다.

  • 의 Amazon Q 개발자는 코드 제안이 공개적으로 사용 가능한 코드와 너무 유사한지 여부를 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 배포 이미지 버전 2.0 이상에서 작동합니다.

  • Amazon Q는 Jupyter AI 확장 내에서 작동합니다. Amazon Q를 사용하는 동안에는 확장 내에서 다른 3P 모델을 사용할 수 없습니다.