PrototipeAI | Agente de IA para Consulta Automática de Crédito

1. Propósito e Escopo

Este documento define todos os prompts, configurações de memória, transição entre estados, ferramentas como chamadas a sistemas externos e demais requisitos funcionais para o Fluxo de Agentes "Consulta Automática de Crédito", uma solução de automação projetada para realizar consultas de crédito em bureaus de forma eficiente e segura. Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.

O objetivo principal é automatizar o processo de consulta de crédito, estruturando os dados coletados para análises posteriores e garantindo a segurança e confidencialidade durante todo o processo.

2. Contexto e Problema

Cenário Atual

As consultas manuais de crédito em bureaus são frequentemente demoradas e sujeitas a erros humanos. Além disso, a coleta de dados relevantes de diferentes fontes de crédito é uma tarefa desafiadora e ineficiente.

Problemas Identificados

Demora no processo: A consulta manual de crédito pode consumir tempo valioso, atrasando decisões financeiras importantes.
Erros humanos: A coleta manual de dados está sujeita a erros, que podem comprometer a qualidade das análises financeiras.
Dificuldade na integração de dados: Reunir dados consistentes de diferentes bureaus é complexo e pode resultar em informações fragmentadas.
Segurança e confidencialidade: Garantir a proteção dos dados de crédito durante as consultas é essencial para conformidade com regulamentos de proteção de dados.

3. Impactos Esperados

A implementação deste fluxo de automação visa alcançar os seguintes resultados:

Reduzir o tempo de consulta de crédito em pelo menos 70%.
Diminuir a ocorrência de erros na coleta e estruturação de dados.
Facilitar a análise posterior com dados padronizados e bem estruturados.
Garantir a segurança e confidencialidade dos dados consultados.

4. Visão Geral da Solução

O agente de IA para consulta automática de crédito realiza chamadas a APIs de diferentes bureaus de crédito, coleta dados relevantes, estrutura-os de maneira organizada e segura para análises posteriores. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um assistente eficiente e seguro na consulta de crédito.

A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo inicia com a chamada a APIs de bureaus de crédito e termina com a estruturação dos dados coletados em formato JSON para análise posterior.

A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.

Agentes	Função Principal
`Agente de Execução de Chamada à API para Consulta de Crédito` (RF 1)	Realizar chamadas a APIs de diferentes bureaus de crédito para obter dados de consulta.
`Agente de Estruturação de Dados de Crédito` (RF 2)	Estruturar os dados de crédito coletados de maneira organizada para facilitar análises posteriores.

5. Protótipos

Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram tanto o fluxo de trabalho dos agentes quanto o resultado final que o cliente receberá. Explore os links abaixo para entender melhor a solução em ação.

Ver Agente na Prototipe AI

6. Requisitos Funcionais

RF 1. Agente de Execução de Chamada à API para Consulta de Crédito

1.1 Tarefa do Agente

Realizar chamadas a APIs de diferentes bureaus de crédito para obter dados de consulta.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um payload com dados do cliente necessários para realizar consultas em bureaus de crédito.

# 2. Objetivo
Automatizar o processo de consulta de crédito, acessando diferentes bureaus de forma integrada e garantindo a segurança dos dados.

# 3. Regras que você deve seguir para gerar sua resposta
- Automatize o processo de consulta garantindo que cada chamada à API seja registrada com um identificador único do cliente para rastreamento.
- Utilize autenticação segura ao acessar cada bureau para proteger a integridade dos dados.
- Certifique-se de que qualquer erro na comunicação com as APIs seja registrado e notificado para revisão manual.
- Mantenha um log seguro e auditável de todas as consultas feitas, respeitando as normas de proteção de dados.

1.3 Configurações do Agente

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 payload com dados do cliente 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 na interface da Prototipe AI, para acelerar o processo de validação.
Tipo do input: O input inicial para o fluxo é um payload com dados do cliente.
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.

1.3.2 Especificação do Output

Formato de output: O output deve ser um conjunto de dados de crédito recuperados dos bureaus, estruturado em formato JSON.

Exemplo de Estrutura de Output:

 {
  "cliente_id": "12345",
  "credit_data": {
    "bureau": "Experian",
    "score": 750,
    "histórico": "Positivo"
  }
}

Número de caracteres esperado: O output gerado 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: Conecta-se a sistemas externos para realizar chamadas a APIs de bureaus de crédito.

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 Estruturação de Dados de Crédito (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Estruturação de Dados de Crédito (RF 2).

RF 2. Agente de Estruturação de Dados de Crédito

2.1 Tarefa do Agente

Estruturar os dados de crédito coletados de maneira organizada para facilitar análises posteriores.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de crédito do cliente recuperados dos bureaus.

# 2. Objetivo
Estruturar os dados coletados de maneira organizada e padronizada para análises posteriores.

# 3. Regras que você deve seguir para gerar sua resposta
- Padronize os dados coletados em um formato JSON consistente, assegurando que todos os campos relevantes para análise estejam presentes.
- Inclua metadados sobre a data e a origem da consulta para cada entrada de dados no JSON.
- Valide a completude dos dados estruturados, registrando se todas as informações obrigatórias foram capturadas corretamente.
- Aplique técnicas de anonimização aos dados, se necessário, para garantir a conformidade com as leis de proteção de dados.

2.3 Configurações do Agente

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 dados de crédito em formato JSON, recuperados 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é 3.000 caracteres.

2.3.2 Especificação do Output

Formato de output: O output deve ser um arquivo no formato JSON, estruturando os dados de crédito de forma padronizada e organizada.