Agente de IA para Monitoramento de Risco de Crédito

Construir o payload de consulta para recuperar dados de crédito em tempo real das empresas alvo.

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 uma lista de empresas 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 é uma lista de empresas, contendo identificadores únicos e parâmetros de consulta.
• Formatos Suportados: Esse agente deve ser capaz de receber dados em formatos: .csv, .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 payload pronto para chamada à API, contendo endpoint-alvo, headers, parâmetros de query, campos requisitados e timeout por requisição.
• Exemplo de Estrutura de Output:

   {
    "endpoint": "https://api.creditdata.com/consulta",
    "headers": {
      "Authorization": "Bearer token123",
      "Idempotency-Key": "unique_key_123"
    },
    "params": {
      "company_ids": ["12345678000195", "98765432000145"],
      "since": "2025-11-30T00:00:00Z",
      "page_size": 500
    },
    "timeout": 30
  } 

• Número de caracteres esperado: O payload gerado deve ser conciso e informativo, com um tamanho estimado em torno de 1.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 dados de crédito para obter dados em tempo real.

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 para execução da chamada à API.
• 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é 1.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser os dados brutos retornados pela API, possivelmente paginados, para todas as empresas solicitadas.
• Exemplo de Estrutura de Output:

   {
    "data": [
      {
        "company_id": "12345678000195",
        "bureau_score": 750,
        "credit_limit": 100000,
        "utilization_ratio": 0.5
      }
    ],
    "pagination": {
      "next_cursor": "abc123"
    },
    "collected_at": "2025-12-07T07:09:00Z"
  } 

• Número de caracteres esperado: Os dados brutos retornados terão um tamanho aproximado de 5.000 caracteres, variando conforme o número de empresas e a quantidade de dados recuperados.

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: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Conecta-se ao sistema externo de dados de crédito para executar a chamada à API.

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 Normalização e Atualização de Perfil de Crédito (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Normalização e Atualização de Perfil de Crédito (RF 3).

Padronizar os dados brutos recuperados e atualizar o perfil de crédito por empresa com métricas derivadas e deltas.

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 dados brutos de crédito retornados pela API.
• 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 perfis de crédito atualizados por empresa contendo valores atuais, histórico relevante mínimo e métricas derivadas.
• Exemplo de Estrutura de Output:

   {
    "profiles": [
      {
        "company_id": "12345678000195",
        "bureau_score": 750,
        "delta_bureau_score_7d": -10,
        "utilization_ratio": 0.5,
        "utilizacao_pp_30d": 0.05
      }
    ],
    "data_snapshot_ts": "2025-12-07T07:09:00Z"
  } 

• Número de caracteres esperado: O output gerado terá um tamanho aproximado de 3.000 caracteres, variando conforme o número de empresas processadas.

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 calcular métricas derivadas.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Detecção de Mudanças Significativas e Gatilhos de Alerta (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Detecção de Mudanças Significativas e Gatilhos de Alerta (RF 4).

Identificar mudanças relevantes nos perfis de crédito e gerar alertas acionáveis.

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 perfis de crédito atualizados com métricas derivadas.
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de alertas por empresa com severidade, códigos de alerta, justificativas e ações sugeridas.
• Exemplo de Estrutura de Output:

   [
    {
      "company_id": "12345678000195",
      "severity": "high",
      "alert_code": "SCORE_DROP",
      "observed_values": {
        "delta_bureau_score_7d": -65
      },
      "threshold": -60,
      "detected_at": "2025-12-07T07:09:00Z",
      "recommended_action": "Revisar limite e condições de crédito"
    }
  ] 

• Número de caracteres esperado: A lista de alertas gerada terá um tamanho aproximado de 2.000 caracteres, variando conforme o número de alertas gerados.

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: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Análise Preditiva de Risco (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise Preditiva de Risco (RF 5).

Estimar probabilidade de inadimplência em 30 e 90 dias e classificar o risco por faixas.

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 perfis de crédito atualizados e indicadores de mudança.
• 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.

5.3.2 Especificação do Output

• Formato de output: O output deve ser uma estimativa de probabilidade de inadimplência e classificação de risco por faixas.
• Exemplo de Estrutura de Output:

   {
    "risk_estimations": [
      {
        "company_id": "12345678000195",
        "PD_30d": 0.05,
        "PD_90d": 0.15,
        "risk_band": "D",
        "recommendations": "Revisar exposição e exigir garantias"
      }
    ]
  } 

• Número de caracteres esperado: O output gerado terá um tamanho aproximado de 2.000 caracteres, variando conforme o número de empresas processadas.

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 calcular estimativas de probabilidade.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Consolidação e Priorização de Alertas (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação e Priorização de Alertas (RF 6).

Unificar sinais de mudança e estimativas preditivas em uma fila priorizada de ações.

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 uma lista de alertas por empresa e estimativas de PD com faixas de risco.
• 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.

6.3.2 Especificação do Output

• Formato de output: O output deve ser uma fila priorizada contendo por empresa: prioridade, SLA sugerido, conjunto de alertas consolidados, PDs, exposição estimada (se fornecida) e próxima ação.
• Exemplo de Estrutura de Output:

   [
    {
      "company_id": "12345678000195",
      "prioridade": 0.85,
      "sla_sugerido": "4h",
      "alertas": ["SCORE_DROP", "HIGH_UTIL"],
      "PDs": {
        "PD_30d": 0.05,
        "PD_90d": 0.15
      },
      "proxima_acao": "Abrir caso para time de risco"
    }
  ] 

• Número de caracteres esperado: O output gerado terá um tamanho aproximado de 2.000 caracteres, variando conforme o número de empresas processadas.

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 calcular prioridade e SLA.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 gerada por este agente é 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. A fila de ações priorizadas é o resultado que deve ser disponibilizado ao usuário.