1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados e demais requisitos funcionais para o Agente de IA "Geração de Relatórios de Faturamento Hospitalar", uma solução projetada para coletar e sintetizar informações de faturamento de diversos departamentos e gerar relatórios detalhados para análise financeira. 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 é automatizar a coleta de dados de faturamento e a geração de relatórios, permitindo uma análise financeira mais eficaz e reduzindo o tempo e esforço manual necessários.
2. Contexto e Problema
Cenário Atual
Atualmente, os hospitais enfrentam desafios significativos para reunir informações de faturamento de diferentes departamentos, resultando em dados fragmentados e inconsistentes. A falta de relatórios detalhados dificulta a análise financeira eficaz e pode levar a decisões financeiras subótimas.
Problemas Identificados
- Dificuldade de Integração: As informações de faturamento estão espalhadas por diversos departamentos, cada um com seu próprio sistema e formato de dados.
- Inconsistência de Dados: A falta de padronização nos dados coletados leva a discrepâncias e erros em relatórios financeiros.
- Tempo e Esforço: A coleta manual e a síntese de dados de faturamento consomem tempo valioso dos colaboradores.
- Falta de Detalhamento: Os relatórios atuais são muitas vezes superficiais, faltando detalhes essenciais para uma análise financeira abrangente.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Automatizar a coleta de dados de faturamento, reduzindo o tempo e esforço manual necessários.
- Aumentar a precisão e consistência dos dados de faturamento coletados.
- Gerar relatórios detalhados e padronizados que suportem uma análise financeira eficaz.
- Facilitar a integração de dados de diferentes departamentos em um formato unificado.
4. Visão Geral da Solução
O agente de IA para geração de relatórios de faturamento hospitalar coleta e sintetiza informações de faturamento de diversos departamentos, gerando relatórios detalhados para análise financeira. 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 detalhados.
A solução consiste em um fluxo de automação composto por dois agentes de IA. O processo inicia com a coleta de informações de faturamento e termina com a geração de um relatório detalhado em formato markdown.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo:
| Agentes | Função Principal |
|---|---|
Agente de Coleta de Informações de Faturamento (RF 1)
| Coletar informações de faturamento de diversos departamentos. |
Agente de Síntese de Relatórios (RF 2)
| Gerar relatórios detalhados de faturamento para análise financeira. |
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 Coleta de Informações de Faturamento
1.1 Tarefa do Agente
Coletar informações de faturamento de diversos departamentos.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo pedidos de coleta de dados de faturamento de cada departamento em formato de texto ou planilha. # 2. Objetivo Coletar informações de faturamento de diversos departamentos e convertê-las em um formato JSON padronizado. # 3. Regras que você deve seguir para gerar sua resposta - Identificar e acessar todas as fontes de dados de faturamento indicadas pelos departamentos, utilizando credenciais e métodos de acesso autorizados. - Garantir que os dados coletados estejam atualizados até a data mais recente disponível, sinalizando qualquer discrepância temporal encontrada. - Converter os dados coletados para um formato JSON padronizado, assegurando que todas as variáveis essenciais, como receita, custos e datas relevantes, estejam presentes e corretamente formatadas.
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 pedidos de coleta de dados de faturamento 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 pedido de coleta de dados em formato de texto ou planilha.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos:
.txt,.csv,.xlsx. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 50.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo os dados de faturamento coletados e padronizados.
-
Exemplo de Estrutura de Output:
{ "department": "Cardiologia", "revenue": 150000, "costs": 50000, "date": "2025-11-11" } - Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.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 Síntese de Relatórios (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Síntese de Relatórios (RF 2).
RF 2. Agente de Síntese de Relatórios
2.1 Tarefa do Agente
Gerar relatórios detalhados de faturamento para análise financeira.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados de faturamento coletados de cada departamento em formato JSON. # 2. Objetivo Gerar relatórios detalhados de faturamento para análise financeira, destacando as principais métricas financeiras. # 3. Regras que você deve seguir para gerar sua resposta - Agregar os dados de faturamento coletados de cada departamento, destacando as principais métricas financeiras, como receita total e custos. - Calcular e incluir KPIs relevantes, como margem de lucro e variações mensais ou anuais, conforme necessário para uma análise financeira compreensiva. - Estruturar o relatório em seções claras e concisas, utilizando markdown para facilitar a legibilidade e a apresentação visual dos dados, incluindo gráficos e tabelas quando necessário.
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 como input dados de faturamento em formato JSON, que foram coletados e padronizados pelo agente anterior.
-
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 relatório detalhado em formato markdown, estruturado em seções claras e concisas.
-
Exemplo de Estrutura de Output:
# Relatório de Faturamento Hospitalar ## Visão Geral - Receita Total: R$ 150.000 - Custos Totais: R$ 50.000 ## KPI's - Margem de Lucro: 66.67% - Variação Mensal: +5% ## Detalhamento por Departamento - **Cardiologia** - Receita: R$ 150.000 - Custos: R$ 50.000
- Número de caracteres esperado: O relatório final deve ser conciso e informativo, com um tamanho estimado em torno de 3.500 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: Utiliza lógica interna para calcular métricas financeiras.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
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 não precisa ser visível para agentes subsequentes, pois é o resultado final do fluxo.
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, este agente finaliza o fluxo de geração de relatórios.