Personalizar o Amazon Q Developer em aplicações do Amazon SageMaker Studio - Amazon SageMaker AI

Personalizar o Amazon Q Developer em aplicações do Amazon SageMaker Studio

Você pode personalizar o Amazon Q Developer nas aplicações do JupyterLab e do Editor de Código no Amazon SageMaker Studio. Quando você personaliza o Q Developer, ele fornece sugestões e respostas com base em exemplos da sua base de código. Se você usa o Amazon Q Developer Pro, é possível carregar todas as personalizações que você criou com esse serviço.

Personalizar no JupyterLab

No JupyterLab, você pode carregar qualquer personalização criada com o Amazon Q Developer Pro. Ou, no seu espaço do JupyterLab, você pode personalizar o Q Developer localmente com arquivos que você carrega no espaço.

Como usar personalizações que você criou no Amazon Q Developer Pro

Quando você carrega uma personalização, o Q Developer oferece sugestões com base na base de código que você usou para criar a personalização. Além disso, ao usar o chat no painel do Amazon Q, você interage com sua personalização.

Para ter mais informações sobre a configuração de personalizações, consulte Customizing suggestions no Guia do usuário do Amazon Q Developer.

Como carregar sua personalização

Abra seu espaço no JupyterLab e execute as etapas a seguir.

  1. Na barra de status na parte inferior do JupyterLab, escolha Amazon Q. Um menu é aberto.

  2. No menu, escolha Outros recursos. A guia Recursos do Amazon Q é aberta na área de trabalho principal.

  3. Na guia Recursos do Amazon Q, em Selecionar personalização, escolha sua personalização do Q Developer.

  4. Interaja com sua personalização de uma das seguintes formas:

    • Crie um caderno e escreva código nele. Ao fazer isso, o Q Developer fornece automaticamente sugestões personalizadas em linha com base na sua personalização.

    • Converse por chat com um desenvolvedor no painel do Amazon Q seguindo estas etapas:

      1. Na barra lateral esquerda do JupyterLab, escolha o ícone de chat do Jupyter AI. O painel Amazon Q será aberto.

      2. Use a caixa de chat Pergunte ao Amazon Q para interagir com sua personalização.

Como personalizar o Amazon Q Developer com arquivos em seu espaço no JupyterLab

No JupyterLab, você pode personalizar o Q Developer com arquivos que você carrega no seu espaço. Em seguida, no chat do painel do Amazon Q, você pode usar um comando para perguntar ao Q Developer sobre esses arquivos.

Quando você personaliza o Q Developer com arquivos em seu espaço, a personalização permanece somente em seu espaço. Não é possível carregar a personalização em outro lugar, como em outros espaços ou no console do Amazon Q Developer.

Você pode personalizar o Q Developer com arquivos no JupyterLab usando o Amazon Q Developer Pro ou o Amazon Q Developer do nível gratuito.

Como personalizar com seus arquivos

Abra seu espaço no JupyterLab e execute as etapas a seguir.

  1. Verifique se seu espaço está configurado com o modelo de incorporação necessário. Você pode personalizar o Q Developer no JupyterLab somente se usar o modelo de incorporação padrão, que é CodeSage :: codesage-small. Para verificar, faça o seguinte;

    1. Na barra lateral esquerda do JupyterLab, escolha o ícone de chat do Jupyter AI. O painel Amazon Q será aberto.

    2. Escolha o ícone de configurações no canto superior direito do painel.

    3. Em Modelo de incorporação, se necessário, escolha CodeSage :: codesage-small e selecione Salvar alterações.

    4. No canto superior direito do painel, escolha o ícone para voltar.

  2. Para fazer upload de arquivos com os quais você deseja personalizar o Q Developer, no painel Navegador de arquivos, escolha o ícone de upload de arquivos.

  3. Depois de carregar os arquivos, na caixa de chat Pergunte ao Amazon Q, digite /learn file path/. Substitua o caminho do arquivo/ pelo caminho para seus arquivos no espaço do JupyterLab. Quando o Amazon Q termina de processar seus arquivos, ele confirma com uma mensagem de chat no painel do Amazon Q.

  4. Para fazer uma pergunta ao Q Developer sobre seus arquivos, digite /ask na caixa de chat e siga o comando com sua pergunta. O Amazon Q gera uma resposta com base em seus arquivos e responde no chat.

Para ter mais informações sobre os comandos /learn e /ask (p. ex., os respectivos argumentos e opções compatíveis), consulte Learning about local data na documentação do usuário do Jupyter AI. Essa página explica como usar os comandos com o chatbot Jupyternaut AI. O JupyterLab no Amazon SageMaker Studio aceita a mesma sintaxe de comando.

Personalizar no Editor de Código

Se você criou uma personalização no Amazon Q Developer Pro, é possível carregá-la no Editor de Código. Desse modo, quando o Q Developer oferece sugestões para seu código, ele utiliza como referência a base de código que você usou para criar a personalização. Além disso, ao usar o chat no painel do Amazon Q: chat, você interage com sua personalização.

Como usar personalizações que você criou no Amazon Q Developer Pro

Abra seu espaço no Editor de Código e conclua as etapas a seguir.

  1. No menu “Editor de código”, escolha Visualizar e selecione Paleta de comandos.

  2. Na paleta de comandos, comece a digitar >Amazon Q: Select Customization e escolha essa opção na lista filtrada de comandos quando ela aparecer. A paleta de comandos mostra suas personalizações do Q Developer.

  3. Escolha sua personalização.

  4. Interaja com sua personalização de uma das seguintes formas:

    • Crie um arquivo Python ou um caderno Jupyter e escreva código nele. Ao fazer isso, o Q Developer fornece automaticamente sugestões personalizadas em linha com base na sua personalização.

    • Converse por chat com um desenvolvedor no painel do Amazon Q seguindo estas etapas:

      1. Na barra lateral esquerda do Editor de Código, escolha o ícone do Amazon Q. O painel Amazon Q: chat é aberto.

      2. Use a caixa de chat para interagir com sua personalização.

Para ter mais informações sobre os recursos do Q Developer, consulte Using Amazon Q Developer in the IDE no Guia do usuário do Amazon Q Developer.