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á.
# 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
+ 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](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/opt-out-IDE.html).
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](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-tiers.html).
Para informações sobre a assinatura do Amazon Q Developer Pro, consulte [Assinatura do Amazon Q Developer Pro](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-admin-setup-subscribe-general.html).
## Configure as instruções para o nível gratuito do Amazon Q Developer:
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 política a seguir à função do IAM que você usou para criar seu espaço JupyterLab ou o Code Editor de Código:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"q:SendMessage"
],
"Resource": [
"*"
]
},
{
"Sid": "AmazonQDeveloperPermissions",
"Effect": "Allow",
"Action": [
"codewhisperer:GenerateRecommendations"
],
"Resource": "*"
}
]
}
```
------
1. Navegue até o Amazon SageMaker Studio.
1. Abra seu espaço JupyterLab ou o do Code Editor.
1. Navegue até o **Iniciador** e escolha **Terminal**.
1. Em JupyterLab, faça o seguinte:
1. Especifique `restart-jupyter-server`.
1. 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 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](https://console.aws.amazon.com/amazonq/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 no Console de gerenciamento da AWS.
1. Navegue até o console do [Amazon SageMaker AI](https://console.aws.amazon.com/sagemaker).
1. Escolha Domínios.
1. Selecione **Configurações da aplicação**.
1. Para **Amazon Q Developer for SageMaker AI Applications**, escolha **Editar**.
1. Selecione **Ativar Amazon Q Developer neste domínio**.
1. Forneça o ARN do perfil Q.
1. 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](https://console.aws.amazon.com/amazonq/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](onboard-custom.md).
Ao configurar o Amazon Q Developer em um novo domínio, você pode usar o AWS Command Line Interface comando Console de gerenciamento da AWS 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}"
```
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](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
Se você precisar estabelecer uma conexão entre o Amazon Q Developer e sua VPC, consulte [Criação de uma interface endpoint da VPC](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/vpc-interface-endpoints.html#vpc-endpoint-create) 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 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](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/code-reference.html) e [AI Coding Assistant - Amazon Q Developer FAQs](https://aws.amazon.com/q/developer/faqs/?refid=255ccf7b-4a76-4dcb-9b07-68709e2b636b#:~:text=Can%20I%20prevent%20Amazon%20Q%20Developer%20from%20recommending%20code%20with%20code%20references%3F).
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](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/regions.html).
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.
## Personalizações do Amazon Q em 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 ficam disponíveis para você usar no editor de código JupyterLab e no Amazon SageMaker Studio. Para ter mais informações sobre a configuração de personalizações, consulte [Customizing suggestions](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/customizations.html) no *Guia do usuário do Amazon Q Developer*.