Agente de IA para Consolidação de Dados Econômicos

Definir o escopo da coleta de dados econômicos, parametrizar fontes, janelas temporais e granularidades, e preparar os payloads e consultas para os agentes de execuçã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 requisitos de negócio e políticas de qualidade 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 conjunto de requisitos de negócio e políticas de qualidade.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json, .csv.
• 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 plano de coleta estruturado contendo lista de fontes por indicador, tipo de obtenção por fonte, endpoints/URLs-alvo, parâmetros prontos de chamada, consultas de busca e flags.
• Exemplo de Estrutura de Output:

   {
    "indicadores": [
      {
        "nome": "PIB",
        "fonte": "Banco Central",
        "tipo": "API",
        "endpoint": "https://api.bcb.gov.br/dados/PIB",
        "parametros": {
          "frequencia": "mensal",
          "moeda": "BRL"
        }
      }
    ],
    "flags": {
      "coleta_requer_search": false,
      "coleta_requer_documento": false
    }
  } 

• Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 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: 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 chamadas às APIs das fontes definidas para obter séries e tabelas econômicas.

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 uma lista de payloads prontos para execução de chamadas 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 texto com até 20.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de dados brutos retornados pelas APIs, incluindo metadados como fonte, timestamp de coleta e status HTTP.
• Exemplo de Estrutura de Output:

   {
    "dados_brutos": [
      {
        "fonte": "Banco Central",
        "timestamp": "2025-12-07T15:39:00Z",
        "status": 200,
        "dados": [
          {
            "data": "2025-11-01",
            "valor": 12345.67
          }
        ]
      }
    ]
  } 

• Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 10.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: Não utiliza.
• 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 Execução de Busca Online (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Busca Online (RF 3).

Executar buscas online para localizar páginas/portais com dados econômicos quando não houver API direta.

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 consultas de busca prontas.
• 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é 15.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de resultados relevantes com título, URL, snippet e data estimada de atualização.
• Exemplo de Estrutura de Output:

   {
    "resultados": [
      {
        "titulo": "Relatório Econômico Mensal - Banco Central",
        "url": "https://www.bcb.gov.br/relatorio-economico",
        "snippet": "O Banco Central divulga mensalmente dados sobre...",
        "data_atualizacao": "2025-12-01"
      }
    ]
  } 

• Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 7.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: Não utiliza.
• Busca Online: Utiliza para executar as buscas conforme parâmetros recebidos.
• 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 Execução de Consulta a Documento (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Consulta a Documento (RF 4).

Acessar documentos/relatórios (ex.: PDFs/HTMLs) e recuperar tabelas e séries econômicas especificadas.

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 parâmetros de consulta prontos contendo URLs/identificadores de documentos, seções/tabelas alvo, palavras-chave e período de interesse.
• 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é 12.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um conjunto de extrações realizadas dos documentos, incluindo metadados como documento origem, versão/data de publicação e página/seção.
• Exemplo de Estrutura de Output:

   {
    "extrações": [
      {
        "documento_origem": "Relatório Econômico Mensal - Banco Central",
        "versao": "2025-12-01",
        "pagina": 5,
        "tabela": {
          "indicador": "PIB",
          "valores": [
            {
              "data": "2025-11-01",
              "valor": 12345.67
            }
          ]
        }
      }
    ]
  } 

• Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 8.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: Não utiliza.
• 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 Padronização e Qualidade de Dados (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Padronização e Qualidade de Dados (RF 5).

Normalizar esquemas, unidades, moedas e frequências; validar integridade e frescor dos dados coletados.

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 dados brutos de APIs, buscas e documentos, além da matriz fonte-indicador e requisitos de granularidade/unidade.
• 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é 25.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um dataset padronizado com dicionário de campos, unidades e moedas unificadas, datas em ISO 8601, além de um relatório de qualidade.
• Exemplo de Estrutura de Output:

   {
    "dataset": [
      {
        "indicator_id": "PIB",
        "source": "Banco Central",
        "geo": "BR",
        "currency": "BRL",
        "unit": "milhões",
        "frequency": "mensal",
        "time_period": "2025-11",
        "value": 12345.67,
        "last_updated_source": "2025-12-01",
        "collected_at": "2025-12-07T15:39:00Z"
      }
    ],
    "relatorio_qualidade": {
      "completude": 100,
      "duplicidade": 0,
      "frescor": "atualizado",
      "outliers": 0
    }
  } 

• Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 12.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: Não utiliza.
• 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 Integração e Agregação Temporal (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Integração e Agregação Temporal (RF 6).

Conciliar séries de múltiplas fontes, alinhar chaves de junção (geo, setorial), harmonizar calendários e preparar painéis consolidados por tema.

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 um dataset padronizado e um relatório de qualidade, além de especificações de integração (chaves, hierarquias geográficas/setoriais).
• 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é 30.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser camadas integradas por tema com índices harmonizados e tabelas prontas para análise.
• Exemplo de Estrutura de Output:

   {
    "camadas_integradas": [
      {
        "tema": "Atividade Econômica",
        "indices": {
          "indice_atividade": {
            "geo": "BR",
            "time_period": "2025-11",
            "valor": 150.3
          }
        }
      }
    ]
  } 

• Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 15.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: Não utiliza.
• 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 gerada por este agente deve ser visível para o Agente de Análise e Geração de Insights de Mercado (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise e Geração de Insights de Mercado (RF 7).

Identificar tendências, variações relevantes e oportunidades/risco de investimento a partir dos painéis integrados, com justificativas e confiança.

7.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 6).
• Tipo do input: Este agente deve ser apto a receber como input camadas integradas por tema e metadados de qualidade/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é 20.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser insights acionáveis em JSON contendo descrição, indicadores e séries suportes, janelas de observação, direção/intensidade, sinal, suposições, limitações, e score de confiança.
• Exemplo de Estrutura de Output:

   {
    "insights": [
      {
        "descricao": "Tendência de alta na atividade econômica",
        "indicadores": ["PIB"],
        "janelas_observacao": ["2025-11"],
        "direcao": "alta",
        "sinal": "oportunidade",
        "suposicoes": "Continuidade do crescimento atual",
        "limitacoes": "Dados limitados a 2025",
        "score_confianca": 0.85
      }
    ]
  } 

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

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

7.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.

7.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 Monitoramento de Atualizações e Agendamento (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Monitoramento de Atualizações e Agendamento (RF 8).

Verificar calendários de publicação, avaliar frescor recorrente e emitir instruções de atualização contínua.

8.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 7).
• Tipo do input: Este agente deve ser apto a receber como input o plano de coleta, matriz fonte-indicador e dataset padronizado com métricas de frescor.
• 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é 18.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser uma agenda de atualização por indicador/fonte com periodicidade, janela de execução recomendada, atrasos típicos, SLA de frescor e prioridades.
• Exemplo de Estrutura de Output:

   {
    "agenda_atualizacao": [
      {
        "indicador": "PIB",
        "fonte": "Banco Central",
        "periodicidade": "mensal",
        "janela_execucao": "D+1",
        "atrasos_tipicos": "2 dias",
        "sla_frescor": "7 dias",
        "prioridade": "alta"
      }
    ]
  } 

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

8.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

8.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.

8.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.

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

A execução deste agente finaliza o fluxo. A agenda gerada é o resultado que deve ser disponibilizado ao usuário.