Process flow for use cases in watsonx.governance on AWS

Last updated: Dec 12, 2024

Use cases are created and approved in watsonx.governance. Model groups are children of use cases, and models are children of model groups.

Process flow

Watsonx.governance includes a predefined workflow for use cases, the Use Case Request workflow. You can customize the workflow to meet your business needs. This topic describes the predefined workflow.

When a user creates and saves a use case in watsonx.governance, the Use Case Request workflow starts.

The user provides information about the use case, and then submits it for data gathering. The status of the use case is set to Proposed.
The user submits the use case for initial approval. The status of the use case is set to Awaiting Use Case Approval.
An approver gives initial approval for the use case. The use case is returned to the owner for data gathering.
The user gathers data and resubmits the use case for approval.
An approver approves or rejects the use case.
- If the use case is rejected, its status is set to Rejected.
- If the use case is approved, the stakeholder review stage begins.
Stakeholders review the use case.
- If the use case is rejected, its status is set to Rejected.
- If the use case is approved, its status is set to Approved for Development. A model group is created and added as a child object under the use case. In Amazon SageMaker, the model group and a child model package are added to the model registry.
The technical owner receives a notification.

In Amazon SageMaker, model development begins. The ARN of the model group and model packages are used to sync Amazon SageMaker with watsonx.governance.

The following diagram illustrates the process flow.

Synchronization

For use cases, the following information is synced from watsonx.governance to Amazon SageMaker.

Table 2. Use case fields that are synched
watsonx.governance field	Amazon SageMaker field
(Use Case) System Fields:Description	`modelCardContent.businessDetails.businessProblem`
MRG-ModelUseCase:Owner	`modelCardContent.businessDetails.businessStakeHolders`
MRG-AIFacts-ModelUseCase:Purpose	`modelCardContent.intendedUse.intendedUse`
MRG-AIFacts-ModelUseCase:Risk Level	`modelCardContent.riskRating`

In addition, watsonx.governance sets the following keys and their values as custom metadata on the most recent model package version:

watsonxgov:model-id
watsonxgov:model-url
watsonxgov:modelgroup-id
watsonxgov:modelgroup-url
watsonxgov:usecase-id
watsonxgov:usecase-url

This metadata is used to create links from Amazon SageMaker to watsonx.governance. An Amazon SageMaker user can click a link to access the associated governed object in watsonx.governance.

Parent topic: Integrating watsonx.governance with Amazon SageMaker