Agente de IA para Suporte a Disputas de Pagamento

Consolidar informações do caso de disputa e preparar um payload único e completo para recuperar, em uma chamada, todas as evidências relevantes da transação.

1.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pelo envio de um objeto JSON com os dados da disputa via API. Na fase de testes, o fluxo será iniciado pelo envio manual dos dados, que serão enviados para o agente diretamente por upload do JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um objeto JSON com os dados da disputa.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON contendo o payload preparado para a chamada à API.
• Exemplo de Estrutura de Output:

   {"transaction_id":"string","dispute_id":"string","include":{"transacao":true,"logs_pagamento":true,"autenticacao":true,"kyc_buyer":true,"kyc_seller":true,"comunicacoes":true,"politicas_vendedor":true,"envio_entrega":true,"reembolsos_chargebacks":true},"filters":{"janela_inicio_iso":"YYYY-MM-DDTHH:MM:SSZ","janela_fim_iso":"YYYY-MM-DDTHH:MM:SSZ","transaction_id":"string","buyer_id":"string","seller_id":"string"},"privacy":{"mask_pan":true,"mask_emails":true},"pagination":{"page":1,"page_size":500},"idempotency_key":"{dispute_id}-{transaction_id}","locale":"pt-BR"} 

• Número de caracteres esperado: O JSON final deve ser conciso e informativo, com um tamanho estimado em torno de 2.000 caracteres.

1.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

1.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

1.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Execução de Chamada à API (RF 2).

1.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Execução de Chamada à API (RF 2).

Realizar chamada à API do Sistema de Pagamentos para obter o pacote de evidências consolidado da disputa, conforme payload preparado.

2.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 1).
• Tipo do input: Este agente deve ser apto a receber como input um payload pronto em JSON gerado pelo agente anterior.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 2.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados recuperados da API com sub-blocos.
• Exemplo de Estrutura de Output:

   {"transacao": {...}, "autenticacao": {...}, "logs_pagamento": [...], "kyc_buyer": {...}, "kyb_seller": {...}, "comunicacoes": [...], "envio_entrega": {...}, "reembolsos_chargebacks": [...], "politicas_vendedor": {...}, "meta_api": {"page":1,"page_size":500,"continue_token":"string|nullable"}} 

• Número de caracteres esperado: O JSON gerado deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)
• Temperatura: Não se aplica (uso de ferramenta)

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o JSON recebido para a API externa do Sistema de Pagamentos e retornar os dados recebidos como resposta.

2.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Tratamento e Normalização de Evidências (RF 3).

2.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Tratamento e Normalização de Evidências (RF 3).

Normalizar, validar, deduplicar e organizar o pacote bruto de evidências retornado pela API para uso analítico.

3.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 2).
• Tipo do input: Este agente deve ser apto a receber como input um JSON bruto com evidências múltiplas retornadas pela API do Sistema de Pagamentos.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o resumo normalizado das evidências.
• Exemplo de Estrutura de Output:

   {"resumo_normalizado":{"ids":{"dispute_id":"string","transaction_id":"string"},"timeline_iso":[{"ts":"2025-11-30T12:00:00Z","evento":"captura","fonte":"gateway"}],"autenticacao":{"resultado_3ds":"success|failed|na","avs":"match|mismatch|na","cvv":"match|mismatch|na"},"pagamento":{"valor":199.90,"moeda":"BRL","valor_normalizado":199.90,"status":"capturado|estornado|chargeback|autorizado|negado"},"fraude_risco":{"ip":"string|na","geo":"string|na","device_fingerprint":"string|na","tentativas_falhas":0,"score_risco":0.73},"kyc_buyer":{"nivel":"basico|alto|na","verificado":true},"kyb_seller":{"verificado":true},"comunicacoes":[{"id":"string","canal":"email|chat|ticket","direcao":"buyer->seller|seller->buyer","ts":"...","resumo":"..."}],"entrega":{"transportadora":"string|na","tracking":"string|na","status":"entregue|em_transito|devolvido|extraviado|na","prova_assinatura":true,"endereco_divergente":false},"reembolsos_chargebacks":[{"tipo":"refund|chargeback","ts":"...","valor":199.90,"status":"pendente|liquidado"}],"politicas":{"url_termos":"string|na","aceite_ts":"..."}},"inconsistencias":["soma_capturas_neq_valor","tracking_invalido"],"ausencias_criticas":["3ds","tracking"],"meta":{"versao":"1.1","moeda_padrao":"BRL","tz":"UTC"}} 

• Número de caracteres esperado: O JSON gerado deve ser conciso e informativo, com um tamanho estimado em torno de 8.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para normalização e validação dos dados.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

3.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Análise de Causa Raiz da Disputa (RF 4).

3.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Análise de Causa Raiz da Disputa (RF 4).

Identificar causa raiz, fatores contribuintes e documentação adicional necessária a partir das evidências normalizadas.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 3).
• Tipo do input: Este agente deve ser apto a receber um JSON normalizado de evidências e o contexto da disputa.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 8.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a análise da causa raiz da disputa.
• Exemplo de Estrutura de Output:

   {"dispute_id":"string","transaction_id":"string","causa_raiz":"fraude_nao_autorizada|nao_recebido|nao_conforme|duplicidade_captura|erro_processamento|reembolso_pendente|politica_nao_cumprida|indeterminado","fatores_contribuintes":["3ds_ausente","avs_mismatch","tracking_invalido"],"confianca":0.0-1.0,"documentos_adicionais_requeridos":["comprovante_de_entrega_com_assinatura","registro_de_reembolso_no_adquirente"],"proxima_acao_recomendada":"mediar_reembolso_parcial|solicitar_provas_ao_vendedor|manter_cobranca|escalar_chargeback","evidencias_pro_comprador":["..."],"evidencias_pro_vendedor":["..."],"observacoes":"string curta e objetiva"} 

• Número de caracteres esperado: O JSON gerado deve ser conciso e informativo, com um tamanho estimado em torno de 4.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para análise dos dados.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

4.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente Gerador de Dossiê de Mediação (RF 5).

4.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente Gerador de Dossiê de Mediação (RF 5).

Produzir um dossiê claro e acionável para mediação da disputa, consolidando evidências, análise, conclusão e próximos passos.

5.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4).
• Tipo do input: Este agente deve ser apto a receber os resultados da análise de causa raiz e evidências normalizadas.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 4.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um dossiê formatado em texto estruturado.
• Exemplo de Estrutura de Output:

   # Dossiê de Mediação da Disputa
  
  ## Identificação
  - Dispute ID: XXX
  - Transaction ID: YYY
  - Valor: BRL 199,90
  - Data da Transação (UTC): 2025-11-30T12:00:00Z
  
  ## Timeline Unificada (UTC)
  - 2025-11-30T11:59:30Z: Autorização (AVS: match, CVV: match)
  - 2025-11-30T12:00:00Z: Captura
  - 2025-12-01T14:20:00Z: Envio - Transportadora ABC (Tracking 123)
  - 2025-12-03T16:40:00Z: Entrega confirmada (assinatura)
  
  ## Evidências-Chave
  - 3DS: sucesso
  - AVS/CVV: match/match
  - Entrega: comprovada com assinatura
  - Comunicações: 4 interações (2 comprador → vendedor, 2 vendedor → comprador)
  
  ## Análise de Causa Raiz
  - Classificação: nao_recebido|nao_conforme|fraude_nao_autorizada|duplicidade_captura|reembolso_pendente|erro_processamento|indeterminado
  - Fatores contribuintes: [...]
  - Confiança: 0.86
  
  ## Lacunas Documentais
  - [ ] Comprovante de reembolso no adquirente
  - [ ] Foto de prova de entrega
  
  ## Recomendações
  - Próxima ação recomendada: mediar_reembolso_parcial|solicitar_provas_ao_vendedor|manter_cobranca|escalar_chargeback
  - Riscos e observações: ...
  
  ## Apêndice
  - Políticas/Termos aceitos (link)
  - Logs de pagamento (resumo)
  - Dados KYC/KYB (resumo não sensível)
   

• Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 3.000 caracteres.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

5.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

5.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta gerada por este agente é o entregável final e não é passada para outros agentes internos.

5.3.6 Regras de Orquestração e Transição

A execução deste agente finaliza o fluxo. O dossiê gerado é o resultado que deve ser disponibilizado ao usuário.