Configuración de Amazon Q Developer para sus usuarios - Amazon SageMaker AI
Personalizaciones de Amazon Q en Amazon SageMaker AI

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.

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.

  • Reciba asistencia para la solución de problemas a fin de depurar y resolver los errores encontrados 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.

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.

Para obtener información sobre la suscripción a Amazon Q Developer Pro, consulte Subscribing to Amazon Q Developer Pro.

Para configurar la capa gratuita para desarrolladores de Amazon Q, 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 su espacio de editor de código:

    {
	"Version": "2012-10-17",
	"Statement": [
		{
			"Effect": "Allow",
			"Action": [
				"q:SendMessage"
			],
			"Resource": [
				"*"
			]
		},
		{
			"Sid": "AmazonQDeveloperPermissions",
			"Effect": "Allow",
			"Action": [
				"codewhisperer:GenerateRecommendations"
			],
			"Resource": "*"
		}
	]
}

  2. Ve a Amazon SageMaker Studio.

  3. Abre tu espacio JupyterLab o el de Code Editor.

  4. Vaya a Lanzador y seleccione Terminal.

  5. En JupyterLab, haga lo siguiente:

    1. Especifique restart-jupyter-server.

    2. Reinicia el navegador y vuelve a Amazon SageMaker Studio.

Requisitos previos

Para configurar Amazon Q Pro, debes 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 AWS Management Console 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.

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 AWS Management Console.

  1. Navega hasta la consola Amazon SageMaker AI.

  2. Elija Dominios.

  3. Seleccione Configuraciones de aplicaciones.

  4. Para Amazon Q Developer for SageMaker AI Applications, selecciona Editar.

  5. Seleccione Activar Amazon Q Developer en este dominio.

  6. Indique el ARN del perfil de Q.

  7. Elija 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.

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.

Al configurar Amazon Q Developer en un dominio nuevo, puede utilizar el AWS Command Line Interface comando AWS Management Console 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.

Si tiene que establecer una conexión entre Amazon Q Developer y la VPC, consulte Creating an interface VPC endpoint for Amazon Q.

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 similar al código disponible públicamente. El rastreador de referencias puede marcar las sugerencias con el repositorio URLs y las licencias, o bien 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 y AI Coding Assistant: Amazon Q Developer FAQs.

  • 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.

  • 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 utilizas Amazon Q Developer Pro, tienes la opción de crear personalizaciones. Con las personalizaciones, Amazon Q Developer ofrece sugerencias basadas en el código base de su 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 en la Guía del usuario para desarrolladores de Amazon Q.