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.
![Use case process flow Use case process flow](/docs/api//content/wxgov-aws/images/xgov-usecase-flow-request.png?context=wx&locale=en)
Synchronization
For use cases, the following information is synced from watsonx.governance to Amazon SageMaker.
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