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á.
# Geração de sugestões em linha com o Amazon Q Developer.
O Amazon Q pode fornecer recomendações de código em tempo real. Quando você escreve código, o Amazon Q gera automaticamente sugestões com base nos seus códigos e comentários existentes. As recomendações personalizadas podem variar em tamanho e escopo, desde um comentário de uma única linha até funções totalmente formadas.
Quando você começa a digitar um código de linha única, o Amazon Q faz sugestões com base nas entradas atuais e anteriores. Os nomes dos arquivos também são levados em consideração.
As sugestões embutidas são ativadas automaticamente quando você baixa a extensão Amazon Q. Para começar, comece a escrever código e a Amazon Q começará a gerar sugestões de código.
Você também pode personalizar as sugestões que o Amazon Q gera para as bibliotecas internas, as técnicas algorítmicas proprietárias e o estilo de código corporativo da sua equipe de desenvolvimento de software.
**Topics**
+ [Pausar sugestões com o Amazon Q](#toggling-suggestions)
+ [Preenchimento de código Amazon Q em ação](#what-is-walkthrough)
+ [Gerando sugestões em linha em ambientes de AWS codificação](setting-up-AWS-coding-env.md)
+ [Usar teclas de atalho com o](actions-and-shortcuts.md)
+ [Usando referências de código](code-reference.md)
+ [Exemplos de código](inline-suggestions-code-examples.md)
## Pausar sugestões com o Amazon Q
Escolha seu IDE para ver as etapas para pausar e retomar sugestões de código em linha no Amazon Q.
------
#### [ Visual Studio Code ]
1. Em VS Code, escolha **Amazon Q** na bandeja de componentes na parte inferior da janela do IDE.
A barra de tarefas do Amazon Q é aberta na parte superior da janela do IDE.
1. Escolha **Pausar sugestões automáticas** ou **Retomar sugestões automáticas**.
A imagem a seguir mostra a barra de tarefas Amazon Q em VS Code.
![\[A barra de tarefas do Amazon Q está em VS Code.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/VSC-taskbar.png)
------
#### [ JetBrains ]
1. No IDE do JetBrains, selecione **Amazon Q** na barra de status na parte inferior da janela.
A barra de tarefas do Amazon Q é aberta acima da barra de status.
1. Escolha **Pausar sugestões automáticas** ou **Retomar sugestões automáticas**.
A imagem a seguir mostra a barra de tarefas do Amazon Q em um IDE do JetBrains.
![\[A barra de tarefas do Amazon Q em um IDE do JetBrains.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/JB-taskbar.png)
------
#### [ Eclipse ]
1. No IDE do Eclipse, selecione o ícone do **Amazon Q** no canto superior direito.
1. Com a guia de chat do Amazon Q aberta, selecione o ícone de elipse (três pontos) no canto superior direito da guia. A barra de tarefas do Amazon Q é aberta.
A imagem a seguir mostra a barra de tarefas do Amazon Q em um IDE do Eclipse.
![\[A barra de tarefas do Amazon Q em um IDE do Eclipse.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/eclipse-taskbar.png)
1. Escolha **Pausar sugestões automáticas** ou **Retomar sugestões automáticas**.
------
#### [ Visual Studio ]
1. Na borda da janela, escolha o logotipo do Amazon Q.
1. Selecione **Pausar sugestões automáticas** ou **Retomar sugestões automáticas**
A imagem a seguir mostra a barra de tarefas do Amazon Q no Visual Studio.
![\[O menu Ferramentas do desenvolvedor no Visual Studio.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/vstudio-toggle-suggestions.png)
------
#### [ AWS Cloud9 ]
O Amazon Q não suporta a ativação e desativação de sugestões do AWS Cloud9.
Para parar de receber sugestões do Amazon Q AWS Cloud9, remova a política do IAM que dá acesso ao Amazon Q AWS Cloud9 da função ou usuário que você está usando para acessar AWS Cloud9.
------
#### [ AWS Lambda ]
Para desativar ou reativar as sugestões de código Amazon Q no Lambda:
1. No console do Lambda, abra a tela de uma função do Lambda específica.
1. Na seção **Fonte do código**, na barra de ferramentas, escolha **Ferramentas**.
1. No menu suspenso, escolha **Amazon Q Code** Suggestions.
------
#### [ Amazon SageMaker AI Studio ]
1. No console do SageMaker AI Studio, escolha Amazon Q na parte inferior da janela.
O painel Amazon Q será aberto.
1. Escolha **Pausar sugestões automáticas** ou **Retomar sugestões automáticas**.
------
#### [ JupyterLab ]
1. No JupyterLab console, escolha Amazon Q na parte inferior da janela.
O painel Amazon Q será aberto.
1. Escolha **Pausar sugestões automáticas** ou **Retomar sugestões automáticas**.
------
#### [ AWS Glue Studio Notebook ]
1. No console do AWS Glue Studio Notebook, escolha Amazon Q na parte inferior da janela.
O painel Amazon Q será aberto.
1. Escolha **Pausar sugestões automáticas** ou **Retomar sugestões automáticas**.
------
## Preenchimento de código Amazon Q em ação
Esta seção demonstra como o Amazon Q pode ajudar você a escrever uma inscrição completa. Esse aplicativo cria um bucket do Amazon S3 e uma tabela do Amazon DynamoDB, além de um teste unitário que valida as duas tarefas.
Aqui, o Amazon Q ajuda o desenvolvedor a escolher quais bibliotecas importar. Usando as teclas de seta, o desenvolvedor alterna entre várias sugestões.
![\[Um exemplo do atributo de preenchimento do bloco.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whatis-demo-1.gif)
Aqui, o desenvolvedor insere um comentário descrevendo o código que pretende escrever na próxima linha.
O Amazon Q antecipa corretamente o método a ser chamado. O desenvolvedor pode aceitar a sugestão com a tecla tab.
![\[alt_text\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whatis-demo-2.png)
Aqui, o desenvolvedor se prepara para definir constantes.
O Amazon Q antecipa corretamente que a primeira constante será `REGION` e que seu valor será `us-east-1`, que é o padrão.
![\[alt_text\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whatis-demo-3.png)
Aqui, o desenvolvedor se prepara para escrever um código que abrirá sessões entre o usuário e o Amazon S3 e o DynamoDB.
O Amazon Q, familiarizado com AWS APIs e SDKs, sugere o formato correto.
![\[alt_text\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whatis-demo-4.1.png)
O desenvolvedor simplesmente escreveu o nome da função que criará o bucket. Mas com base nisso (e no contexto), o Amazon Q oferece uma função completa, com try/except cláusulas.
Observe o uso de `TEST_BUCKET_NAME, which is a constant declared earlier in the same file.`
![\[alt_text\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whatis-demo-5.png)
O desenvolvedor está apenas começando a digitar o nome da função que criará uma tabela do DynamoDB. Mas a Amazon Q pode dizer para onde isso está indo.
Observe que a sugestão explica a sessão do DynamoDB criada anteriormente e até a menciona em um comentário.
![\[alt_text\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whatis-demo-6.png)
O desenvolvedor fez pouco mais do que escrever o nome da classe de teste unitário, quando a Amazon Q se ofereceu para concluí-la.
Observe as referências integradas às duas funções criadas anteriormente no mesmo arquivo.
O desenvolvedor está apenas começando a digitar o nome da função que criará uma tabela do DynamoDB. Mas a Amazon Q pode dizer para onde isso está indo.
Observe que a sugestão explica a sessão do DynamoDB criada anteriormente e até a menciona em um comentário.
![\[alt_text\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whatis-demo-7.png)
Com base apenas em um comentário e no contexto, o Amazon Q fornece toda a função principal.
![\[alt_text\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whatis-demo-8.1.png)
Tudo o que resta é a guarda principal, e a Amazon Q sabe disso.
Com base apenas em um comentário e no contexto, o Amazon Q fornece toda a função principal.
![\[alt_text\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whatis-demo-9.png)
Por fim, o desenvolvedor executa o teste unitário a partir do terminal do mesmo IDE em que a codificação ocorreu.
![\[alt_text\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whatis-demo-10.png)
# Gerando sugestões em linha em ambientes de AWS codificação
Além de terceiros IDEs, o Amazon Q Developer pode gerar sugestões embutidas em AWS serviços que fornecem seus próprios ambientes de codificação.
As seções a seguir descrevem como configurar sugestões de código em linha do Amazon Q em AWS serviços integrados.
**nota**
Se você estiver usando o Amazon Q como parte de uma empresa, então você está usando o Amazon Q Developer Pro. Nesse caso, os administradores da sua organização devem concluir etapas adicionais antes que você possa começar a programar. Para obter mais informações, consulte [Conceitos básicos do Amazon Q Developer](getting-started-q-dev.md).
**Topics**
+ [Como usar o Amazon Q Developer com o Amazon SageMaker AI Studio](sagemaker-setup.md)
+ [Usando o Amazon Q Developer com JupyterLab](jupyterlab-setup.md)
+ [Como usar o Amazon Q Developer com o Amazon EMR Studio](emr-setup.md)
+ [Usando o Amazon Q Developer com o AWS Glue Studio](glue-setup.md)
+ [Usando o Amazon Q Developer com AWS Lambda](lambda-setup.md)
+ [Como usar o Amazon Q Developer com outros serviços](other-setup.md)
# Como usar o Amazon Q Developer com o Amazon SageMaker AI Studio
Você pode conversar com o Amazon Q no Amazon SageMaker AI Studio. Você também pode fazer recomendações de código automaticamente enquanto escreve seu código.
Para usar o Amazon Q Developer com o Amazon SageMaker AI Studio, você deve adicionar permissões do Amazon Q à sua função de execução do SageMaker AI. A forma como você configura as permissões depende se você está usando o nível gratuito do Amazon Q Developer ou o nível Pro.
Para configurar e ativar o Amazon Q para o Amazon SageMaker AI Studio, consulte [Set up Amazon Q Developer for your users](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-updated-jl-admin-guide-set-up.html) no *Guia do usuário do Amazon SageMaker AI*.
# Usando o Amazon Q Developer com JupyterLab
Esta página descreve como configurar e ativar o Amazon Q Developer para JupyterLab. Depois de ativado, o Amazon Q pode fazer recomendações de código automaticamente à medida que você escreve seu código.
**nota**
Python é a única linguagem de programação compatível com a Amazon Q. JupyterLab
## Instalando JupyterLab
Instale [JupyterLab](https://pypi.org/project/jupyterlab)no seu computador ou, se você já tiver JupyterLab instalado, verifique sua versão executando o comando a seguir.
```
pip show jupyterlab
```
Observe a versão na resposta e siga as instruções correspondentes em uma das seções a seguir.
## Instalação usando pip para a versão >= 4.0 do Jupyter Lab
Você pode instalar e habilitar a extensão Amazon Q para JupyterLab 4 pessoas com os seguintes comandos.
```
# JupyterLab 4
pip install amazon-q-developer-jupyterlab-ext
```
## Instalação usando pip para a versão >= 3.6 e < 4.0 do Jupyter Lab
Você pode instalar e habilitar a extensão Amazon Q para JupyterLab 3 pessoas com os seguintes comandos.
```
# JupyterLab 3
pip install amazon-q-developer-jupyterlab-ext~=3.0
jupyter server extension enable amazon-q-developer-jupyterlab-ext
```
## Autenticando com ID do builder AWS
No procedimento a seguir, você configurará o Builder ID, que você usará para autenticar ao ativar o Amazon Q.
1. Atualize a guia do navegador que você está usando JupyterLab.
1. No painel Amazon Q na parte inferior da janela, escolha **Get Started**.
1. Na janela pop-up, escolha **Copiar código e continuar**.
1. Na página de **introdução, faça login ou cadastre-se para obter** um Builder ID usando seu endereço de e-mail ou conta do Google. Para obter mais informações, consulte [Conceitos básicos de uma conta pessoal (ID do builder)](getting-started-builderid.md).
Se você já tem um Builder ID, vá para a etapa sobre a página **Autorizar solicitação**.
1. Depois de receber seu código de verificação por e-mail, insira-o no campo em branco e escolha **Verificar**.
1. Na próxima tela, escolha e confirme uma senha e, em seguida, escolha **Criar ID do builder AWS**
1. Na próxima página, escolha **Permitir** para permitir que a Amazon Q acesse seus dados.
Agora você deve estar logado no Amazon Q JupyterLab com o Builder ID.
Para começar a codificar, consulte [Usar teclas de atalho com o](actions-and-shortcuts.md).
![\[Um exemplo do Amazon Q em uso com JupyterLab.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/qdev-demo-example.png)
# Como usar o Amazon Q Developer com o Amazon EMR Studio
Esta página descreve como configurar e ativar o Amazon Q Developer para o Amazon EMR Studio. Depois de ativado, o Amazon Q pode fazer recomendações de código automaticamente à medida que você escreve seu código ETL.
**nota**
O Amazon Q é compatível com Python, que pode ser usado para codificar scripts ETL para trabalhos do Spark no Amazon EMR Studio.
Use o seguinte procedimento para configurar o Amazon EMR Studio para trabalhar com o Amazon Q.
1. Configure o [caderno do Amazon EMR Studio](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-managed-notebooks-create.html).
1. Anexe a seguinte política ao perfil de usuário do IAM no caderno do Amazon EMR Studio.
**nota**
O prefixo `codewhisperer` é um nome antigo de um serviço que foi fundido com o Amazon Q Developer. Para obter mais informações, consulte [Renomeação Amazon Q Developer: Resumo das alterações](service-rename.md).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AmazonQDeveloperPermissions",
"Effect": "Allow",
"Action": [
"codewhisperer:GenerateRecommendations"
],
"Resource": "*"
}
]
}
```
------
1. Abra o [console do Amazon EMR](https://console.aws.amazon.com/emr).
1. Em Amazon EMR Studio, escolha **Workspaces (Notebooks).**
1. Selecione seu WorkSpace e clique em **Excluir**.
# Usando o Amazon Q Developer com o AWS Glue Studio
Esta página descreve como configurar e ativar o Amazon Q Developer para [cadernos do AWS Glue Studio](https://docs.aws.amazon.com/glue/latest/ug/notebooks-chapter.html). Depois de ativado, o Amazon Q pode fazer recomendações de código automaticamente à medida que você escreve seu código ETL.
**nota**
O Amazon Q é compatível com Python e Scala, as duas linguagens usadas para codificar scripts ETL para trabalhos do Spark no Studio. AWS Glue
No procedimento a seguir, você será configurado AWS Glue para trabalhar com o Amazon Q.
1. [Configure o AWS Glue Studio Notebook](https://docs.aws.amazon.com/glue/latest/ug/notebook-getting-started.html).
1. Anexe a política a seguir ao seu perfil do IAM para o caderno do Glue Studio
**nota**
O prefixo `codewhisperer` é um nome antigo de um serviço que foi fundido com o Amazon Q Developer. Para obter mais informações, consulte [Renomeação Amazon Q Developer: Resumo das alterações](service-rename.md).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AmazonQDeveloperPermissions",
"Effect": "Allow",
"Action": [
"codewhisperer:GenerateRecommendations"
],
"Resource": "*"
}
]
}
```
------
1. Abra o [Console do Glue](https://console.aws.amazon.com/glue).
1. Em **Tarefas de ETL**, escolha **Notebooks**.
1. Verifique se o **caderno Jupyter** está selecionado. Escolha **Criar**.
1. Insira um **nome de trabalho**.
1. Para perfil do IAM, selecione a função do que você configurou para interagir com o Amazon Q
1. Escolha **Iniciar caderno**.
# Usando o Amazon Q Developer com AWS Lambda
Este documento descreve como ativar o Amazon Q Developer no console do Lambda. Após ser ativado, o Amazon Q pode fazer recomendações de código sob demanda no editor de código do Lambda conforme você desenvolve sua função.
**nota**
No console do Lambda, o Amazon Q é compatível apenas com funções que usam os runtimes Python e Node.js.
## AWS Identity and Access Management permissões para Lambda
Para que o Amazon Q forneça recomendações no console do Lambda, você deve ativar as permissões corretas do IAM para seu usuário ou perfil do IAM. Você deve adicionar a permissão `codewhisperer:GenerateRecommendations`, conforme descrito no seguinte exemplo de política do IAM:
**nota**
O prefixo `codewhisperer` é um nome antigo de um serviço que foi fundido com o Amazon Q Developer. Para obter mais informações, consulte [Renomeação Amazon Q Developer: Resumo das alterações](service-rename.md).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AmazonQDeveloperPermissions",
"Effect": "Allow",
"Action": ["codewhisperer:GenerateRecommendations"],
"Resource": "*"
}
]
}
```
------
É prática recomendada usar políticas do IAM para conceder permissões restritivas às entidades principais do IAM. Para obter detalhes sobre como trabalhar com o IAM para AWS Lambda, consulte [Gerenciamento de identidade e acesso AWS Lambda no](https://docs.aws.amazon.com/lambda/latest/dg/security-iam.html) *Guia do AWS Lambda desenvolvedor*.
## Ativar o Amazon Q Developer com o Lambda
Para ativar o Amazon Q no editor de código do console do Lambda, realize estas etapas.
1. Abra a [página Funções](https://console.aws.amazon.com/lambda/home#/functions) do console do Lambda e escolha a função que deseja editar.
1. Conforme você digita no editor de código, as sugestões automáticas de código do Amazon Q são habilitadas por padrão. Para pausar as sugestões, escolha **Amazon Q** no canto inferior esquerdo do painel **Código-fonte**. A paleta de comandos é aberta na parte superior do painel Código-fonte. A partir daí, escolha **Pausar sugestões automáticas**.
Para teclas de atalho, consulte [Usar teclas de atalho com o](actions-and-shortcuts.md).
# Como usar o Amazon Q Developer com outros serviços
## AWS Identity and Access Management permissões para outros serviços
Para que o Amazon Q forneça recomendações no contexto de outro serviço, é necessário ativar as permissões de IAM corretas para o usuário ou a perfil do IAM. Você deve adicionar a permissão `codewhisperer:GenerateRecommendations`, conforme descrito no seguinte exemplo de política do IAM:
**nota**
O prefixo `codewhisperer` é um nome antigo de um serviço que foi fundido com o Amazon Q Developer. Para obter mais informações, consulte [Renomeação Amazon Q Developer: Resumo das alterações](service-rename.md).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AmazonQDeveloperPermissions",
"Effect": "Allow",
"Action": ["codewhisperer:GenerateRecommendations"],
"Resource": "*"
}
]
}
```
------
É prática recomendada usar políticas do IAM para conceder permissões restritivas às entidades principais do IAM. Para obter detalhes sobre como trabalhar com o IAM, consulte [Práticas recomendadas de segurança no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) no *Guia do usuário do IAM*.
# Usar teclas de atalho com o
Ao receber sugestões em linha do Amazon Q, você pode usar atalhos de teclado para ações comuns que você realiza, como iniciar o Amazon Q ou aceitar uma recomendação.
Escolha o ambiente de desenvolvimento integrado (IDE) em que você está desenvolvendo o código para ver os atalhos de teclado do seu IDE.
------
#### [ Código do Visual Studio ]
| Ação | Atalho de teclado |
| --- | --- |
| Iniciar manualmente o Amazon Q | MacOS: Option \$1 C Windows: Alt \$1 C |
| Aceitar uma recomendação | Tab |
| Próxima recomendação | Arrow |
| Recomendação anterior | Arrow para a esquerda |
| Rejeitar uma recomendação | Pressione ESC, backspace ou continue digitando. A recomendação desaparecerá assim que houver incompatibilidade de caracteres. |
| Aceitar a próxima palavra | Cmd \$1 seta para a direita |
Para alterar os atalhos de teclado no VS Code, consulte [Key Bindings for Visual Studio Code no site do VS Code](https://code.visualstudio.com/docs/getstarted/keybindings).
**nota**
A barra de ferramentas de sugestões embutidas no VS Code está desabilitada por padrão. Para obter mais informações, consulte [Barra de ferramentas de sugestões embutidas redesenhada no site](https://code.visualstudio.com/updates/v1_75#_redesigned-inline-suggestions-toolbar) do VS Code.
------
#### [ JetBrains ]
| Ação | Atalho de teclado |
| --- | --- |
| Iniciar manualmente o Amazon Q | MacOS: Option \$1 C Windows: Alt \$1 C |
| Aceitar uma recomendação | Tab |
| Próxima recomendação | Arrow |
| Recomendação anterior | Arrow para a esquerda |
| Rejeitar uma recomendação | Pressione ESC, backspace ou continue digitando. A recomendação desaparecerá assim que houver incompatibilidade de caracteres. |
[Para alterar as combinações de teclas no IntelliJ, consulte os atalhos de teclado do IntelliJ IDEA no site.](https://www.jetbrains.com/help/idea/mastering-keyboard-shortcuts.html) JetBrains
------
#### [ Eclipse ]
| Ação | Atalho de teclado |
| --- | --- |
| Iniciar manualmente o Amazon Q | MacOS: Option \$1 C Windows: Alt \$1 C |
| Aceitar uma recomendação | Tab |
| Próxima recomendação | MacOS: Option \$1 ] Windows: Alt \$1 ] |
| Recomendação anterior | MacOS: Option \$1 [ Windows: Alt \$1 [ |
| Rejeitar uma recomendação | Pressione ESC, backspace ou continue digitando. A recomendação desaparecerá assim que houver incompatibilidade de caracteres. |
Para alterar as combinações de teclas no Eclipse, consulte [Changing the key bindings](https://help.eclipse.org/latest/index.jsp?topic=%2Forg.eclipse.platform.doc.user%2Ftasks%2Ftkeybindings.htm) na documentação do Eclipse.
------
#### [ Toolkit for Visual Studio ]
| Ação | Atalho de teclado |
| --- | --- |
| Iniciar manualmente o Amazon Q `AWSToolkit.CodeWhisperer.GetSuggestion`nas combinações de teclas | Windows: Alt \$1 C |
| Aceitar uma recomendação | Tab |
| Próxima recomendação `Edit.NextSuggestion`nas combinações de teclas | Windows: Alt \$1 . |
| Recomendação anterior `Edit.PreviousSuggestion`nas combinações de teclas | Windows: Alt \$1 , |
| Rejeitar uma recomendação | Pressione ESC, backspace ou continue digitando. A recomendação desaparecerá assim que houver incompatibilidade de caracteres. |
Veja também os atalhos de [teclado padrão do Visual Studio](https://visualstudio.microsoft.com/keyboard-shortcuts.pdf) da Microsoft.
Para alterar as combinações de teclas no Visual Studio, use Ferramentas -> Opções -> Teclado.
------
#### [ Amazon SageMaker AI ]
| Ação | Atalho de teclado |
| --- | --- |
| Iniciar manualmente o Amazon Q | MacOS: Option \$1 C Windows: Alt \$1 C |
| Aceitar uma recomendação | Tab |
| Próxima recomendação | Arrow |
| Recomendação anterior | Arrow |
| Rejeitar uma recomendação | ESC |
------
#### [ JupyterLab ]
| Ação | Atalho de teclado |
| --- | --- |
| Iniciar manualmente o Amazon Q | MacOS: Option \$1 C Windows: Alt \$1 C |
| Aceitar uma recomendação | Tab |
| Próxima recomendação | Arrow |
| Recomendação anterior | Arrow |
| Rejeitar uma recomendação | ESC |
------
#### [ AWS Glue Studio Notebook ]
| Ação | Atalho de teclado |
| --- | --- |
| Iniciar manualmente o Amazon Q | MacOS: Option \$1 C Windows: Alt \$1 C |
| Aceitar uma recomendação | Tab |
| Próxima recomendação | Arrow |
| Recomendação anterior | Arrow |
| Rejeitar uma recomendação | ESC |
------
#### [ AWS Lambda ]
| Ação | Atalho de teclado |
| --- | --- |
| Obter uma sugestão de código manualmente | MacOS: Option \$1 C Windows: Alt \$1 C |
| Aceitar uma sugestão | Tab |
| Rejeitar uma sugestão | Pressione ESC, espaço, role a barra em qualquer direção ou continue digitando, e a recomendação desaparecerá automaticamente. |
Para alterar o tamanho da amostra, use o procedimento a seguir.
1. Ao visualizar uma função específica, escolha o ícone de engrenagem para abrir a guia **Preferências**.
1. Na guia **Preferências**, selecione **Mapeamentos de teclas**.
1. Na caixa de pesquisa de atalhos de teclado, digite Amazon Q.
![\[Keybindings settings in AWS Cloud9 IDE with Amazon CodeWhisperer option highlighted.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/CWSPR-Lambda-keybinding-settings.png)
------
#### [ AWS Cloud9 ]
| Ação | Atalho de teclado |
| --- | --- |
| Obter uma sugestão de código manualmente | MacOS: Option \$1 C Windows: Alt \$1 C |
| Aceitar uma sugestão | Tab |
| Rejeitar uma sugestão | Pressione ESC, espaço, role a barra em qualquer direção ou continue digitando, e a recomendação desaparecerá automaticamente. |
1. Ao visualizar um ambiente específico, escolha o ícone de engrenagem para abrir a guia **Preferências**.
1. Na guia **Preferências**, selecione **Mapeamentos de teclas**.
1. Na caixa de pesquisa de atalhos de teclado, digite Amazon Q.
1. Na coluna Pressão de tecla, clique duas vezes no espaço correspondente à função na qual você está interessado.
1. Insira as chaves às quais você deseja vincular a função.
![\[AWS Cloud9 interface showing Keybindings settings with options for keyboard mode and custom keybindings.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/CWSPR-C9-keybinding-settings.png)
------
# Usando referências de código
O Amazon Q aprende, em parte, com projetos de código aberto. Às vezes, uma sugestão oferecida pode ser semelhante a um código disponível publicamente. As referências de código incluem informações sobre a fonte que o Amazon Q usou para gerar uma recomendação.
**Topics**
+ [Visualize e atualize referências de código](#show-code-reference)
+ [Ativar e desativar referências de código](#toggle-code-reference)
+ [Cancelar código com referências](#opt-out-code-reference)
## Visualize e atualize referências de código
Com o log de referência, você pode visualizar referências a recomendações de código que são semelhantes à código disponível publicamente. Você também pode atualizar e editar recomendações de código sugeridas pela Amazon Q.
Escolha seu IDE para ver as etapas de como visualizar e atualizar as referências de código.
------
#### [ Visual Studio Code ]
Para exibir o login de referência do Amazon Q no VS Code, utilize o procedimento a seguir.
1. Verifique se você está usando a versão mais recente de ambos VS Code e a extensão Amazon Q.
1. Em VS Code, escolha **Amazon Q** na bandeja de componentes na parte inferior da janela do IDE.
A barra de tarefas do Amazon Q é aberta na parte superior da janela do IDE.
1. Escolha **Abrir log de referência de código**.
A guia do log de referência de código é aberta. Todas as referências às recomendações de código são listadas.
A imagem a seguir mostra a barra de tarefas aberta do Amazon Q e a guia de log de referência de código.
![\[O login de referência do Amazon Q code no Visual Studio Code.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/VSC-coderef.png)
------
#### [ JetBrains ]
Para exibir o login de referência do Amazon Q no JetBrains IDEs, utilize o procedimento a seguir.
1. Verifique se você está usando a versão mais recente do seu JetBrains IDE e do plug-in Amazon Q.
1. Em JetBrains, escolha **Amazon Q** na barra de status na parte inferior da janela do IDE.
A barra de tarefas do Amazon Q é aberta acima da barra de status.
1. Escolha **Abrir log de referência de código**.
A guia do log de referência de código é aberta. Todas as referências às recomendações de código são listadas.
A imagem a seguir mostra a barra de tarefas aberta do Amazon Q e a guia de log de referência de código.
![\[O login de referência do Amazon Q code no JetBrains.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/JB-coderef.png)
------
#### [ Eclipse ]
Para exibir o login de referência do Amazon Q no Eclipse IDEs, utilize o procedimento a seguir.
1. Verifique se você está usando a versão mais recente do IDE do Eclipse e do plug-in do Amazon Q.
1. No IDE do Eclipse, selecione o ícone do **Amazon Q** no canto superior direito.
1. Com a guia de chat do Amazon Q aberta, selecione o ícone de elipse (três pontos) no canto superior direito da guia. A barra de tarefas do Amazon Q é aberta.
A imagem a seguir mostra a barra de tarefas do Amazon Q em um IDE do Eclipse.
![\[A barra de tarefas do Amazon Q em um IDE do Eclipse.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/eclipse-taskbar.png)
1. Escolha **Abrir log de referência de código**.
A guia do log de referência de código é aberta. Todas as referências às recomendações de código são listadas.
------
#### [ Toolkit for Visual Studio ]
Quando o Amazon Q sugere um código que contém uma referência no Toolkit for Visual Studio, o tipo de referência aparece na descrição da sugestão.
![\[Code snippet showing a function to create a DynamoDB table with 'Products' as the table name.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/visual-studio-view-code-suggestions.png)
Todas as sugestões aceitas que contêm referências são registradas no log de referência.
Para acessar o registro de referência, escolha o AWS ícone e selecione **Abrir registro de referência de código**.
Uma lista de sugestões aceitas que contêm referências será exibida. Essa lista inclui:
+ O local em que a sugestão foi aceita. Clicar duas vezes nele levará você ao local em seu código.
+ A licença associada
+ O código-fonte referenciado
+ O fragmento de código atribuído à referência
![\[CodeWhisperer Reference Log output showing accepted recommendation with MIT license.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/vstudio-reference-log2.png)
------
#### [ AWS Cloud 9 ]
Quando você usa o Amazon Q com o AWS Cloud 9, as referências de código estão ativadas por padrão.
Para desativá-los ou ligá-los novamente mais tarde, use o procedimento a seguir.
1. No console AWS Cloud 9, no canto superior esquerdo, escolha o logotipo AWS Cloud 9.
1. Selecione **Preferências** no menu suspenso.
No lado direito do console, a guia **Preferências** será aberta.
1. Na guia **Preferências**, em **Configurações do projeto**, em **Extensões**, selecione **Kit de ferramentas da AWS **.
1. Selecione ou desmarque **Amazon Q: Incluir sugestões com referências de código**.
------
#### [ Lambda ]
O Amazon Q no Lambda não oferece suporte a referências de código. Quando você usa o Amazon Q com o Lambda, todas as sugestões de código com referências são omitidas.
------
#### [ SageMaker AI Studio ]
Para exibir o registro de referência do Amazon Q no SageMaker AI Studio, use o procedimento a seguir.
1. Na parte inferior da janela do SageMaker AI Studio, abra o painel Amazon Q.
1. Escolha **Abrir log de referência de código**.
------
#### [ JupyterLab ]
Para exibir o login de referência do Amazon Q JupyterLab, use o procedimento a seguir.
1. Na parte inferior da JupyterLab janela, abra o painel Amazon Q.
1. Escolha **Abrir log de referência de código**.
------
#### [ AWS Glue Studio Notebook ]
Para exibir o registro de referência do Amazon Q no AWS Glue Studio Notebook, use o procedimento a seguir.
1. Na parte inferior da janela do AWS Glue Studio Notebook, abra o painel Amazon Q.
1. Escolha **Abrir log de referência de código**.
------
## Ativar e desativar referências de código
Na maioria das vezes IDEs, as referências de código estão ativadas por padrão. Escolha seu IDE para ver as etapas de como ativar ou desativar as referências de código.
------
#### [ Visual Studio Code ]
Quando você usa o Amazon Q com o VS Code, as referências de código estão ativadas por padrão.
Para desativá-los ou ligá-los novamente mais tarde, use o procedimento a seguir.
1. Verifique se você está usando a versão mais recente de ambos VS Code e a extensão Amazon Q.
1. Em VS Code, escolha **Amazon Q** na bandeja de componentes na parte inferior da janela do IDE.
A barra de tarefas do Amazon Q é aberta na parte superior da janela do IDE.
1. Escolha **Abrir configurações**. A guia de configurações é aberta com as opções relacionadas ao Amazon Q exibidas.
1. Marque ou desmarque a caixa ao lado de **Mostrar código com referências**.
------
#### [ JetBrains ]
Quando você usa o Amazon Q com seu JetBrains IDE, as referências de código estão ativadas por padrão.
Para desativá-los ou ligá-los novamente mais tarde, use o procedimento a seguir.
1. Verifique se você está usando a versão mais recente do seu JetBrains IDE e do plug-in Amazon Q.
1. Em JetBrains, escolha **Amazon Q** na barra de status na parte inferior da janela do IDE.
A barra de tarefas do Amazon Q é aberta acima da barra de status.
1. Escolha **Abrir configurações**. A janela de configurações é aberta com as opções relacionadas ao Amazon Q exibidas.
1. Marque ou desmarque a caixa ao lado de **Mostrar código com referências**.
------
#### [ Eclipse ]
Quando você usa o Amazon Q com o Eclipse, as referências de código estão ativadas por padrão.
Para desativá-los ou ligá-los novamente mais tarde, use o procedimento a seguir.
1. Verifique se você está usando a versão mais recente do IDE do Eclipse e do plug-in do Amazon Q.
1. Abra as **Configurações** no IDE do Eclipse.
1. Selecione **Amazon Q** na barra de navegação à esquerda.
1. Marque ou desmarque a caixa ao lado de **Mostrar código com referências**.
1. Selecione **Apply (Aplicar)** para salvar as alterações.
------
#### [ Toolkit for Visual Studio ]
Quando você usa o Amazon Q no Toolkit para Visual Studio, as referências de código são ativadas por padrão.
Para desativá-los ou ligá-los novamente mais tarde, use o procedimento a seguir.
1. Use a versão mais recente do Toolkit para Visual Studio.
1. No Visual Studio, abra **Opções**.
1. Escolha **AWS Toolkit** na barra de navegação à esquerda e, em seguida, **Amazon Q**.
1. No menu suspenso ao lado de **Incluir sugestões com referências**, selecione Verdadeiro ou Falso.
1. Escolha **OK** para salvar as alterações.
------
#### [ AWS Cloud 9 ]
Quando você usa o Amazon Q com o AWS Cloud 9, as referências de código estão ativadas por padrão.
Para desativá-los ou ligá-los novamente mais tarde, use o procedimento a seguir.
1. No console AWS Cloud 9, no canto superior esquerdo, escolha o logotipo AWS Cloud 9.
1. Selecione **Preferências** no menu suspenso.
No lado direito do console, a guia **Preferências** será aberta.
1. Na guia **Preferências**, em **Configurações do projeto**, em **Extensões**, selecione **Kit de ferramentas da AWS **.
1. Selecione ou desmarque **Amazon Q: Incluir sugestões com referências de código**.
------
#### [ Lambda ]
O Amazon Q no Lambda não oferece suporte a referências de código. Quando você usa o Amazon Q com o Lambda, todas as sugestões de código com referências são omitidas.
------
#### [ SageMaker AI Studio ]
Quando você usa o Amazon Q com o SageMaker AI Studio, as referências de código estão ativadas por padrão.
Para desativá-los ou ligá-los novamente mais tarde, use o procedimento a seguir.
1. Na parte superior da janela do SageMaker AI Studio, escolha **Configurações**.
1. No menu suspenso **Configurações**, escolha **Editor de configurações avançadas**.
1. No menu suspenso Amazon Q, marque ou desmarque a caixa ao lado de **Habilitar sugestões com referências de código**.
------
#### [ JupyterLab ]
Quando você usa o Amazon Q com JupyterLab, as referências de código estão ativadas por padrão.
Para desativá-los ou ligá-los novamente mais tarde, use o procedimento a seguir.
1. Na parte superior da JupyterLab janela, escolha **Configurações**.
1. No menu suspenso **Configurações**, escolha **Editor de configurações avançadas**.
1. No menu suspenso Amazon Q, marque ou desmarque a caixa ao lado de **Habilitar sugestões com referências de código**.
------
#### [ AWS Glue Studio Notebook ]
1. Na parte inferior da janela do AWS Glue Studio Notebook, escolha **Amazon Q.**
1. No menu pop-up, ative o botão ao lado de **Código com referências**.
**nota**
As referências de código de pausa serão válidas somente durante o AWS Glue Studio Notebook atual.
------
## Cancelar código com referências
Em alguns IDEs, você pode optar por não receber sugestões com referências no nível do administrador.
Escolha seu IDE para ver as etapas para optar por não participar como administrador.
------
#### [ Visual Studio Code ]
Se você for administrador corporativo, poderá optar por não receber sugestões com referências de código para toda a organização. Se você fizer isso, desenvolvedores individuais em sua organização não poderão optar por voltar por meio do IDE. Esses desenvolvedores poderão marcar e desmarcar a caixa discutida na seção anterior, mas isso não terá efeito se você optar por não participar no nível corporativo.
Para optar por não receber sugestões com referências no nível corporativo, use o procedimento a seguir.
1. No console do Amazon Q Developer, escolha **Configurações**.
1. No painel de **detalhes da conta do Amazon Q Developer**, escolha **Editar**.
1. Na página Editar detalhes, no painel **Configurações avançadas**, desmarque **Incluir sugestões com referências de código**.
1. Escolha **Salvar alterações**.
------
#### [ JetBrains ]
Se você for administrador corporativo, poderá optar por não receber sugestões com referências de código para toda a organização. Se você fizer isso, desenvolvedores individuais em sua organização não poderão optar por voltar por meio do IDE. Esses desenvolvedores poderão marcar e desmarcar a caixa discutida na seção anterior, mas isso não terá efeito se você optar por não participar no nível corporativo.
Para optar por não receber sugestões com referências no nível corporativo, use o procedimento a seguir.
1. No console do Amazon Q Developer, escolha **Configurações**.
1. No painel de **detalhes da conta do Amazon Q Developer**, escolha **Editar**.
1. Na página Editar detalhes, no painel **Configurações avançadas**, desmarque **Incluir sugestões com referências de código**.
1. Escolha **Salvar alterações**.
------
#### [ Eclipse ]
Se você for administrador corporativo, poderá optar por não receber sugestões com referências de código para toda a organização. Se você fizer isso, desenvolvedores individuais em sua organização não poderão optar por voltar por meio do IDE. Esses desenvolvedores poderão marcar e desmarcar a caixa discutida na seção anterior, mas isso não terá efeito se você optar por não participar no nível corporativo.
Para optar por não receber sugestões com referências no nível corporativo, use o procedimento a seguir.
1. No console do Amazon Q Developer, escolha **Configurações**.
1. No painel de **detalhes da conta do Amazon Q Developer**, escolha **Editar**.
1. Na página Editar detalhes, no painel **Configurações avançadas**, desmarque **Incluir sugestões com referências de código**.
1. Escolha **Salvar alterações**.
------
#### [ Toolkit for Visual Studio ]
Para optar por não receber sugestões com referências no nível corporativo, use o procedimento a seguir.
1. É possível acessar a configuração de referências de código de uma duas formas:
1. Escolha o ícone Amazon Q na borda da janela e, em seguida, escolha **Opções...**
1. Vá para **Ferramentas** -> **Kit de ferramentas da AWS ** -> **Amazon Q**
1. Altere a opção para **Verdadeiro** ou **Falso**, dependendo se você deseja incluir sugestões com referências.
------
#### [ AWS Cloud 9 ]
O Amazon Q in AWS Cloud 9 não suporta a exclusão de sugestões de código com referências no nível corporativo.
Para optar por não participar no nível de desenvolvedor individual, consulte Alternar referências de código.
------
#### [ Lambda ]
O Amazon Q no Lambda não oferece suporte a referências de código. Quando você usa o Amazon Q com o Lambda, todas as sugestões de código com referências são omitidas.
------
#### [ SageMaker AI Studio ]
O Amazon Q não suporta a exclusão de sugestões de código com referências no nível corporativo no SageMaker AI Studio.
------
#### [ JupyterLab ]
O Amazon Q não suporta a exclusão de sugestões de código com referências no nível corporativo em JupyterLab.
------
#### [ AWS Glue Studio Notebook ]
O Amazon Q não suporta a exclusão de sugestões de código com referências no AWS Glue Studio Notebook.
------
# Exemplos de código
O Amazon Q pode sugerir código em diferentes cenários. Para entender como isso pode ajudá-lo a escrever código na linguagem de programação de sua escolha, veja os exemplos de código a seguir.
**Topics**
+ [Usando o Amazon Q Developer para preenchimento de código de linha única](single-line-completion.md)
+ [Usando o Amazon Q Developer para geração completa de funções](full-function-generation.md)
+ [Usando o Amazon Q Developer para conclusão de blocos](code-block.md)
+ [Usando o Amazon Q Developer para conclusão de Docstring, JSDoc e Javadoc](docstring-javadoc.md)
+ [Usando o Amazon Q Developer para recomendações linha por linha](line-by-line-1.md)
# Usando o Amazon Q Developer para preenchimento de código de linha única
Quando você começa a digitar um código de linha única, o Amazon Q faz sugestões com base nas entradas atuais e anteriores.
------
#### [ C\$1\$1 ]
![\[Um exemplo do atributo de preenchimento de linha única usando o C++.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/single-line-completion-c-plus.gif)
------
#### [ JavaScript ]
Neste exemplo, o Amazon Q completa uma linha de código que o desenvolvedor inicia.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/javascript_vscode_SingleLine.gif)
------
#### [ TypeScript ]
Neste exemplo, o usuário insere um comentário completo e, em seguida, a Amazon Q fornece o código que o acompanha.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/typescript_vscode_single-line.gif)
------
#### [ C\$1 ]
Neste exemplo, o Amazon Q fornece uma recomendação de linha única com base em um comentário.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/c-sharp-single-line.gif)
------
#### [ Shell ]
Na imagem abaixo, o Amazon Q oferece recomendações sobre como preencher uma única linha de código.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/jb-single-line-shell.gif)
------
#### [ Java ]
Quando você começa a digitar um código de linha única, o Amazon Q faz sugestões com base nas entradas atuais e anteriores.
No exemplo abaixo, em Java, um usuário insere a cadeia de caracteres `public` em uma classe existente.
Com base na entrada, o Amazon Q gera uma sugestão para a assinatura do método principal.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-c9-single-line-completion.gif)
------
#### [ Python ]
Neste exemplo, a Amazon Q recomenda uma única linha de código, com base no comentário do desenvolvedor.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_singleline.gif)
------
# Usando o Amazon Q Developer para geração completa de funções
O Amazon Q consegue gerar uma função inteira com base em um comentário que você escreveu. Ao terminar seu comentário, o Amazon Q sugerirá uma assinatura de função. Se você aceitar a sugestão, o Amazon Q avançará automaticamente o cursor para a próxima parte da função e fará uma sugestão. Mesmo que você insira outro comentário ou uma linha de código entre as sugestões, o Amazon Q refatorará com base na entrada.
------
#### [ C ]
![\[Um exemplo do atributo de preenchimento completo da função usando C.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/full-function-completion-c-plus.gif)
------
#### [ C\$1\$1 ]
![\[Um exemplo do atributo de preenchimento completo da função usando C++.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/full-function-completion-c-plus.gif)
------
#### [ JavaScript ]
No exemplo a seguir, o usuário gera e, em seguida, edita uma função completa com base em um conjunto de comentários.
![\[Um exemplo do atributo de geração de funções completas.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/javascript_lambda_FullFunctionGeneration.gif)
Na imagem a seguir, o usuário escreveu uma assinatura de função para ler um arquivo do Amazon S3. Em seguida, o Amazon Q sugere uma implementação completa do método `read_from_s3`.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-function-read-from-s3.png)
**nota**
Às vezes, como no exemplo anterior, o Amazon Q inclui declarações `import` como parte das sugestões. Como prática recomendada, mova manualmente essas declarações `import` para a parte superior do arquivo.
Como outro exemplo, na imagem a seguir, o usuário escreveu uma assinatura de função. Em seguida, o Amazon Q sugere uma implementação completa do método `quicksort`.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-function-quicksort.png)
Ao fazer sugestões, o Amazon Q leva em consideração trechos de código anteriores. Na imagem a seguir, o usuário do exemplo anterior aceitou a implementação sugerida para `quicksort` acima. O usuário então grava outra assinatura de função para um método `sort` genérico. O Amazon Q sugere uma implementação com base no que já foi gravado.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-function-from-context-sort.png)
Na imagem a seguir, o usuário escreveu um comentário. Com base nesse comentário, o Amazon Q sugere uma assinatura de função.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-comment-binary-search.png)
Na imagem a seguir, o usuário do exemplo anterior aceitou a assinatura de função sugerida. O Amazon Q pode então sugerir uma implementação completa da função `binary_search`.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-function-binary-search.png)
------
#### [ Java ]
A lista a seguir contém exemplos de como o Amazon Q faz sugestões e orienta você por todo o processo de criar uma função.
1. No exemplo a seguir, um usuário insere um comentário. O Amazon Q sugere uma assinatura de função.
Depois que o usuário aceita a sugestão, o Amazon Q sugere um corpo da função.
![\[Um exemplo de função gerada com base em um comentário.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-c9-function-from-comment.gif)
1. Na imagem abaixo, o usuário insere um comentário no corpo da função antes de aceitar uma sugestão do Amazon Q. Na linha a seguir, o Amazon Q gera uma sugestão com base no comentário.
![\[Um exemplo de função gerada com base em um comentário dentro de um bloco de código existente.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-c9-function-from-comment-within-block.gif)
------
#### [ C\$1 ]
No exemplo a seguir, o Amazon Q recomenda uma função completa.
![\[Function declaration for ListTables with AmazonDynamoDBClient parameter in code editor.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/c-sharp-full-function.gif)
------
#### [ TypeScript ]
No exemplo a seguir, o Amazon Q gera uma função com base nas docstrings do usuário.
![\[Um exemplo do atributo de preenchimento do bloco.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/typescript_vscode_function.gif)
------
#### [ Python ]
O Amazon Q consegue gerar uma função inteira com base em um comentário que você escreveu. Ao terminar seu comentário, o Amazon Q sugerirá uma assinatura de função. Se você aceitar a sugestão, o Amazon Q avançará automaticamente o cursor para a próxima parte da função e fará uma sugestão. Mesmo que você insira outro comentário ou uma linha de código entre as sugestões, o Amazon Q refatorará com base na entrada.
No exemplo a seguir, o Amazon Q gera uma função completa e o teste de unidade correspondente.
![\[Um exemplo do atributo de preenchimento do bloco.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/python_pycharm_fullfunction_unittests.GIF)
A lista a seguir contém exemplos de como o Amazon Q faz sugestões e orienta você por todo o processo de criar uma função.
1. Na imagem abaixo, um usuário inseriu um comentário. A assinatura da função, localizada abaixo do comentário, é uma sugestão da Amazon Q.
![\[alt_text\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-jb-comment-062022.png)
1. Na imagem abaixo, o usuário aceitou a sugestão do Amazon Q para uma assinatura de função. Aceitar a sugestão avançou automaticamente o cursor e a Amazon Q fez uma nova sugestão para o corpo da função.
![\[alt_text\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-jb-commentfunctionadvance-062022.png)
1. Na imagem abaixo, o usuário insere um comentário no corpo da função antes de aceitar uma sugestão do Amazon Q. Na linha a seguir, o Amazon Q gerou uma nova sugestão com base no conteúdo do comentário.
![\[gerando uma nova sugestão com base no conteúdo de um comentário\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-jb-commentfunction-062022.png)
Neste exemplo, a Amazon Q recomenda uma função completa após o usuário digitar parte da assinatura.
![\[Um exemplo do atributo de função completa.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_fullfunction.gif)
------
# Usando o Amazon Q Developer para conclusão de blocos
O preenchimento do bloco é usado para preencher blocos de código `if/for/while/try`.
------
#### [ C ]
![\[Um exemplo do atributo de preenchimento do bloco.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/block-completion-c.gif)
------
#### [ C\$1\$1 ]
![\[Um exemplo do atributo de preenchimento do bloco.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/block-completion-c-plus.gif)
------
#### [ Java ]
No exemplo abaixo, em Java, um usuário insere a assinatura de uma instrução `if`. O corpo da instrução é uma sugestão do Amazon Q.
![\[Um exemplo do atributo de preenchimento do bloco.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-c9-block-completion.gif)
------
#### [ C\$1 ]
Na imagem abaixo, a Amazon Q recomenda uma forma de concluir a função.
![\[Um exemplo do atributo de preenchimento do bloco.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/c-sharp-block.gif)
------
#### [ TypeScript ]
Na imagem abaixo, a Amazon Q recomenda uma forma de concluir a função.
![\[Um exemplo do atributo de preenchimento do bloco.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/typescript_vscode_block-completion.gif)
------
#### [ Python ]
Neste exemplo, o Amazon Q recomenda um bloco de código, com base no contexto.
![\[Um exemplo do atributo de bloco de código.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_codeblock.gif)
------
# Usando o Amazon Q Developer para conclusão de Docstring, JSDoc e Javadoc
O Amazon Q pode ajudar você a gerar ou completar a documentação dentro do seu código.
------
#### [ C\$1\$1 ]
![\[Um exemplo do atributo de preenchimento de docstring usando C++.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/docstring-completion-c-plus.gif)
------
#### [ Javascript ]
Neste exemplo, o Amazon Q preenche os parâmetros do JSDoc com base nas constantes existentes.
![\[Um exemplo do atributo de conclusão do JSDoc.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/javascript_vscode_JSDocCompletion.gif)
------
#### [ C\$1 ]
Neste exemplo, o Amazon Q preenche os parâmetros do JSDoc com base nas constantes existentes.
![\[Um exemplo de C3 com conclusão de DocString.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/c-sharp-docstring.gif)
------
#### [ Java ]
O exemplo a seguir foi adaptado de [um exemplo no site da Oracle](https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html).
Na imagem abaixo, o usuário começou a inserir uma docstring. O Amazon Q sugeriu palavras para adicionar à docstring.
![\[sugerindo uma função para completar uma docstring\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/jb-docstring-java.png)
O exemplo a seguir foi adaptado de [um exemplo no site da Oracle](https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html).
No exemplo abaixo, em Java, o usuário insere uma docstring. O Amazon Q sugere uma função para processar a docstring.
![\[Um exemplo de preenchimento de código baseado em um Javadoc.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/cw-c9-javadoc.gif)
------
#### [ Python ]
Neste exemplo, o Amazon Q recomenda uma Docstring, com base no contexto circundante.
![\[Um exemplo do atributo Docstring.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_commentblock.gif)
------
# Usando o Amazon Q Developer para recomendações linha por linha
Conforme o caso de uso, o Amazon Q pode não conseguir gerar um bloco de função inteiro em uma recomendação. Porém, o Amazon Q ainda pode fornecer recomendações linha por linha.
------
#### [ Go and GoLand ]
Neste exemplo, o Amazon Q fornece recomendações linha por linha.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/jb-line-by-line-go.gif)
Aqui está outro exemplo de recomendações linha por linha, desta vez com um teste unitário.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/jb-line-by-line-unit-test-go.gif)
------
#### [ C\$1\$1 and CLion ]
Neste exemplo, o Amazon Q fornece recomendações linha por linha.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/jb-line-by-line-cpp.gif)
------
#### [ Python ]
Na imagem a seguir, o cliente escreveu um comentário inicial indicando que deseja publicar uma mensagem em um grupo do Amazon CloudWatch Logs. Nesse contexto, o Amazon Q só pode sugerir o código de inicialização do cliente na primeira recomendação, como mostra a imagem a seguir.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-line-by-line-cwlogs-1.png)
Porém, se o usuário continuar solicitando recomendações linha por linha, o Amazon Q também continuará sugerindo linhas de código com base no que já foi escrito.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-line-by-line-cwlogs-2.png)
**nota**
No exemplo acima, `VPCFlowLogs` pode não ser o valor constante correto. À medida que o Amazon Q faz sugestões, lembre-se de renomear as constantes, conforme necessário.
O Amazon Q pode chegar a preencher todo o bloco de código, como mostra a imagem a seguir.
![\[\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/whisper-line-by-line-cwlogs-3.png)
Neste exemplo, o Amazon Q fornece recomendações, uma linha por vez.
![\[Um exemplo do atributo de preenchimento de linha única.\]](http://docs.aws.amazon.com/pt_br/amazonq/latest/qdeveloper-ug/images/python_sagemakerstudio_linebyline.gif)
------