Configurar o Amazon Q Developer para seus usuários - Amazon SageMaker AI
Personalizações do Amazon Q no Amazon SageMaker AI

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:

  • Receber orientação passo a passo sobre como usar os recursos do SageMaker AI de forma independente ou com outros serviços da AWS.

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

  • Receber 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.

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

Para configurar o nível gratuito do Amazon Q Developer, use o seguinte procedimento:

Para configurar o nível gratuito do Amazon Q Developer

  1. Adicione a seguinte política ao perfil do IAM que você usou para criar seu espaço do JupyterLab ou do Editor de Código:

    JSON
    {
	"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 o JupyterLab ou seu espaço no Editor de Código.

  4. Navegue até o Iniciador e escolha Terminal.

  5. No JupyterLab, faça o seguinte:

    1. Especifique restart-jupyter-server.

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

Pré-requisitos

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

  • Um domínio do Amazon SageMaker AI configurado para sua organização com o Centro de Identidade do IAM 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 Console de gerenciamento da AWS 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 seguinte comando da AWS Command Line Interface 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 Console de gerenciamento da AWS.

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

  2. Escolha Domínios.

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

  4. Em Amazon Q Developer para aplicações do SageMaker AI, 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.

Configurar para organizações é uma configuração avançada para o domínio do Amazon SageMaker AI que permite usar o Centro de Identidade do IAM. Para informações sobre como configurar o domínio e sobre como configurar o IAM Identity Center, consulte Usar a configuração personalizada para o Amazon SageMaker AI.

Ao configurar o Amazon Q Developer em um novo domínio, você pode usar o Console de gerenciamento da AWS ou o comando AWS Command Line Interfaceou 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 comando da AWS CLI 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}"

Recomendamos o uso da versão mais recente da AWS Command Line Interface. Para mais informações sobre como atualizar a AWS CLI, consulte Instalar ou atualizar para a versão mais recente da 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 ao público. O crawler de referência pode sinalizar sugestões com URLs e licenças do repositório 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 mais informações sobre referências de código, consulte Uso de referências de código - Amazon Q Developer e Assistente de codificação de IA - Amazon Q Developer FAQs.

  • O Amazon Q processa todos os dados de interação do usuário na Região da AWSLeste 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 no Amazon SageMaker Studio. Não é compatível com o Amazon SageMaker Studio Classic.

  • No JupyterLab, o Amazon Q funciona com as imagens da Distribuição do SageMaker AI versão 2.0 e posterior. No Editor de Código, o Amazon Q funciona com as imagens da Distribuição do SageMaker AI versão 2.2.1 e posterior.

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

Personalizações do Amazon Q no Amazon SageMaker AI

Se você usa o Amazon Q Developer Pro, é possível criar personalizações. Com personalizações, o Amazon Q Developer fornece sugestões com base na base de código da sua empresa. Se você criar personalizações no Amazon Q Developer, elas ficarão disponíveis para uso no JupyterLab e no Editor de Código no Amazon SageMaker Studio. Para ter mais informações sobre a configuração de personalizações, consulte Customizing suggestions no Guia do usuário do Amazon Q Developer.