Skip to main content
Version: 3.10

Input and output data

The Adverse Media Monitoring AI Agent supports a variety of ways for seamless integration into each financial institution’s ecosystem, such as client lifecycle management (CLM) systems, news sources, and case management archives, including through RPA and API connections.

Search input

The Adverse Media Monitoring search is triggered by specifying a name via the Ad-hoc search in Workspace or a batch upload of names set up and scheduled via Control Tower. To conduct a search, a name is required.

To configure a batch process, WorkFusion can be integrated with the bank’s internal systems to mimic how analysts are currently retrieving names that need to be monitored for adverse media events.

Examples include:

  • Navigating alert queues in a transaction monitoring system and conducting searches on a non-customer in a potentially unusual transaction.
  • Identifying customers who meet certain criteria within a CLM system. For example, you have a customer rated as high-risk, and yet the most recent Know-Your-Customer refresh is greater than one year.
  • New applications created within a customer onboarding system or business line product extension system (such as a new lending application).
  • A CSV file sent to a shared email inbox or uploaded to a shared folder.

You can also trigger a search via REST API that passes all required inputs as parameters and then receives the results from WorkFusion.

Additional inputs, including date of birth and location, can be submitted to increase the accuracy of results related to the searched party. The table below presents the required and optional search parameter requirements.

FieldExampleRequired
NameJohn SmithYes
Date of Birth10252976No
Residence countryFRNo
Citizenship countryUSNo
Entity TypeIndividualNo

Input data format

CSV input

The data input format for the Evan: Adverse Media Monitoring File Ingestion Business Process is a CSV file with simple fields and one or more rows with entity names to search.

Below is an example of the CSV file with possible content. You can also download the template when configuring the External source as the AMM input.

The data input format for the Evan: Adverse Media Monitoring Business Process is a CSV file with simple fields and one or more rows with entity names to search.

Below is an example of the CSV file with possible content.

Input data schema

Only the search_request field is obligatory. All other fields are optional and are used to increase the relevancy of search results.

FieldDescriptionTypeRequiredExample
search_requestEntity name. It is a person or a company subject to Adverse Media Monitoring.StringYES
  • Danske Bank
  • John Doe
search_periodSearch period in days.IntegerNO365
batch_idA unique ID to group multiple search entities into combined reports.StringNOUnique free text in any format. See some examples below:
  • BI123
  • Batch01
  • Group01
entity_typeEntity type. Currently, two possible values are supported (non-case-sensitive):
  • Company
  • Individual
StringNO
  • Individual
  • Company
  • COMPANY
entity_idA unique ID of the screened entity used to re-apply decisions on the content previously reviewed by an analyst.StringNOE1234567
citizenship_incorporation_countryTwo-letter country code. Supported format: ISO 3166-1 alpha-2. See the full list here.StringNOUS (United States) / CA (Canada) / AU (Australia)
residence_operating_countryTwo-letter country code. Supported format: ISO 3166-1 alpha-2. See the full list here.StringNOS (United States) / CA (Canada) / AU (Australia)
cityFull city’s name. Used only for Thomson Reuters CLEAR Investigations.StringNONew York
subdivisionTwo-letter subdivision code according to ISO 3166-2.StringNO
  • US-FL (Florida state of the USA)
  • US-CA (California state of the USA)
  • CA-QC (Quebec province of Canada)
  • CA-YT (Yukon territory of Canada)
yobShort for year_of_birth, year of birth for a single screened person. Not applicable when entity_type is Company.StringNO1980
date_of_birthDate of birth for a single screened person. Not applicable when entity_type is Company. List of accepted date formats:
  • MM/dd/yyyy
  • yyyy/MM/dd
  • MM-dd-yyyy
  • yyyy-MM-dd
  • dd MMM yyyy
  • dd MMMM yyyy
The date format is selected in the course of configuration.
StringNO
  • 02/25/1980
  • 1980/02/25
  • 02-25-1980
  • 1980-02-25
  • 25 Feb 1980
  • 25 February 1980
_sys_user_groupsThe name of the user group assigned to manage the manual review task in Workspace.StringNOReviewers
additional_informationAdditional information about the screened entity.StringNOJohn Doe has a brother Edward Doe
add_to_ongoing_monitorThe field is used only when Thomson Reuters is configured as the data provider. If true, the corresponding entity will be automatically added to the ongoing monitoring scope.BooleanNOtrue/ false
article_dataThe field is used only when the CSV file is selected as the input data source. It represents stringified JSON with an array of article data (links and additional information)StringNO[{\"link\":\"https://www.politico.com/news/2024/08/27/nancy-pelosi-jan-6-fury-00176529\",\"additional_information\":\"article level information\"}, {\"link\":\"https://www.bbc.com/news/articles/czdpq4en1vvo\"}]
external_idA unique ID to identify the search request. Unique free text, in any format.StringNOR1234567
cost_center_codeThe code of the cost center team for billing transactions.StringNOR1234567
cost_center_nameThe name of the cost center team for billing transactions.StringNOR1234567
sla_dateThe date of the Service Level Agreement (SLA) for filtering Manual Tasks in Workspace.StringNOThe date format is selected in the course of configuration.

Search output

Once the entity search is completed, the results are displayed in a risk-prioritized manner as described above. The AI Agent user then reviews the results.

Once the user completes the review, the AI Agent generates a PDF report audit trail of the identified news, including the confidence score per article, the overall decision, and other data.

By default, the audit trail report is stored inside the WorkFusion platform. It is possible to configure this report to be pushed directly into the organization’s internal applications, for example:

  • Save into a case management or transaction monitoring system
  • Store in a shared folder
  • Use a custom connector for an in-house application

Output data format

The Evan: Adverse Media Monitoring Business Process finishes with an output you can find on the Results page for the core AMM Business Process.

The table below specifies AMM BP output data fields.

FieldDescriptionExample
search_dateTransaction start date and time.Mon Feb 26 17:32:59 UTC 2024
end_dateTransaction end date and time.Mon Feb 26 17:37:25 UTC 2024
news_providerNews provider used to screen the entity.GOOGLE
search_languageSearch language used to search for articles.EN
investigation_statusFinal status of the investigation. Possible statuses:
  • True Positive
  • False Positive
  • Needs Investigation
Needs Investigation
review_commentShows manual review comments for investigations.This investigation has a negative impact.
articles_countThe number of articles retrieved from the provider for the investigation.20
combined_report_linkLink to the S3 storage with a combined report in the configured format. The link contains a combination of information on multiple entities and investigation results. The report includes the investigation date, all search results, links to articles, suspicious countries, score, and so on. If batch_id is specified in the input request, a combined report is generated per batch of configured entities.
quality_control_report_linkLink to the S3 storage with a quality control report file in Excel (XLSX) format. The file contains a combination of information on multiple entities and investigation results. If batch_id is specified in the input request, a combined report is generated per batch of entities configured.
run_uuidThe unique UUID of the BP run.97b75d5e-34f9-4f5e-87fb-b5d0e165db68
transaction_uuidThe unique UUID of the run transaction.97b75d5e-34f9-4f5e-87fb-b5d0e165db68
entity_idThe entity_id from the input data.E1234567
variation_idID of the configuration variation.126
manual_task_was_executedInforms if a Manual Task was executed during the investigation.true / false