Agente de IA para Relatórios de Transações Financeiras

Estruturar o pedido de relatório financeiro, definindo escopo, período, KPIs, fontes de dados e modalidade de execução (sob demanda ou agendada).

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 solicitação de relatório financeiro 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: Solicitação de relatório financeiro em linguagem natural.
• Formatos Suportados: Esse agente deve ser capaz de receber solicitações em formato de texto.
• 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 JSON estruturado contendo o escopo, período, KPIs, fontes de dados, modalidade de execução e observações do escopo.
• Exemplo de Estrutura de Output:

   {
    "pedido_estruturado": {
      "periodo_referencia": {"data_inicio": "2025-01-01", "data_fim": "2025-03-31", "granularidade": "mensal"},
      "entidades_alvo": {"unidades": ["Unidade A"], "centros_custo": ["Centro Custo 1"], "contas_contabeis": ["Conta 1"], "carteiras": [], "clientes": []},
      "kpis": ["receita", "despesa"],
      "moedas": {"moeda_base": "BRL", "moedas_origem": ["USD", "EUR"]},
      "fontes_requeridas": {"api": true, "bd": false, "documentos": true},
      "busca_online_necessaria": false,
      "modalidade_execucao": "sob_demanda",
      "parametros_agendamento": {"cron_expr": "", "timezone": "", "proxima_execucao_sugerida": ""},
      "flags_trigger": {"fonte_api_solicitada": true, "fonte_bd_solicitada": false, "fonte_documento_solicitada": true, "busca_online_necessaria": false},
      "observacoes_escopo": "Moeda base assumida como BRL."
    }
  } 

• Número de caracteres esperado: O JSON gerado será conciso, com um tamanho estimado em torno de 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 financeiras especificadas para obter dados de transações e cotações.

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: Payloads de API contendo lista de endpoints, período de referência e chaves de paginação se houver.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs em formato JSON.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 5.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo os dados coletados e metadados de proveniência.
• Exemplo de Estrutura de Output:

   {
    "dados_api_recuperados": {
      "tabelas": [{"nome_fonte": "API Financeira 1", "registros": 1000, "campos": ["data", "valor"], "periodo_coberto": "2025-01-01 to 2025-03-31"}],
      "metadados_origem": {"endpoint": "https://api.financeira.com/dados", "horario_coleta": "2025-12-15T15:09:00Z", "contagem": 1000, "status_resposta": 200}
    }
  } 

• Número de caracteres esperado: O JSON gerado será extenso, com um tamanho estimado em torno de 2.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá executar chamadas à API conforme especificado no payload.

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 Consultas em Banco de Dados (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 Consultas em Banco de Dados (RF 3).