Configurar o Amazon Q Developer para seus usuários

O Amazon Q Developer é um assistente conversacional de IA generativa. 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 recursos de SageMaker IA 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.

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 compartilhamento de telemetria em nível de IDE, 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 mais informações sobre proteção de dados e instruções para não participar, 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 atributos. Para mais informações sobre as diferenças entre os níveis, consulte Compreender os níveis de serviço para o Amazon Q Developer.

Importante

Editor de código, baseado no Code-OSS, o Visual Studio Code - Open Source suporta apenas o uso de uma assinatura de nível gratuito.

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

Configure as instruções para o nível gratuito do Amazon Q Developer:

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

Para configurar o nível gratuito do Amazon Q Developer

1. Adicione a política a seguir à função do IAM que você usou para criar seu espaço JupyterLab ou o Code Editor de Código:

   {
   	"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 espaço JupyterLab ou o do Code Editor.

4. Navegue até o Iniciador e escolha Terminal.

5. Em JupyterLab, faça o seguinte:

   1. Especifique restart-jupyter-server.

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

Configure as instruções para o nível gratuito do Amazon Q Developer:

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

Para configurar o nível gratuito do Amazon Q Developer

1. Adicione a política a seguir à função do IAM que você usou para criar seu espaço JupyterLab ou o Code Editor de Código:

   {
   	"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 espaço JupyterLab ou o do Code Editor.

4. Navegue até o Iniciador e escolha Terminal.

5. Em JupyterLab, faça o seguinte:

   1. Especifique restart-jupyter-server.

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

Configure as instruções para o nível Amazon Q Developer Pro:

Pré-requisitos

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

• Um domínio Amazon SageMaker AI 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 ARN do perfil Q na página de Configurações do Desenvolvedor Q.

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 no AWS Management Console.

1. Navegue até o console do Amazon SageMaker AI.

2. Escolha Domínios.

3. Selecione Configurações da aplicação.

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

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

6. Forneça o ARN do perfil Q.

7. Selecione Enviar.

Você deve usar o ARN do seu perfil Amazon Q Developer. Você pode encontrar o ARN do perfil Q na página 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 domínio Amazon SageMaker AI que permite usar o IAM Identity Center. Para informações sobre como configurar o domínio e sobre como configurar o IAM Identity Center, consulte Use a configuração personalizada para Amazon SageMaker AI.

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}"           
        

Configure as instruções para o nível Amazon Q Developer Pro:

Pré-requisitos

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

• Um domínio Amazon SageMaker AI 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 ARN do perfil Q na página de Configurações do Desenvolvedor Q.

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 no AWS Management Console.

1. Navegue até o console do Amazon SageMaker AI.

2. Escolha Domínios.

3. Selecione Configurações da aplicação.

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

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

6. Forneça o ARN do perfil Q.

7. Selecione Enviar.

Você deve usar o ARN do seu perfil Amazon Q Developer. Você pode encontrar o ARN do perfil Q na página 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 domínio Amazon SageMaker AI que permite usar o IAM Identity Center. Para informações sobre como configurar o domínio e sobre como configurar o IAM Identity Center, consulte Use a configuração personalizada para Amazon SageMaker AI.

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 o uso da versão mais recente da 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 sua VPC, consulte Criação de uma interface endpoint da VPC para o Amazon Q.

nota

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

• Não é compatível com espaços compartilhados.

• O Amazon Q Developer 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 na Região da AWS Leste dos EUA (Norte da Virgínia). Para mais informações sobre como o Amazon Q processa dados e quais Regiões da AWS ele é compatível, consulte Regiões compatíveis com Amazon Q Developer.

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

• Em JupyterLab, o Amazon Q funciona com o SageMaker AI Distribution Images versão 2.0 e superior. No Code Editor, o Amazon Q funciona com o SageMaker AI Distribution Images versão 2.2.1 e superior.

• O Amazon Q Developer JupyterLab 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.