Configure o Amazon Q Developer para seus usuários - Amazon SageMaker

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configure o Amazon Q Developer para seus usuários

O Amazon Q Developer é um assistente conversacional generativo de IA. Você pode configurar o Amazon Q Developer em um novo domínio ou em um domínio existente. Use as informações a seguir para configurar o Amazon Q Developer.

Com o Amazon Q Developer, seus usuários podem:

  • Receba step-by-step orientações sobre como usar os SageMaker recursos de forma independente ou em combinação com outros AWS serviços.

  • Obtenha um código de amostra para começar suas tarefas de ML, como preparação de dados, treinamento, inferência e. MLOps

  • Receba assistência na solução de problemas para depurar e resolver erros encontrados durante a execução do código em JupyterLab.

nota

O Amazon Q Developer in Studio não usa o conteúdo do usuário para melhorar o serviço, independentemente de você usar a assinatura gratuita ou profissional. Para IDE compartilhamento de telemetria em nível de nível superior, o Amazon Q pode rastrear o uso de seus usuários, como o número de perguntas feitas e se as recomendações foram aceitas ou rejeitadas. Esses dados de telemetria não incluem informações de identificação pessoal, como o endereço IP dos usuários. Para obter mais informações sobre proteção de dados e instruções para cancelar, consulte Optar por não compartilhar dados no IDE.

Você pode configurar o Amazon Q Developer com uma assinatura de nível Pro ou Gratuito. O nível Pro é um serviço de assinatura paga com limites de uso mais altos e outros recursos. Para obter mais informações sobre as diferenças entre os níveis, consulte Entendendo os níveis de serviço para o Amazon Q Developer.

Para obter informações sobre a assinatura do Amazon Q Developer Pro, consulte Assinatura do Amazon Q Developer Pro.

Para configurar o Amazon Q Developer Free Tier em JupyterLab, use o seguinte procedimento:

Para configurar o nível gratuito do Amazon Q Developer

  1. Adicione a política a seguir à IAM função que você usou para criar seu JupyterLab espaço:

    {
	"Version": "2012-10-17",
	"Statement": [
		{
			"Effect": "Allow",
			"Action": [
				"q:SendMessage"
			],
			"Resource": [
				"*"
			]
		}
		{
			"Sid": "AmazonQDeveloperPermissions",
			"Effect": "Allow",
			"Action": [
				"codewhisperer:GenerateRecommendations"
			],
			"Resource": "*"
		}
	]
}

  2. Navegue até o Amazon SageMaker Studio.

  3. Abra seu JupyterLab espaço.

  4. Navegue até o Launcher e escolha Terminal.

  5. Especifique restart-jupyter-server.

  6. Reinicie seu navegador e volte para o Amazon SageMaker Studio.

Pré-requisitos

Para configurar o Amazon Q Pro dentro JupyterLab, você deve ter:

  • Um SageMaker domínio da Amazon configurado para sua organização com o IAM Identity Center configurado como meio de acesso.

  • Uma assinatura do Amazon Q Developer Pro.

Se você estiver atualizando um domínio que você já configurou para sua organização, você precisa atualizá-lo para usar o Amazon Q Developer. Você pode usar o AWS Management Console ou o AWS Command Line Interface para atualizar um domínio.

Você deve usar o ARN do seu perfil Amazon Q Developer. Você pode encontrar o perfil Q ARN na página Q Developer Settings.

Você pode usar o AWS Command Line Interface comando a seguir para atualizar seu domínio:


aws --region Região da AWS sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=ENABLED,QProfileArn=Q-Profile-ARN}"

Você também pode usar o procedimento a seguir para atualizar o domínio dentro do AWS Management Console.

  1. Navegue até o SageMaker console da Amazon.

  2. Escolha domínios.

  3. Selecione Configurações do aplicativo.

  4. Para Amazon Q Developer for SageMaker Applications, escolha Editar.

  5. Selecione Ativar Amazon Q Developer neste domínio.

  6. Forneça o perfil ARN Q.

  7. Selecione Enviar.

Você deve usar o ARN do seu perfil Amazon Q Developer. Você pode encontrar o perfil Q na página ARN de detalhes da conta Amazon Q do console do Amazon Q Developer.

A Configuração para organizações é uma configuração avançada para o SageMaker domínio da Amazon que permite que você use o IAM Identity Center. Para obter informações sobre como você pode configurar o domínio e informações sobre como configurar o IAM Identity Center, consulteUse a configuração personalizada para a Amazon SageMaker.

Ao configurar o Amazon Q Developer em um novo domínio, você pode usar o AWS Command Line Interface comando AWS Management Console ou o seguinte em sua máquina local:


                    
aws --region Região da 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

Você pode usar o seguinte AWS CLI comando para desativar o Amazon Q Developer:


aws --region Região da AWS sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=DISABLED,QProfileArn=Q-Profile-ARN}"

Você pode configurar o Amazon Q Developer em um novo domínio ou em um domínio existente. Use as informações a seguir para configurar o Amazon Q Developer.

Recomendamos usar a versão mais recente do AWS Command Line Interface. Para obter informações sobre como atualizar o AWS CLI, consulte Instalar ou atualizar para a versão mais recente do AWS Command Line Interface.

Se você precisar estabelecer uma conexão entre o Amazon Q Developer e o seuVPC, consulte Criação de um VPC endpoint de interface para o Amazon Q.

nota

O Amazon Q Developer tem as seguintes limitações:

  • Ele não suporta espaços compartilhados.

  • O Amazon Q Developer JupyterLab detecta se uma sugestão de código pode ser muito semelhante ao código disponível publicamente. O rastreador de referência pode sinalizar sugestões com repositório URLs e licenças, ou filtrá-las. Isso permite que você revise o código referenciado e seu uso antes de adotá-lo. Todas as referências são registradas para você revisar posteriormente para garantir que seu fluxo de código não seja perturbado e que você possa continuar codificando sem interrupção.

    Para obter mais informações sobre referências de código, consulte Uso de referências de código - Amazon Q Developer e AI Coding Assistant - Amazon Q Developer FAQs.

  • O Amazon Q processa todos os dados de interação do usuário no Leste dos EUA (Norte da Virgínia) Região da AWS. Para obter mais informações sobre como o Amazon Q processa dados e o Regiões da AWS que ele suporta, consulte Regiões suportadas pelo Amazon Q Developer.

  • O Amazon Q só funciona dentro do Amazon SageMaker Studio. Ele não é compatível com o Amazon SageMaker Studio Classic.

  • O Amazon Q funciona com a versão 2.0 e superior do SageMaker Distribution Images.

  • O Amazon Q funciona dentro da extensão Jupyter AI. Você não pode usar outros modelos 3P dentro da extensão enquanto estiver usando o Amazon Q.