Assessing risk or criticality often requires manual input from experts and rarely benefits from past assessments. This makes the overall process time-consuming and potentially leads to inconsistency over time. To digitize the computation of the criticality, we propose a machine learning (ML) service for criticality assessments in this mission. The assessments that are used throughout this mission are exemplary and based on restaurant inspections where a health inspector, the expert, screens a restaurant and protocols violations. In the end the inspector comes up with a suitable score for the restaurant. The provided data comes from a publicly available dataset (Restaurant Scores - LIVES Standard in San Francisco published by Public Health) which has been restructured to fit the ML approach of multi-output-regression. Since the SAP Data Attribute Recommendation service (DAR) does not support multi-output-regression yet, this mission showcases a solution leveraging SAP AI Core and open source. The approach of this mission can be easily adapted to similar kinds of criticality assessments.
This mission is based on a real customer use case about criticality assessments which is currently in productization.
Organizations can have complex rules for their criticality assessments. Many times, the assessment is dominated by manual input, which is prone to errors and can be time-consuming. Besides that, due to individual approaches of different processors, inconsistencies can arise over the time, yielding different results for similar inputs.
The solution uses ML to assist the processor of criticality assessments by translating descriptions and details of a criticality assessment to multiple scores necessary to conclude the assessment.
A machine learning service that leverages the capabilities of SAP Business Technology Platform (SAP AI Core and SAP AI Launchpad). The service assesses the criticality based on the descriptions of the criticality assessment itself. In this case the descriptions are the violations the inspector protocols during the inspections. Since the descriptions consist of unstructured text, they first will be transformed to vectors, so-called embeddings. Finally, a multi-output-regression can be performed to determine multiple scores.
- Upload training data to Amazon S3 bucket
- Build and push Docker images for training and serving
- Register general artifacts
- Setup and execute training
- Setup and deploy inference service
- Test inference service
You can use this repository as a boilerplate for AI Core and adjust it quickly to your own AI Core use case. The interaction with the AI Core instance happens programmatically using Python. To do so, consider the following instructions:
- In the resources/ directory adjust the credentials and setup information so that
they match yours.
- Save your AI Core service key as aic_service_key.json
- Add Docker credentials to docker_secret.json. It is recommended to use a Docker Hub Personal Access Token (PAT) instead of your Docker Hub password.
- Add details about the git repository that is going to be onboarded later to git_setup.json. Further, specify a name for your application in this file.
- Add your Amazon S3 bucket service key to s3_service_key.json. This is actually the service key of your Object Store instance that creates the S3 bucket behind the scenes for you.
- Make sure to not publish the resources/ directory as it contains credentials.
- Upload your training data to the Amazon S3 bucket via the command line. Look here to see how to do this.
- Integrate your own training script into src/train/train.py
DATASET_PATHis the directory in the Docker container file system in which your uploaded training data will sit later on.environ["OUTPUT_PATH"]is the directory under which to save the model after training to in the Docker container file system.
- Integrate your serving code into src/serve/serve.py
- Make sure
MODEL_NAMEis the same name under which your save your trained model previously.
- Make sure
- Add the requirements (required python libraries) that are necessary to run your training script to src/train/requirements.txt. Analog, list your requirements to run your serving script in src/serve/requirements.txt.
- Adjust both Dockerfiles (src/train/Dockerfile and src/serve/Dockerfile)
- Make sure the specified python base image matches the python version you used when you installed your python libraries requirements locally (e.g., for testing purposes).
- Build both Dockerfiles and upload the images to your Docker Hub repository. Tags can be used to differentiate between
different Docker images here. See here for more
details.
- Make sure the specified URLs for the Docker images in the workflow files (workflows/serve.yaml and workflows/train.yaml) match the URLs to the images inside your Docker Hub repository.
- Adjust the naming of the values inside the workflow files so that they fit your use case.
- Finally, execute each step in src/main.ipynb in sequential order. Here the interaction with the AI Core instance takes place. For example, you are going to initiate the training and serving here.
No known issues.
Create an issue in this repository if you find a bug or have questions about the content.
For additional support, ask a question in SAP Community.
If you wish to contribute code, offer fixes or improvements, please send a pull request. Due to legal reasons, contributors will be asked to accept a DCO when they create the first pull request to this project. This happens in an automated fashion during the submission process. SAP uses the standard DCO text of the Linux Foundation.
Copyright (c) 2023 SAP SE or an SAP affiliate company. All rights reserved. This project is licensed under the Apache Software License, version 2.0 except as noted otherwise in the LICENSE file.