Agente de IA para Validação de Dados em Integrações de API

Padronizar o payload recebido, consolidar metadados de contexto da integração e preparar o conjunto de regras de validação aplicáveis.

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 através de uma integração de 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 que contém o payload e metadados contextuais.
• Formatos Suportados: Esse agente deve ser capaz de receber objetos no formato: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 50.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON normalizado que inclui os campos contexto, schema esperado, regras contratuais e regulatorias, payload normalizado e referências.
• Exemplo de Estrutura de Output:

   {
    "contexto": {"origem": "sistemaA", "destino": "sistemaB", "api": "nomeAPI", "operacao": "update", "contract_version": "v1", "jurisdicao": "BR"},
    "schema_esperado": {"json_schema": {...}, "campos_obrigatorios": [...], "formatos": {...}, "enums": {...}, "ranges": {...}},
    "regras_contratuais": [...],
    "regras_regulatorias": [...],
    "payload_normalizado": {...},
    "referencias": {"traceId": "abc123", "hash_payload_sha256": "def456", "tempo_evento_iso": "2025-12-02T12:56:00Z"}
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado de até 5.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: Utiliza lógica interna para calcular hash e normalizar dados.
• 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 Validação de Consistência Técnica e de Conteúdo (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Validação de Consistência Técnica e de Conteúdo (RF 2).

Avaliar a consistência do payload frente ao schema esperado e regras contratuais técnicas (estrutura, tipos, formatos, cardinalidade, duplicidade e coerência interna).

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 objeto JSON normalizado que inclui o payload e as regras de validação.
• 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é 5.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON que inclui a verificação de consistência, inconsistências detectadas e métricas.
• Exemplo de Estrutura de Output:

   {
    "consistencia_ok": true,
    "inconsistencias": [
      {"id": "1", "tipo": "campo_obrigatorio_ausente", "caminho": "cliente.email", "descricao": "O campo cliente.email é obrigatório.", "severidade": "alta"}
    ],
    "metricas": {"qtde_campos": 10, "faltantes": 1, "tipos_incorretos": 0, "formatos_invalidos": 0, "enums_invalidos": 0, "ranges_violados": 0, "duplicidades": 0, "datas_invalidas": 0}
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado de até 2.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para verificar consistência dos dados.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

2.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 Validação de Conformidade Regulatória e Contratual (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Validação de Conformidade Regulatória e Contratual (RF 3).

Checar aderência a normas regulatórias e cláusulas contratuais de negócio, incluindo privacidade, consentimento, minimização, finalidade, territorialidade e restrições de compartilhamento.

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 o contexto normalizado e o resultado da validação de consistência.
• 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é 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON que inclui a verificação de conformidade, não conformidades detectadas e métricas.
• Exemplo de Estrutura de Output:

   {
    "conformidade_ok": true,
    "nao_conformidades": [
      {"id": "1", "origem": "regulatorio", "referencia": {"norma": "LGPD", "artigo": "7", "clausula": "II"}, "descricao": "Consentimento inválido para tratamento de dados pessoais.", "severidade": "critica"}
    ],
    "metricas": {"pii_detectada": true, "base_legal_informada": false, "consentimento_valido": false, "minimizacao_ok": true, "restricao_transferencia_ok": true}
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado de até 2.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 documentos externos.
• Calculadora: Utiliza lógica interna para verificar conformidade dos dados.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

3.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 Classificação de Alertas e Diretrizes de Remediação (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Classificação de Alertas e Diretrizes de Remediação (RF 4).

Consolidar inconsistências e não conformidades em um conjunto único de alertas priorizados e adicionar recomendações objetivas de correção.

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 como input os resultados dos agentes de Consistência e Conformidade, mais o contexto normalizado.
• 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é 5.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON que inclui um conjunto único de alertas priorizados e recomendações de correção.
• Exemplo de Estrutura de Output:

   {
    "alertas": [
      {"id": "1", "categoria": "conformidade", "severidade": "critica", "caminho": "cliente.email", "descricao": "Consentimento inválido para tratamento de dados pessoais.", "impacto": "regulatorio", "recomendacao": "Obtenha consentimento válido para cliente.email.", "referencia": {"norma": "LGPD", "artigo": "7", "clausula": "II"}}
    ],
    "resumo": {"total": 1, "por_severidade": {"critica": 1, "alta": 0, "media": 0, "baixa": 0}, "por_categoria": {"conformidade": 1, "consistencia": 0}}
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado de até 2.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 documentos externos.
• Calculadora: Utiliza lógica interna para consolidar alertas e gerar recomendações.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

4.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 Registro Estruturado de Verificações (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Registro Estruturado de Verificações (RF 5).

Gerar registro detalhado e padronizado de auditoria das verificações realizadas e ações recomendadas.

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 como input o contexto normalizado e o conjunto de alertas consolidados.
• 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é 5.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON que inclui o registro de auditoria das verificações realizadas.
• Exemplo de Estrutura de Output:

   {
    "auditoria": {
      "traceId": "abc123",
      "hash_payload_sha256": "def456",
      "tempo_evento_iso": "2025-12-02T12:56:00Z",
      "api": "nomeAPI",
      "operacao": "update",
      "contract_version": "v1",
      "jurisdicao": "BR",
      "totais": {"checagens_executadas": 20, "alertas_total": 1, "criticas": 1, "altas": 0, "medias": 0, "baixas": 0},
      "listas": {"ids_alertas": ["1"]},
      "carimbos": {"gerado_em_iso": "2025-12-02T12:56:00Z"},
      "agente_versao": "v1"
    }
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado de até 2.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 documentos externos.
• Calculadora: Utiliza lógica interna para gerar registros de auditoria.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

5.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 Síntese de Resultado Final (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Síntese de Resultado Final (RF 6).

Produzir o JSON final com sinalizadores de consistência e conformidade e os alertas, conforme especificação do projeto.

6.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5).
• Tipo do input: Este agente deve ser apto a receber como input as saídas dos agentes anteriores: consistencia_ok, conformidade_ok, alertas, auditoria.
• 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é 5.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório final em JSON que inclui sinalizadores de consistência e conformidade, os alertas e o bloco de auditoria.
• Exemplo de Estrutura de Output:

   {
    "consistencia": true,
    "conformidade": false,
    "alertas": [
      {"id": "1", "categoria": "conformidade", "severidade": "critica", "caminho": "cliente.email", "descricao": "Consentimento inválido para tratamento de dados pessoais.", "impacto": "regulatorio", "recomendacao": "Obtenha consentimento válido para cliente.email.", "referencia": {"norma": "LGPD", "artigo": "7", "clausula": "II"}}
    ],
    "auditoria": {
      "traceId": "abc123",
      "hash_payload_sha256": "def456",
      "tempo_evento_iso": "2025-12-02T12:56:00Z",
      "api": "nomeAPI",
      "operacao": "update",
      "contract_version": "v1",
      "jurisdicao": "BR",
      "totais": {"checagens_executadas": 20, "alertas_total": 1, "criticas": 1, "altas": 0, "medias": 0, "baixas": 0},
      "listas": {"ids_alertas": ["1"]},
      "carimbos": {"gerado_em_iso": "2025-12-02T12:56:00Z"},
      "agente_versao": "v1"
    }
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado de até 2.000 caracteres.

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

6.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Utiliza lógica interna para gerar o relatório final.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

6.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 (relatório final em JSON) é o entregável final e não é passada para outros agentes internos.

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

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