Skip to main content
Version: 1.3.0-public
The Facematch Agent is a multi-agent system that employs the “1:1 facial match” technique to determine whether two facial images correspond to the same person, applying a defined tolerance level to ensure result accuracy. This agent can be used when you need to verify the presence of a face and evaluate its similarity.

​
User experience

​
✅ Checklist to start without blockers

  • The inputs (document photo and video selfie photo) must come from the Document Check Agent and the Liveness Check Agent.
  • Configure the comparison threshold (recommended: 60%) and the provider (for example Jelou, or others).
  • Recommended: define the handling flow if you enable Human in the loop (who reviews, response times, and what happens if there is no response).

​
Validations

Face Detection

We identify the presence and location of faces in the obtained images.

Facial Comparison

We verify whether the detected faces match.

Similarity Level Definition

We calculate the similarity percentage between images to confirm whether they belong to the same person.

​
Process

The video selfie obtained during the liveness check is compared against two possible sources:
  • Identity Document Photo: We use the photo extracted from the document, ensuring beforehand that the document is authentic and the information has been verified with government sources, guaranteeing a high identity security standard.
  • Photo Registered with the Government Entity: When available, we also compare the video selfie with the photo stored in government databases.

​
Configuration

​
% Accepted threshold for facial comparison
string
required
Variable: facematchThreshold. Minimum threshold required for facematch comparison.Type: Text (0-100)Recommended: 60%
​
Face photo extracted from ID card
string
required
Variable: imgDocumentNumber. Photo extracted from the ID card.
​
Video Selfie Photo
string
required
Variable: imgVideoSelfie. Photo extracted from the Video Selfie.
​
Provider
string
required
Variable: provider. Facematch provider.Available values: Jelou, FacephiRecommended: Jelou

​
Integration

1

Select the skill

Go to the Skill within the company where you need to install this Agent. Click the floating button with the skill name and the folder icon to open the Skills & Tools panel. Select “Open Marketplace” and there type the Agent name and download it.
2

Initial configuration

The first thing to configure is the Version found under “Advanced settings”.
Important: All fields in this Agent are Mandatory. You must enter:
  • The inputs to compare (document photo and video selfie photo)
  • The required threshold (recommended: 60%)
  • The provider (generally should be “Jelou”)
3

Configure Outputs

This Agent has 1 error output and 1 success output. Each can be directed to:
  • A text box with a custom message
  • The PMA (Multiagent Panel) if the client has this module
4

Run tests

With the configuration you just completed, you can proceed to run tests using a skill or another agent as a precursor. Make sure the inputs come from the Document Check Agent and the Liveness Check Agent.