Agente de IA para Coleta de Dados Financeiros e Econômicos

Transformar o catálogo de fontes e credenciais em requisições prontas para execução, padronizando endpoints, parâmetros, janelas de tempo, paginação e mapeamento de campos.

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 catálogo de fontes financeiras e econômicas 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 catálogo de fontes financeiras e econômicas.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs em formatos estruturados como .csv e .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de objetos JSON contendo as requisições prontas para execução, incluindo todos os parâmetros padronizados e metadados necessários.
• Exemplo de Estrutura de Output:

   [
    {
      "url_completa": "https://api.finance.com/data",
      "método": "GET",
      "headers": {...},
      "query/body": {...},
      "janela_temporal_calculada": "2025-12-01T00:00:00Z/2025-12-07T23:59:59Z",
      "estratégia_paginacao": "token",
      "política_rate_limit": "100 req/min",
      "timeout": 3000,
      "tentativas": 3,
      "mapeamento_campos_para_schema_unificado": {...},
      "id_fonte": "finance_api",
      "lote_id": "lote_001"
    }
  ] 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 caracteres por requisição, podendo variar conforme a complexidade dos parâmetros e endpoints.

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 janelas temporais e rate limits.
• 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 chamadas às APIs das fontes financeiras e econômicas para obter os dados brutos conforme requests preparados.

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 uma lista de requisições padronizadas em formato JSON.
• 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é 50.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de respostas JSON contendo os dados brutos obtidos de cada chamada à API.
• Exemplo de Estrutura de Output:

   [
    {
      "id_fonte": "finance_api",
      "lote_id": "lote_001",
      "request_id": "req_123",
      "status_http": 200,
      "payload_retornado_por_página": [...],
      "sequência_de_páginas": [...],
      "timestamps_de_coleta": "2025-12-07T08:08:00Z",
      "erro_se_houver": null
    }
  ] 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 10.000 caracteres por resposta, podendo variar conforme o volume de dados retornados.

2.3.3 Parâmetros de Geração

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

2.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente executa chamadas diretas às APIs das fontes financeiras e econômicas.

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 Consolidação de Dados Financeiros (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 Consolidação de Dados Financeiros (RF 3).

Converter as respostas brutas das fontes no schema unificado e consolidar séries por símbolo/indicador e frequência em UTC.

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 dados brutos em formato JSON obtidos de APIs financeiras e econômicas.
• 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é 80.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de dados consolidado em formato JSON, seguindo o schema unificado especificado.
• Exemplo de Estrutura de Output:

   {
    "dataset_consolidado": [
      {
        "provider": "finance_api",
        "symbol": "AAPL",
        "instrument_type": "EQ",
        "timestamp_utc_ISO8601": "2025-12-07T08:08:00.000Z",
        "open": 150.00,
        "high": 155.00,
        "low": 149.00,
        "close": 154.00,
        "volume": 1000000,
        "currency": "USD",
        "frequency": "1D",
        "calendar_type": "TRADING_DAYS",
        "source_fuse": "America/New_York",
        "qualidade_inicial": "alta",
        "flags_normalizacao": []
      }
    ],
    "dicionario_campos_unificado": {...},
    "relatorio_lacunas": {...}
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 30.000 caracteres, podendo variar conforme o volume e a complexidade dos dados consolidados.

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 normalização de dados.
• 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 Validação de Dados Financeiros e Econômicos (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Validação de Dados Financeiros e Econômicos (RF 4).

Aplicar checagens determinísticas de consistência e precisão, gerando score de qualidade e lista de anomalias por série.

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 dados consolidados em formato JSON prontos para 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 até 40.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de dados validado em formato JSON, incluindo score de qualidade e lista de anomalias identificadas.
• Exemplo de Estrutura de Output:

   {
    "dataset_validado": [
      {
        "provider": "finance_api",
        "symbol": "AAPL",
        "score_qualidade": 85,
        "flags_validacao": [],
        "anomalias_classificadas": []
      }
    ],
    "sumário_de_confiabilidade_por_série": {...},
    "sumário_de_confiabilidade_por_provider": {...}
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 20.000 caracteres, podendo variar conforme o número de anomalias e séries validadas.

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 validação de dados e cálculo de scores.
• 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 Cálculo de Atualização e Planejamento de Coletas (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Cálculo de Atualização e Planejamento de Coletas (RF 5).

Determinar periodicidade de atualização por tipo de dado, calcular próximas execuções e gerar novas requisições para backfill e incremental, respeitando janelas de mercado.

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 dados validados em formato JSON prontos para planejamento de atualizações.
• 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é 50.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um plano de atualização detalhado em formato JSON, incluindo próximas execuções e requisições preparadas para backfill e incrementos.
• Exemplo de Estrutura de Output:

   {
    "plano_de_atualização": {
      "next_runs_por_série": {
        "AAPL": "2025-12-07T20:00:00Z"
      },
      "justificativa_periodicidade": "Alta volatilidade detectada",
      "backlog_de_janelas": [...],
      "requests_prontos_incrementais": [...],
      "métricas_de_cobertura_atual": {...}
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 15.000 caracteres, podendo variar conforme o número de séries e detalhes de planejamento.

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 planejamento de atualizações.
• 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 outros agentes.
• Visibilidade da Resposta: A resposta gerada por este agente é o resultado final do fluxo.

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

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