1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados, ferramentas como chamadas a sistemas externos e demais requisitos funcionais para o Fluxo de Agentes "Geração de Relatórios Financeiros Personalizados", uma solução projetada para coletar dados financeiros do cliente e gerar relatórios personalizados com insights e recomendações. Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.
O objetivo principal é transformar dados financeiros brutos em relatórios claros e acionáveis, destacando insights e oferecendo recomendações personalizadas para cada cliente.
2. Contexto e Problema
As empresas enfrentam desafios ao tentar obter relatórios financeiros personalizados que sejam relevantes para suas necessidades específicas. Muitas vezes, esses relatórios carecem de insights acionáveis baseados nos dados coletados. Para resolver esses problemas, é essencial coletar e analisar dados financeiros do cliente, identificar padrões e tendências, e gerar relatórios que não apenas mostrem números, mas que também ofereçam recomendações práticas e atualizadas.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Fornecer relatórios financeiros personalizados que são relevantes para cada cliente.
- Destacar insights acionáveis que ajudam na tomada de decisão estratégica.
- Atualizar relatórios regularmente para refletir mudanças nas finanças do cliente e no mercado.
4. Visão Geral da Solução
O agente de IA para geração de relatórios financeiros personalizados coleta dados financeiros do cliente de diferentes fontes, analisa esses dados para identificar padrões e tendências, e gera relatórios que destacam insights e oferecem recomendações acionáveis. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um assistente útil e autônomo na geração de relatórios financeiros personalizados que atendem às necessidades específicas de cada cliente.
A solução consiste em um fluxo de automação composto por 7 agentes de IA. O processo inicia com a preparação para a coleta de dados e termina com a geração de um relatório financeiro personalizado pronto para envio ao cliente.
| Agentes | Função Principal |
|---|---|
Agente de Preparação de Coleta de Dados Financeiros (RF 1)
| Construir parâmetros de coleta a partir do perfil do cliente e do período de interesse. |
Agente de Execução de Chamada à API (RF 2)
| Realizar chamadas às APIs dos sistemas financeiros do cliente para obter dados brutos. |
Agente de Ingestão, Normalização e Qualidade de Dados Financeiros (RF 3)
| Consolidar dados de APIs e arquivos manuais em um esquema único. |
Agente de Cálculo de KPIs e Tendências Financeiras (RF 4)
| Calcular KPIs financeiros, identificar padrões e tendências temporais. |
Agente de Busca Online de Contexto de Mercado (RF 5)
| Realizar busca online por benchmarks setoriais e indicadores macroeconômicos. |
Agente de Geração de Insights e Recomendações Acionáveis (RF 6)
| Converter KPIs e tendências em insights claros e recomendações priorizadas. |
Agente de Geração de Relatório Financeiro Personalizado (RF 7)
| Montar o relatório em Markdown pronto para envio ao cliente. |
5. Protótipos
Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram tanto o fluxo de trabalho dos agentes quanto o resultado final que o cliente receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Preparação de Coleta de Dados Financeiros
1.1 Tarefa do Agente
Construir parâmetros de coleta a partir do perfil do cliente e do período de interesse, gerando payloads prontos para chamadas a APIs e instruções para ingestão de arquivos manuais.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um conjunto de dados que inclui o perfil do cliente e o período de interesse para a coleta de dados financeiros. # 2. Objetivo Construir parâmetros de coleta a partir do perfil do cliente e do período de interesse, gerando payloads prontos para chamadas a APIs e instruções para ingestão de arquivos manuais. # 3. Regras que você deve seguir para gerar sua resposta - Sempre definir janela de dados cobrindo pelo menos 18 meses anteriores ao fim do período para cálculo de tendências; se periodo.inicio < 18m, usar o inicio informado. - Para cada escopo informado nas fontes.apis, gerar endpoints padrão: contabilidade: /gl/lancamentos/; banco: /contas/transacoes/; erp: /financeiro/pagamentos,/financeiro/recebimentos; crm: /oportunidades/receita. - Incluir paginação padrão (limit=1000, cursor) no payload quando não especificado pelo sistema; registrar no payload o campo pagination=true quando necessário. - Normalizar moeda_base para ISO 4217 em maiúsculas; se ausente, definir como "USD". - Definir timezone como "UTC" se não informado. - Para ingestão manual, gerar schema_esperado por tipo: ofx: data, descricao, valor, tipo, banco, conta; csv/xlsx (contábil): data, conta, historico, debito, credito, centro_custo, projeto; csv/xlsx (faturamento): data_emissao, cliente, valor_bruto, impostos, valor_liquido; pdf: instruir extração para tabela com colunas data, descricao, valor. - Validar que credenciais_ref foi informado para cada fonte API; se ausente, marcar o item para ingestão_manual. - Preencher incluir_contexto_de_mercado=false quando campo ausente.
1.3 Configurações do Agente
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 dados financeiros do cliente 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 de um arquivo na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um conjunto de dados financeiros do cliente.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos:
.csv,.xlsx,.pdf. - 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 um conjunto de parâmetros de coleta prontos para chamadas a APIs e instruções para ingestão de arquivos manuais.
- 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.
- 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).
RF 2. Agente de Execução de Chamada à API
2.1 Tarefa do Agente
Realizar chamadas às APIs dos sistemas financeiros do cliente para obter dados brutos.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um conjunto de parâmetros de coleta prontos para chamadas a APIs dos sistemas financeiros do cliente. # 2. Objetivo Realizar chamadas às APIs dos sistemas financeiros do cliente para obter dados brutos. # 3. Regras que você deve seguir para gerar sua resposta - Este agente apenas executa as chamadas conforme os payloads recebidos e retorna os dados brutos sem transformações.
2.3 Configurações do Agente
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 um conjunto de parâmetros de coleta prontos para chamadas a APIs.
-
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é 10.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um conjunto de dados brutos obtidos das APIs dos sistemas financeiros do cliente.
- Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 5.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: Apenas realiza chamadas a APIs externas conforme instruído.
2.3.5 Memória
- Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Ingestão, Normalização e Qualidade 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 Ingestão, Normalização e Qualidade de Dados Financeiros (RF 3).