Agente de IA para Previsão de Cenários Econômicos

Consolidar requisitos de dados a partir do escopo fornecido e estruturar parâmetros padronizados para coleta de séries temporais macroeconômicas e financeiras.

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 briefing do escopo de análise 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 do documento na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um documento contendo o briefing do escopo de análise.
• Formatos Suportados: Esse agente deve ser capaz de receber documentos nos formatos: .pdf, .docx.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 15.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo os parâmetros de coleta estruturados.
• Exemplo de Estrutura de Output:

   {
    "pais": "Brasil",
    "moeda_base": "BRL",
    "horizonte_meses": 12,
    "periodo_historico_min_anos": 10,
    "frequencia_preferida": "mensal",
    "indicadores_requeridos": ["PIB real", "inflação", "juros de política"],
    "mapeamento_alias": {"inflação": ["cpi", "ipca"]},
    "janelas_calculo": {"mom": true, "yoy": true, "qoq": false},
    "flags": {"usar_db_interno": true, "usar_apis_publicas": true, "usar_docs_referencia": false},
    "filtros_temporais": {"inicio": "2015-01-01", "fim": "2025-12-11"},
    "normalizacao": {"base_100_data": "2020-01-01", "deflator_preferido": "inflação cheia nacional"},
    "listas_fontes_priorizadas": ["estatística oficial nacional", "organismos multilaterais"]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.500 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 externas configuradas para recuperar séries temporais econômicas e financeiras conforme parâmetros gerados.

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 payloads prontos por fonte, contendo informações como fonte, endpoint, parâmetros de consulta, entre outros.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo os dados brutos recuperados.
• Exemplo de Estrutura de Output:

   {
    "fonte": "API Externa",
    "dados": {"indicador": [{"data": "2025-01-01", "valor": 100, "unidade": "%"}]}
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 caracteres, podendo variar conforme o número de dados recuperados.

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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar os payloads recebidos para as APIs externas configuradas e retornar os dados recebidos como resposta.

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 Normalizador e Validador de Séries Temporais Econômicas (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Consultas em Banco de Dados (RF 3).

Executar consultas no banco de dados interno para recuperar séries históricas e dicionários de metadados.

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 parâmetros prontos de consulta, incluindo conexão, instruções de leitura, entre outros.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo o resultado bruto da consulta.
• Exemplo de Estrutura de Output:

   {
    "tabelas": ["tabela1", "tabela2"],
    "series": {"indicador": [{"data": "2025-01-01", "valor": 100, "unidade": "%"}]}
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 caracteres, podendo variar conforme o número de dados recuperados.

3.3.3 Parâmetros de Geração

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

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá executar consultas no banco de dados interno configurado e retornar os dados recebidos como resposta.

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 Normalizador e Validador de Séries Temporais Econômicas (RF 5).

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

Consultar documentos de referência para extrair premissas qualitativas relevantes.

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 parâmetros prontos de busca e identificação dos documentos, com termos-chave e limites de data.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo os trechos recuperados.
• Exemplo de Estrutura de Output:

   [{"documento": "Relatório de Economia", "pagina": 12, "texto": "A economia está se recuperando...", "data_documento": "2025-01-01", "confiabilidade_estimada": "alta"}] 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.000 caracteres, podendo variar conforme o número de trechos recuperados.

4.3.3 Parâmetros de Geração

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

4.3.4 Ferramentas do Agente

• Documentos: O agente deverá consultar documentos de referência configurados e retornar os trechos recuperados como resposta.
• 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 Normalizador e Validador de Séries Temporais Econômicas (RF 5).

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

Ao concluir sua execução, esse agente aciona o Normalizador e Validador de Séries Temporais Econômicas (RF 5).

Consolidar dados de múltiplas fontes, alinhar frequências, checar consistência e produzir um dataset limpo e derivativos básicos.

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 brutos de APIs/DB/Documentos e parâmetros do Orquestrador.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 20.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo o dataset normalizado.
• Exemplo de Estrutura de Output:

   {
    "series": {"indicador": {"frequencia": "mensal", "unidade_padrao": "%", "base_100_data": "2020-01-01", "observacoes": [{"data": "2025-01-01", "valor": 100}]}}
  } 

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

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

5.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para calcular derivados e validar consistência dos dados.
• 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 Gerador de Cenários Macroeconômicos (RF 6).

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

Ao concluir sua execução, esse agente aciona o Gerador de Cenários Macroeconômicos (RF 6).

Construir cenários Baseline, Otimista e Pessimista com premissas explícitas, choques e trajetórias por indicador.

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 o dataset normalizado e, se disponível, premissas qualitativas extraídas de documentos.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 15.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo os cenários projetados.
• Exemplo de Estrutura de Output:

   {
    "cenarios": {"Baseline": {"indicador": [{"data": "2025-01-01", "nivel": 100}]}}
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 10.000 caracteres, podendo variar conforme o número de cenários e dados projetados.

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

6.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para calcular projeções e validar coerência dos cenários.
• 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 deve ser visível para o Analista de Implicações Estratégicas (RF 7).

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

Ao concluir sua execução, esse agente aciona o Analista de Implicações Estratégicas (RF 7).

Traduzir os cenários macroeconômicos em implicações acionáveis para planejamento estratégico e gestão de riscos.

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 os cenários projetados e, se disponível, perfis setoriais ou alavancas de negócio fornecidas no briefing.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo os insights estruturados.
• Exemplo de Estrutura de Output:

   {
    "alavancas": {"precificacao": [{"acao": "Ajustar preços", "gatilho": "inflação > 5%"}]}
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 caracteres, podendo variar conforme o número de insights gerados.

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

7.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Formatador de Relatório de Cenários (RF 8).

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

Ao concluir sua execução, esse agente aciona o Formatador de Relatório de Cenários (RF 8).

Gerar o relatório final em markdown consolidando dados, cenários e implicações em seções padronizadas.

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 os cenários projetados, insights estratégicos e dataset normalizado.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 20.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato markdown consolidando dados, cenários e implicações.
• Exemplo de Estrutura de Output:

   # Relatório de Cenários Econômicos
  
  ## Data: 11/12/2025
  
  ### Proprietário: Cheila Portela
  
  ---
  
  ## Sumário
  
  - Premissas e Choques
  - Cenários Projetados
  - Implicações Estratégicas
  - Indicadores de Monitoramento
  - Limitações e Próximos Passos
  
  ---
  
  ## Premissas e Choques
  
  - Cenário Baseline: ...
  - Cenário Otimista: ...
  - Cenário Pessimista: ...
  
  ---
  
  ## Cenários Projetados
  
  | Indicador | Baseline | Otimista | Pessimista |
  |-----------|----------|----------|------------|
  | PIB Real  | ...      | ...      | ...        |
  
  ---
  
  ## Implicações Estratégicas
  
  - Precificação: Ajustar preços se inflação > 5%
  
  ---
  
  ## Indicadores de Monitoramento
  
  - Inflação: Limite de 5%
  
  ---
  
  ## Limitações e Próximos Passos
  
  - Dados faltantes: ...
  - Necessidades de refinamento: ...
  - Calendário de atualização: ... 

• Número de caracteres esperado: O markdown gerado terá um tamanho aproximado de 10.000 caracteres, podendo variar conforme o número de cenários e dados consolidados.

8.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

8.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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. O markdown gerado é o resultado que deve ser disponibilizado ao usuário.