Agente Facematch

Versão: 1.3.0-public

O Agente Facematch é um sistema multi-agente que emprega a técnica de “correspondência facial 1:1” para determinar se duas imagens faciais correspondem à mesma pessoa, aplicando um nível de tolerância definido para garantir a precisão dos resultados. Este agente pode ser usado quando você precisa verificar a presença de um rosto e avaliar sua similaridade.

Experiência do usuário

✅ Checklist para começar sem bloqueios

As entradas (foto do documento e foto do vídeo selfie) devem vir do Agente Document Check e do Agente de Verificação de Presença.
Configure o limite de comparação (recomendado: 60%) e o provedor (por exemplo Jelou, ou outros).
Recomendado: defina o fluxo de atendimento caso habilite o Human in the loop (quem revisa, tempos de resposta e o que acontece se não houver resposta).

Validações

Detecção de Rosto

Identificamos a presença e localização de rostos nas imagens obtidas.

Comparação Facial

Verificamos se os rostos detectados correspondem.

Definição do Nível de Similaridade

Calculamos o percentual de similaridade entre as imagens para confirmar se pertencem à mesma pessoa.

Processo

O vídeo selfie obtido durante a verificação de presença é comparado contra duas possíveis fontes:

Foto do Documento de Identidade: Usamos a foto extraída do documento, garantindo previamente que o documento é autêntico e as informações foram verificadas com fontes governamentais, garantindo um alto padrão de segurança de identidade.
Foto Registrada na Entidade Governamental: Quando disponível, também comparamos o vídeo selfie com a foto armazenada nos bancos de dados governamentais.

Configuração

Entradas
Saídas

% Limite aceito para comparação facial

string

obrigatório

Variável: facematchThreshold. Limite mínimo necessário para a comparação de facematch.Tipo: Texto (0-100)Recomendado: 60%

Foto do rosto extraída do documento de identidade

string

obrigatório

Variável: imgDocumentNumber. Foto extraída do documento de identidade.

Foto do Vídeo Selfie

string

obrigatório

Variável: imgVideoSelfie. Foto extraída do Vídeo Selfie.

Provedor

string

obrigatório

Variável: provider. Provedor de facematch.Valores disponíveis: Jelou, FacephiRecomendado: Jelou

✅ Sucesso

Verificação Facial Bem-sucedida

A verificação facial foi concluída com sucesso.Variável: facematchSuccess

Para acessar as informações nesta variável, use o comando $memory.get("result_facematch")

Exemplo de resposta:

{
  "result_facematch": {
    "facematch_result": "approved",
    "facematch_confidence": 99
  }
}

Campos importantes:

facematch_result: Resultado da comparação (exemplo: approved ou decline)
facematch_confidence: Nível de confiança em percentual (0-100)
error_name: Nome do erro se ocorreu algum (vazio se não houver erro)

O objeto result_facematch corresponde à resposta da ferramenta Facematch AWS Recognition (TOOL).

Informações salvas na Memória:O agente salva automaticamente as seguintes informações em variáveis de memória:

{
  "facematchResult": true,
  "result_facematch": {
    "facematch_result": "approved",
    "facematch_confidence": 99,
    "error_name": ""
  }
}

Variáveis disponíveis:

$memory.facematchResult: Indica se a verificação facial foi bem-sucedida (true) ou não (false)
$memory.result_facematch: Objeto com o resultado completo da comparação facial (resposta da ferramenta Facematch AWS Recognition)

Você pode acessar essas informações em qualquer ponto do fluxo usando $memory.get("facematchResult") ou $memory.get("result_facematch").

🔴 Erros

Verificação Facial Malsucedida

A verificação facial não foi bem-sucedida.Variável: facematchFailedError

Integração

Selecione a skill

Acesse a Skill dentro da empresa onde você precisa instalar este Agente. Clique no botão flutuante com o nome da skill e o ícone de pasta para abrir o painel de Skills e Ferramentas. Selecione “Abrir Marketplace” e lá pesquise o nome do Agente e faça o download.

Configuração inicial

A primeira coisa a configurar é a Versão encontrada em “Configurações avançadas”.

Importante: Todos os campos neste Agente são Obrigatórios. Você deve inserir:

As entradas a comparar (foto do documento e foto do vídeo selfie)
O limite necessário (recomendado: 60%)
O provedor (geralmente deve ser “Jelou”)

Configure as Saídas

Este Agente tem 1 saída de erro e 1 saída de sucesso. Cada uma pode ser direcionada para:

Uma caixa de texto com uma mensagem personalizada
O PMA (Painel Multiagente) se o cliente tiver este módulo

Execute testes

Com a configuração que você acabou de concluir, pode prosseguir para executar testes usando uma skill ou outro agente como precursor. Certifique-se de que as entradas venham do Agente Document Check e do Agente de Verificação de Presença.

Primeiros Passos

Agentes de IA

Brain

Nós

Bases de Dados

Variáveis

Ferramentas

Funções

Configuração

Marketplace

Enterprise

Faturamento

Experiência do usuário

✅ Checklist para começar sem bloqueios

Validações

Detecção de Rosto

Comparação Facial

Definição do Nível de Similaridade

Processo

Configuração

✅ Sucesso

🔴 Erros

Integração

Primeiros Passos

Agentes de IA

Brain

Nós

Bases de Dados

Variáveis

Ferramentas

Funções

Configuração

Marketplace

Enterprise

Faturamento

​Experiência do usuário

​✅ Checklist para começar sem bloqueios

​Validações

Detecção de Rosto

Comparação Facial

Definição do Nível de Similaridade

​Processo

​Configuração

​✅ Sucesso

​🔴 Erros

​Integração

Experiência do usuário

✅ Checklist para começar sem bloqueios

Validações

Processo

Configuração

✅ Sucesso

🔴 Erros

Integração