Run investigation

Once the Adverse Media Monitoring skill is installed and the configuration is complete, you can initiate investigations in one of the following ways:

• Start the Business Process from Control Tower
• Run it via the Ad hoc investigation search tool
  • Start Ad hoc investigation
  • Run ad-hoc search
• Call AMM REST API
• Ingest articles and entity details via a flat file

Start Business Process from Control Tower

You can initiate Adverse Media Monitoring in Control Tower by running the Core or Ad hoc Investigation Business Processes (BP). The main difference between them is that the Ad hoc Investigation creates an ad-hoc search screen that enables analysts and business users without access to Control Tower to initiate investigations from Workspace, for instance, as part of a transaction monitoring fraud alert investigation.

To start the Core BP, do the following:

1. In the Control Tower menu, click Digital Workers > View All and find the Evelyn: Adverse Media Monitoring group.

2. In the group, find the variation you wish to use and click it.

3. Find the Adverse Media Monitoring BP and click it to open its process definition.

   

4. Next to a BP instance, click the Actions menu button (...) and choose one of the following options:

   • If the instance is not running, click Edit and Run. The Edit Business Process window appears.

   • Click Copy to create another instance of the process. Thus, you can run a new instance without impacting an existing one.

     

5. In the Business Process window, go to the Data tab and select Upload your data. The Upload your main data window appears.

   

6. In the window, click Add, select a CSV input file, click Open, and then click Upload. The data is uploaded to the BP.

   note

   If you are using the Human-in-the-loop feature, you can pre-assign tasks to workers in your organization. To do this, enter the worker’s id in the _sys_mt_hit_assignee column for the required entity rows of the input CSV file.

   Currently, real-time validations are not supported. If a BP can't recognize a value in the sys_mt_hit_assignee column, the associated task is not assigned to any worker.

7. Go to the Run tab and click Run this process to start the BP.

If the Manual Task is enabled, the investigations appear within Workspace as they are complete. If it is disabled, the reports are generated and stored within the location specified during the AMM configuration.

note

Occasionally, no results are found for the search. If this occurs, a report for each entity is created. A separate email with a link to view and download the report is sent for each entity that does not have search results. A copy of this report is also stored in the location specified during the AMM configuration.

Once all of the entities within the input file have been processed, the Business Process ends automatically.

Run via Ad hoc investigation search tool

The Ad hoc investigation search tool is a Business Process that allows customers to trigger Adverse Media Monitoring from the Workspace user interface. It is available after installing and configuring Adverse Media Monitoring.

Start Ad hoc investigation

To start an Ad hoc investigation, do the following:

1. In the Control Tower menu, click Digital Workers > View All and find the Evelyn: Adverse Media Monitoring group.

2. In the group, find the variation you wish to use and click it.

   The number of ad-hoc search tasks created in Workspace is configured in the Investigation step.

3. Click the Adverse Media Monitoring Ad hoc investigation group to expand it.

4. Next to a BP instance, click the Actions button (...) and select one of the following options:

   • To run the Ad hoc investigation, click Edit and Run. The Edit Business Process window appears.
   • To create another instance of the BP, click Copy. Thus, you can run a new instance without impacting an existing one.

5. In the Business Process window, go to the Run tab and click Run this process to start the Business Process.

Run ad-hoc search

To run an investigation using the ad-hoc search screen, do as follows:

1. Log in to Workspace, find Submit Adverse Media Monitoring Investigation request vX.X and open it:

   

2. In the Entity information group, enter data for the entity you wish to screen. Pay attention to the following considerations:

   • Only Entity name is required to initiate a search. All other fields are optional but encouraged since more information on the entity enables the automation to eliminate more false-positive results.

   • To allow re-applying decisions in future investigations for the same entity, provide a custom Entity ID.

   • You can either upload data in a CSV file or enter the data manually.

3. Review the settings in the Requests details group. If necessary, in the Search Time Period box, select a different time for scanning.

   Here, you can only change Search Time Period. Other fields are configured in Control Tower and listed on this screen for reference only.

4. Review the settings in the Results group:

   • Select the Assign to me checkbox to get the investigation results sent to you automatically.
   • Enter one or more email addresses where to send the results. In Send copy to box, it is recommended to specify a group email so that other team members can refer to previous investigations and their results.

5. Click the Submit button.

Once the results are ready, an email notification is sent with a link to the assignments in Workspace and the final report.

If your organization does not use the Human-in-the-loop feature, you only receive a final report. This is also indicated on the ad-hoc search screen.

note

In some cases, no results are found for the search. If this occurs, a report for each entity is created. A separate email with a link to view and download the report is sent for each entity that does not have search results. A copy of this report is also stored in the location specified during the AMM configuration.

Call AMM REST API

Adverse Media Monitoring can be invoked by calling the WorkFusion AMM REST API. You must first configure a variation as it requires a BP associated with a configured variation. For details, see the Configure REST API endpoints guide.

For more information on REST API, read Running skills via REST API.

Ingest via flat file

To enable running an investigation using an uploaded file, configure the CSV file as the data source and specify the S3 bucket and location for the input file. For details, refer to Install and configure.

To start the Ingestion BP, do as follows:

1. In the Control Tower menu, click Digital Workers > View all and find the Evelyn: Adverse Media Monitoring group.

2. Locate the Adverse Media Monitoring variation you wish to use and click it.

3. In the group, click the Adverse Media Monitoring File Ingestion BP to expand the process definition.

4. Click Edit and Run.

5. Go to the Run tab and click Run This Process.

Next, upload a CSV file with input data:

1. Go to MinIO (example of sample MinIO URL: https://amm-release-minio-ui.cloud.workfusion.com/).

2. Log in with SSO.

3. Go to the bucket you specified when configuring the Input step.

4. Go to the directory (or create one if it doesn’t exist) you specified when configuring the Input step.

5. Click Upload > Upload File.

   

6. Select an input CSV file and upload it.

   note

   To make sure your CSV file has the correct format, download the sample and check your file against it. Files that do not comply with the format requirements are not ingested.

7. After some time, the file is picked up by the AI Digital Worker and moved to the processed folder.