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
-
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": "*" } ] }
-
Navegue até o Amazon SageMaker Studio.
-
Abra seu JupyterLab espaço.
-
Navegue até o Launcher e escolha Terminal.
-
Especifique
restart-jupyter-server
. -
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-iddomain-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.
-
Navegue até o SageMaker console da Amazon
. -
Escolha domínios.
-
Selecione Configurações do aplicativo.
-
Para Amazon Q Developer for SageMaker Applications, escolha Editar.
-
Selecione Ativar Amazon Q Developer neste domínio.
-
Forneça o perfil ARN Q.
-
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-iddomain-id
--domain-name"example-domain-name"
--vpc-idexample-vpc-id
--subnet-idsexample-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
" --queryexample-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-iddomain-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.