Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Amazon Q Developer Amazon Q Developer es un asistente conversacional de IA generativa que le ayuda a escribir mejor código. Amazon Q Developer está disponible de la siguiente IDEs manera en Amazon SageMaker Studio: + JupyterLab + Editor de código, basado en Code-OSS, Visual Studio Code: Open Source Utilice las siguientes secciones para configurar Amazon Q Developer y utilizarlo en su entorno. **Topics** + [Configuración de Amazon Q Developer para sus usuarios](studio-updated-amazon-q-admin-guide-set-up.md) + [Uso de Amazon Q para agilizar sus flujos de trabajo de machine learning](studio-updated-user-guide-use-amazon-q.md) + [Personalice Amazon Q Developer en las aplicaciones de Amazon SageMaker Studio](q-customizations.md) # Configuración de Amazon Q Developer para sus usuarios Amazon Q Developer es un asistente conversacional de IA generativa. Puede configurar Amazon Q Developer en un dominio nuevo o en uno existente. Use la siguiente información para configurar Amazon Q Developer. Con Amazon Q Developer, sus usuarios pueden: + Reciba step-by-step orientación sobre el uso de las funciones de SageMaker IA de forma independiente o en combinación con otros AWS servicios. + Obtenga un código de muestra para comenzar con sus tareas de aprendizaje automático, como la preparación de datos, la capacitación, la inferencia y MLOps. + Recibir asistencia para solucionar problemas a fin de depurar y resolver los errores detectados al ejecutar el código. **nota** Amazon Q Developer en Studio no utiliza contenido de los usuarios para mejorar el servicio, independientemente de si se utiliza la suscripción de nivel gratuito o de nivel Pro. Para compartir telemetría del IDE, Amazon Q podría realizar un seguimiento del uso que hacen los usuarios, por ejemplo, del número de preguntas formuladas y de si las recomendaciones se aceptaron o rechazaron. Estos datos de telemetría no incluyen información de identificación personal, como la dirección IP de los usuarios. Para obtener más información sobre la protección de datos y las instrucciones para darse de baja, consulte [Opt out of data sharing in the IDE](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/opt-out-IDE.html). Puede configurar Amazon Q Developer con una suscripción de nivel gratuito o Pro. El nivel Pro es un servicio de suscripción de pago con límites de uso más altos y otras características. Para obtener más información sobre las diferencias entre los niveles, consulte [Understanding tiers of service for Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-tiers.html). Para obtener información sobre la suscripción a Amazon Q Developer Pro, consulte [Subscribing to Amazon Q Developer Pro](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-admin-setup-subscribe-general.html). ## Instrucciones de configuración del nivel gratuito de Amazon Q Developer: Para configurar el Nivel gratuito de Amazon Q Developer, utilice el siguiente procedimiento: **Configuración del nivel gratuito de Amazon Q Developer** 1. Añada la siguiente política a la función de IAM que utilizó para crear su espacio JupyterLab o el de 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. Ve a Amazon SageMaker Studio. 1. Abre tu espacio JupyterLab o el de Code Editor. 1. Vaya a **Lanzador** y seleccione **Terminal**. 1. En JupyterLab, haga lo siguiente: 1. Especifique `restart-jupyter-server`. 1. Reinicia el navegador y vuelve a Amazon SageMaker Studio. ## Instrucciones de configuración del nivel Pro de Amazon Q Developer Pro: **Requisitos previos** Para configurar Amazon Q Pro, debe tener: Un dominio de Amazon SageMaker AI configurado para su organización con el centro de identidad de IAM configurado como medio de acceso. Administración de suscripciones de Amazon Q Developer Pro Si va a actualizar un dominio que ya ha configurado para su organización, tendrá que actualizarlo para usar Amazon Q Developer. Puede usar el dominio Consola de administración de AWS o el AWS Command Line Interface para actualizar un dominio. Debe usar el ARN de su perfil de Amazon Q Developer. Puede encontrar el ARN de perfil de Q en la página [Q Developer Settings](https://console.aws.amazon.com/amazonq/developer/settings). Puedes usar el siguiente AWS Command Line Interface comando para actualizar tu dominio: ``` aws --region Región de AWS sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=ENABLED,QProfileArn=Q-Profile-ARN}" ``` También puede usar el siguiente procedimiento para actualizar el dominio en la Consola de administración de AWS. 1. Navega hasta la consola [Amazon SageMaker AI](https://console.aws.amazon.com/sagemaker). 1. Elija Dominios. 1. Seleccione **Configuraciones de aplicaciones**. 1. Para **Amazon Q Developer for SageMaker AI Applications**, selecciona **Editar**. 1. Seleccione **Activar Amazon Q Developer en este dominio**. 1. Indique el ARN del perfil de Q. 1. Seleccione **Enviar**. Debe usar el ARN de su perfil de Amazon Q Developer. Puede encontrar el ARN del perfil Q en la página **Datos de la cuenta Amazon Q** de la consola de [Amazon Q Developer](https://console.aws.amazon.com/amazonq/developer). La **configuración para organizaciones** es una configuración avanzada para el dominio Amazon SageMaker AI que le permite utilizar IAM Identity Center. Para obtener información sobre cómo configurar el dominio y el Centro de identidades de IAM, consulte [Usa una configuración personalizada para Amazon SageMaker AI](onboard-custom.md). Al configurar Amazon Q Developer en un dominio nuevo, puede utilizar el AWS Command Line Interface comando Consola de administración de AWS o el siguiente desde su máquina local: ``` aws --region Región de 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 ``` Puedes usar el siguiente AWS CLI comando para deshabilitar Amazon Q Developer: ``` aws --region Región de AWS sagemaker update-domain --domain-id domain-id --domain-settings-for-update "AmazonQSettings={Status=DISABLED,QProfileArn=Q-Profile-ARN}" ``` Recomendamos que se utilice la versión más reciente de la AWS Command Line Interface. Para obtener información sobre cómo actualizar el AWS CLI, consulte [Instalar o actualizar a la última versión del AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). Si tiene que establecer una conexión entre Amazon Q Developer y la VPC, consulte [Creating an interface VPC endpoint for Amazon Q](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/vpc-interface-endpoints.html#vpc-endpoint-create). **nota** Amazon Q Developer presenta las siguientes restricciones: No admite espacios compartidos. Amazon Q Developer detecta si una sugerencia de código puede ser demasiado parecida a un código disponible públicamente. El rastreador de referencias puede marcar las sugerencias con el repositorio URLs y las licencias, o filtrarlas. Esto permite revisar el código al que se hace referencia y su uso antes de adoptarlo. Todas las referencias se registran para que pueda revisarlas más adelante y así asegurarse de que el flujo de código no se vea afectado y que pueda continuar codificando sin interrupciones. Para obtener más información sobre las referencias de código, consulte [Uso de referencias de código: Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/code-reference.html) y [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). Amazon Q procesa todos los datos de interacción de los usuarios en la Región de AWS Este de EE. UU. (Norte de Virginia). Para obtener más información sobre cómo Amazon Q procesa los datos y qué Regiones de AWS admite, consulte [Supported Regions for Amazon Q Developer](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/regions.html). Amazon Q solo funciona en Amazon SageMaker Studio. No es compatible con Amazon SageMaker Studio Classic. Sí JupyterLab, Amazon Q funciona con la versión 2.0 y superior de SageMaker AI Distribution Images. En Code Editor, Amazon Q funciona con la versión 2.2.1 y superior de SageMaker AI Distribution Images. Amazon Q Developer JupyterLab trabaja dentro de la extensión Jupyter AI. No se pueden usar otros modelos 3P dentro de la extensión mientras se usa Amazon Q. ## Personalizaciones de Amazon Q en Amazon SageMaker AI Si utiliza Amazon Q Developer Pro, tiene la opción de crear *personalizaciones*. Con las personalizaciones, Amazon Q Developer proporciona sugerencias en función del código base de la empresa. Si crea personalizaciones en Amazon Q Developer, estarán disponibles para que las utilice en JupyterLab el editor de código de Amazon SageMaker Studio. Para obtener más información sobre la configuración de las personalizaciones, consulte [Sugerencias de personalización](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/customizations.html) en la *Guía del usuario de Amazon Q Developer*. # Uso de Amazon Q para agilizar sus flujos de trabajo de machine learning Amazon Q Developer es su servicio complementario con tecnología de IA para el desarrollo del machine learning. Con Amazon Q Developer, podrá: + Reciba step-by-step orientación sobre el uso de las funciones de SageMaker IA de forma independiente o en combinación con otros AWS servicios. + Obtenga un código de muestra para comenzar con sus tareas de aprendizaje automático, como la preparación de datos, la capacitación, la inferencia y MLOps. Para utilizar Amazon Q Developer, elija la **Q** en la barra de navegación de la izquierda de su entorno JupyterLab o del editor de código. Si no ve el icono **Q**, su administrador deberá configurárselo. Para obtener más información sobre cómo configurar Amazon Q Developer, consulte [Configuración de Amazon Q Developer para sus usuarios](studio-updated-amazon-q-admin-guide-set-up.md). Amazon Q proporciona automáticamente sugerencias para ayudarlo a escribir el código. También usted puede pedirle sugerencias a través de la interfaz de chat. # Personalice Amazon Q Developer en las aplicaciones de Amazon SageMaker Studio Puede personalizar Amazon Q Developer en las aplicaciones Code Editor JupyterLab y Code Editor de Amazon SageMaker Studio. Cuando personaliza Q Developer, proporciona sugerencias y respuestas basadas en ejemplos de su base de código. Si utiliza Amazon Q Developer Pro, puede cargar cualquier personalización que haya creado con ese servicio. ## Personalice en JupyterLab En JupyterLab, puedes cargar cualquier personalización que hayas creado con Amazon Q Developer Pro. O bien, en tu JupyterLab espacio, puedes personalizar Q Developer de forma local con los archivos que subas al espacio. ### Cómo usar las personalizaciones que ha creado en Amazon Q Developer Pro Al cargar una personalización, Q Developer proporciona sugerencias basadas en el código base que utilizó para crear la personalización. Además, cuando utiliza el chat en el panel de **Amazon Q**, interactúa con su personalización. Para obtener más información sobre la configuración de las personalizaciones, consulte [Sugerencias de personalización](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/customizations.html) en la *Guía del usuario de Amazon Q Developer*. **Cómo cargar la personalización** Abre tu JupyterLab espacio y completa los siguientes pasos. 1. En la barra de estado situada en la parte inferior de JupyterLab, selecciona **Amazon Q.** Se abre un menú. 1. En el menú, seleccione **Otras características**. La pestaña **Características de Amazon Q** se abre en el área de trabajo principal. 1. En la pestaña **Características de Amazon Q**, en **Seleccionar personalización**, elija su personalización de Q Developer. 1. Interactúe con la personalización de cualquiera de las siguientes formas: + Cree un cuaderno y escriba código en él. Mientras lo hace, Q Developer le proporciona automáticamente sugerencias en línea personalizadas en función de la personalización. + Para chatear con Q Developer en el panel de **Amazon Q** siga estos pasos: 1. En la barra lateral izquierda JupyterLab, selecciona el icono de **Jupyter** AI Chat. Se abrirá el panel de **Amazon Q**. 1. Use el cuadro de chat **Preguntar a Amazon Q** para interactuar con la personalización. ### Para personalizar Amazon Q Developer con los archivos de tu JupyterLab espacio En JupyterLab, puedes personalizar Q Developer con archivos que subas a tu espacio. Luego, en el chat del panel de **Amazon Q**, puede usar un comando para preguntar a Q Developer acerca de esos archivos. Al personalizar Q Developer con los archivos de su espacio, la personalización solo existe en su espacio. No puede cargar la personalización en ningún otro lugar, como en otros espacios o en la consola de Amazon Q Developer. Puede personalizar Q Developer con archivos incluidos JupyterLab si utiliza Amazon Q Developer Pro o Amazon Q Developer en la capa gratuita. **Cómo personalizar con sus archivos** Abre tu JupyterLab espacio y completa los siguientes pasos. 1. Compruebe si su espacio está configurado con el modelo de incrustación requerido. JupyterLab Solo puede personalizar Q Developer si utiliza el modelo de incrustación predeterminado, que es **CodeSage : codesage-small**. Para verificar, haga lo siguiente; 1. **En la barra lateral izquierda, selecciona el icono de Jupyter JupyterLab AI Chat.** Se abrirá el panel de **Amazon Q**. 1. En la esquina superior derecha del panel, elija el icono de configuración. 1. **Para el **modelo de incrustación**, si es necesario, selecciona **CodeSage : codesage-small** y selecciona Guardar cambios.** 1. En la esquina superior derecha del panel, elija el icono de atrás. 1. Para cargar los archivos con los que desee personalizar Q Developer, en el panel del **Explorador de archivos**, elija el icono **Cargar archivos**. 1. Después de cargar los archivos, escriba `/learn file path/` en el cuadro de chat **Preguntar a Amazon Q**. Sustituya *file path/* por la ruta a los archivos de su espacio. JupyterLab Cuando Amazon Q termine de procesar los archivos, lo confirmará con un mensaje de chat en el panel de Amazon Q. 1. Para hacer una pregunta a Q Developer sobre los archivos, escriba `/ask` en el cuadro de chat y siga el comando con la pregunta. Amazon Q genera una respuesta basada en los archivos y responde en el chat. Para obtener más información sobre los comandos `/learn` y `/ask`, por ejemplo, sus opciones y los argumentos admitidos, consulte Información [Learning about local data](https://jupyter-ai.readthedocs.io/en/latest/users/index.html#learning-about-local-data) en la documentación de usuario de Jupyter AI. En esa página se explica cómo usar los comandos con el chatbot Jupyternaut AI. JupyterLaben Amazon SageMaker Studio admite la misma sintaxis de comandos. ## Personalización en el Editor de código Si ha creado una personalización en Amazon Q Developer Pro, puede cargarla en el Editor de código. A continuación, cuando Q Developer proporciona sugerencias para su código, las basa en el código base que ha utilizado para crear la personalización. Además, cuando utiliza el chat en el panel de **Amazon Q: chat**, interactúa con su personalización. **Cómo usar las personalizaciones que ha creado en Amazon Q Developer Pro** Abra su espacio de Editor de código y complete los pasos siguientes. 1. En el menú del Editor de código, seleccione **Ver** y **Paleta de comandos**. 1. En la paleta de comandos, empiece a escribir **>Amazon Q: Select Customization** y elija esa opción de la lista filtrada de comandos cuando aparezca. La paleta de comandos muestra las personalizaciones de Q Developer. 1. Elija su personalización. 1. Interactúe con la personalización de cualquiera de las siguientes formas: + Cree un archivo de Python o un cuaderno de Jupyter y escriba código en él. Mientras lo hace, Q Developer le proporciona automáticamente sugerencias en línea personalizadas en función de la personalización. + Para chatear con Q Developer en el panel de **Amazon Q** siga estos pasos: 1. En la barra lateral izquierda del Editor de código, seleccione el icono de **Amazon Q**. Se abrirá el panel de **Amazon Q: chat**. 1. Use el cuadro de chat para interactuar con la personalización. Para obtener más información sobre las capacidades de Q Developer, consulte [Uso de Amazon Q Developer en el IDE](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-in-IDE.html) en la *Guía del usuario de Amazon Q Developer*.