Integración de watsonx.governance como servicio en AWS con Amazon SageMaker

Volver a la versión inglesa de la documentación

Puedes integrarwatsonx.governance como servicio enAWS con AmazonSageMaker para incorporar las capacidades de gobernanza, riesgo y cumplimiento dewatsonx.governance a tu amazonaSageMaker modelos.

Antes de empezar

Debes contar con los siguientes servicios:

Una instancia dewatsonx.governance
Un ejemplo de AmazonSageMaker

Configure los siguientes servicios enAWS :

CloudTrail: Amazonas SageMaker Los eventos se publican en CloudTrail.
Servicio de cola simple (SQS): utilice este servicio para configurar una cola para su AmazonSageMaker modelos. Para más información, ver Configurar Amazon SQS
EventBridge: Utilice este servicio para definir reglas que extraigan Amazon SageMaker La tarjeta modelo cambia a una cola FIFO de Servicio de cola simple (SQS).

Asegúrese de que elCloudTrail yEventBridge los servicios están funcionando.

EnAWS , configure una clave de acceso a largo plazo para la integración conwatsonx.governance . Sus credenciales deben tener el siguiente acceso:

Acceso programático al servicio Simple Queue (SQS)
Acceso programático a la AmazoniaSageMaker API
Permisos para actualizar tarjetas de modelo en AmazonSageMaker

Para más información, verAWS credenciales de seguridad .

En la consola de gobierno, asegúrese de que su cuenta de usuario tenga la All/SOX/Administration/SageMaker permiso de aplicación.

ConfigurandoAWS servicios para la integracion

Realice los pasos siguientes:

Configurar una cola SQS para tu amazoniaSageMaker modelos.
Configurar un AmazonEventBridge regla y agregue su cola SQS como destino de la regla.

Configurar una cola SQS

La integración utiliza una cola SQS para recibir notificaciones de cualquier cambio en las tarjetas modelo.

Para configurar una cola SQS, siga los siguientes pasos:

Desde elAWS consola, seleccione el servicio de cola simple.
Hacer clic Crear cola .
Escriba un nombre para la cola y luego ingrese la siguiente información:
- Tipo : FIFO
- Tiempo de espera de visibilidad : 30 segundos
- Período de retención de mensajes : 4 dias
- Tamaño máximo del mensaje : 256 KB
- Retraso en la entrega : 0
- Tiempo de espera para recibir mensajes : 0
Bajo Configuración de la cola FIFO , habilite las siguientes opciones:
- Deduplicación basada en contenido
- Cola FIFO de alto rendimiento

La cola SQS está definida. A continuación, configure unEventBridge regla.

Configurar unEventBridge regla

Para configurar unEventBridge regla y agregue su cola SQS como destino, siga los siguientes pasos:

Desde elAWS consola, seleccione AmazonEventBridge servicio.
Pulse Crear regla.
Escriba un nombre para la regla y luego haga clic en Próximo .
Para el origen del evento, haga clic en Otro .

Para el método de creación, haga clic en Patrón personalizado (editor JSON) y luego ingrese el siguiente JSON para Patrón de evento:

{
   "detail": {
      "eventName": ["CreateModelCard", "UpdateModelCard", "DeleteModelCard"],
      "eventSource": ["sagemaker.amazonaws.com"]
  },
   "detail-type": ["AWS API Call via CloudTrail"],
   "source": ["aws.sagemaker"]
}

Pulse Siguiente.
Establezca el destino en la cola SQS que creó.
Hacer clic Próximo en las páginas restantes y luego haga clic en Crear regla .

Ahora tienes unEventBridge regla con su cola SQS como destino de la regla.

Configuración de una entidad comercial matriz

Decida qué entidad comercial desea utilizar como entidad comercial matriz para su AmazonSageMaker modelos. De forma predeterminada, la entidad comercial matriz de AmazonSageMaker modelos es Biblioteca/MRG .

Si desea utilizar una entidad comercial diferente, créela antes de configurar la integración con Amazon.SageMaker . Para ver una lista de entidades comerciales, haga clic en Menú principal > Organización > Entidades de negocios . Para crear una entidad comercial, debe tener permisos administrativos.

Por ejemplo, si quieres almacenar tu Amazon SageMaker modelos bajo Biblioteca/MRG/SageMaker, ve al Biblioteca/MRG entidad comercial, haga clic Nueva entidad comercial. En el Nombre Tipo de campoSageMaker , en el Tipo campo, seleccione Biblioteca . Complete los campos obligatorios y luego guarde.

Configurando la integración

Para configurar la integración, necesita la siguiente información:

El ID de su cuenta AWS.
El ID de la clave de acceso y el ID secreto que configuraste para la integración.
La URL del servicio Amazon SQS que configuraste para la integración.

Permiso requerido: necesita el All/SOX/Administration/SageMaker permiso de aplicación en la consola de gobierno.

Para configurar la integración, realice los siguientes pasos:

Inicie sesión en la consola de Governance como administrador.
Haz clic en > Integraciones > Amazon SageMaker.
Bajo Configuración general , realice los siguientes pasos:
1. Seleccione la entidad comercial matriz para suSageMaker modelos. Normalmente, los modelos se almacenan bajo el Biblioteca/MRG entidad.
2. Seleccione un usuario predeterminado. Los modelos que no tienen un propietario asignado o que tienen un propietario que no existe en la consola de Governance se asignan a este usuario predeterminado.
En AWS, introduzca sus AWS y la región.

Para el Región usarus-east-1 .
En URL de SQS de tarjeta de modelo , ingrese la URL de la cola SQS que configuró.
Hacer clic Conexión de prueba y luego haga clic en Ahorrar .
Haga clic en el interruptor para habilitar la integración. Se inicia el proceso de sincronización automática. Cuando creas modelos en Amazon SageMaker, la información se sincroniza con la consola de Gobernanza. Para ver el progreso, haga clic Otro > Procesos en segundo plano .

Consejo: Si tienes modelos existentes en Amazon SageMaker, hacer clic Sincronizar la información del modelo existente. ElSageMaker sincronizaciones La tabla muestra el progreso de la sincronización manual.

Tu amazona SageMaker Los modelos ahora están disponibles en la consola de gobierno.

El flujo de trabajo típico para nuevos casos de uso es:

Un usuario empresarial crea un caso de uso y completa la evaluación de riesgos y la evaluación de aplicabilidad.
Se notifica al desarrollador del modelo que el caso de uso está listo para su desarrollo.
El desarrollador del modelo crea una tarjeta modelo en AmazonSageMaker .
La información de la tarjeta del modelo se sincroniza desde Amazon. SageMaker a la consola de gobierno.
El usuario empresarial vincula el modelo al caso de uso.

Sincronización de datos

El proceso de sincronización escucha las siguientes acciones:

UpdateModelCard: Se edita o actualiza una tarjeta de modelo en AmazonSageMaker .
DeleteModelCard: Se elimina una tarjeta de modelo en AmazonSageMaker .
CreateModelCard: Se crea una tarjeta modelo en AmazonSageMaker .

Es posible que no vea los cambios inmediatamente en la consola de Governance.

El proceso de sincronización se ejecuta una vez por minuto.
El proceso de sincronización se detiene cuando el modo de administración del sistema está habilitado. La sincronización se reanuda cuando el modo de administración del sistema está desactivado.
El proceso de sincronización se detiene cuando se ejecuta una sincronización manual. La sincronización se reanuda cuando se completa el proceso manual.

Información sincronizada desde la consola de gobernanza con Amazon SageMaker

La siguiente tabla muestra los campos que se sincronizan desde la consola de Governance con Amazon SageMaker.

Por ejemplo, cuando actualiza el propietario del modelo en un objeto modelo en la consola de gobierno, el campo propietario del modelo en la tarjeta del modelo en Amazon SageMaker está actualizado.

Tabla 2. Campos que se sincronizan desde la consola de gobernanza con Amazon SageMaker
Consola de gobernanza	SageMaker campo
Modelo MRG: Propietario del modelo:	Propietario del modelo (`model_owner` )
Modelo MRG: Estado*	Estado de la tarjeta modelo (`model_approval_status` )
MRG-AIFacts-ModelUseCase:Purpose	Propósito del modelo (`purpose_of_model` )
MRG-AIFacts-ModelUseCase:Risk Nivel	Calificación de riesgo (`risk_rating` )
(Caso de uso) Campos del sistema: Descripción	Problema empresarial > Descripción (`business_problem` )
MRG-ModelUseCase:Owner	Parte interesada del negocio (`business_stakeholders` )

*Solo para la sincronización inicial, MRG-Model:Status se sincroniza desde Amazon SageMaker a la consola de gobierno. Para sincronizaciones posteriores, el estado se sincroniza desde la consola de gobierno con Amazon. SageMaker.

Información sincronizada desde Amazon SageMaker a la consola de gobierno

La siguiente tabla muestra los campos que se sincronizan desde Amazon. SageMaker a la consola de gobierno.

Por ejemplo, cuando actualiza el campo Model Creator en una tarjeta de modelo en Amazon SageMaker, el campo Desarrollador de modelo en el objeto de modelo se actualiza en la consola de gobierno.

Tabla 3. Campos que se sincronizan desde Amazon SageMaker a la consola de gobierno
SageMaker	Consola de gobernanza
creador_modelo	MRG-Model: Desarrollador de modelos Si el usuario no existe en la consola de Governance, el Desarrollador de modelos se establece en el usuario predeterminado que especificó cuando configuró la integración.
tipo_algoritmo	Modelo MRG-AIFacts: Algoritmo
model_id	MRG-AIFacts-Model: ID de activo externo
modelo_artefacto	MRG-AIFacts-Model:URL de activo externo: los activos externos se sincronizan solo si el nombre de la carpeta del activo incluye`ModelArtifacts` .
nombre del modelo	MRG-AIFacts-Model:Nombre del modelo externo
versión_modelo	Modelo MRG: Versión del modelo
Métricas de formación (training_metrics y user_provided_training_metrics)	Métrica, Valor de métrica
Hiperparámetros (hyper_parameters y user_provided_hyper_parameters)	MRG-AIFacts-Model: Hiperparámetros (aplanados de una matriz a una cadena).

Métricas de formación y métricas de formación proporcionadas por el usuario

Las métricas de capacitación y las métricas de capacitación proporcionadas por el usuario se asignan a objetos Métrica y Valor de métrica en la Consola de gobierno.

Los objetos Métrica y Valor de métrica se crean en la consola de Governance si no existen. Los objetos de métrica se crean como hijos del objeto Modelo. Los objetos de valor de métrica se crean como hijos del objeto de métrica.

Para las métricas de capacitación y las métricas de capacitación proporcionadas por el usuario, los siguientes campos en la consola de gobierno se actualizan con la información de Amazon SageMaker:

Metric.Description: El nombre de la métrica en Amazon.SageMaker
Metric.Title: El nombre de la métrica.
Metric.Status: Establezca en Activo para las métricas existentes. Establecer en Inactivo para métricas que se eliminan en AmazonSageMaker .
MétricoValue.Description: El nombre de la métrica.
MétricoValue.MRG-MetricVal Valor: el valor de la métrica.
MétricoValue.MRG-Metric-Shared:Collection Estado: Establecido en Recopilado.

Sincronización bidireccional

La descripción de la tarjeta modelo (model_description ) campo en Amazon SageMaker y el campo Descripción en el objeto Modelo (Model.System Fields:Description ) en la consola de gobierno se sincronizan en ambas direcciones.

Tema principal: Watsonx.governance como Servicio en AWS