Agente de IA para Análise de Contas Hospitalares

Receber contas hospitalares (PDF, CSV, planilha ou texto) e produzir um JSON estruturado e validado, padronizando códigos, quantidades, valores e metadados necessários para auditoria.

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 arquivos de contas hospitalares 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 dos arquivos na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo são arquivos de contas hospitalares em diversos formatos.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .pdf, .csv, .xlsx, .txt.
• 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 JSON estruturado contendo os dados da conta padronizados e validados para auditoria.
• Exemplo de Estrutura de Output:

   { "identificacao_paciente": {"nome": "João Silva", "id_paciente": "12345", "data_nascimento": "1980-01-01"}, "atendimento": {"id_atendimento": "67890", "tipo": "internacao", "datas": {"admissao": "2025-12-01", "alta": "2025-12-10"}, "medico_responsavel": "Dr. Carlos", "unidade": "Hospital Central", "leito": "101"}, "convenio": {"nome": "Saúde Plus", "plano": "Ouro", "numero_carteira": "SP123456", "numero_autorizacao": "AUT98765", "validade_autorizacao": {"inicio": "2025-12-01", "fim": "2025-12-10"}}, "itens": [{"id_item": "001", "data_lancamento": "2025-12-02", "codigo": "A123", "descricao": "Consulta Médica", "grupo": "procedimento", "quantidade": 1, "unidade_medida": "unidade", "valor_unitario": 150.00, "valor_total": 150.00, "centro_custo": "Consultas"}], "totais": {"subtotal_itens": 150.00, "descontos": 0.00, "coparticipacao": 0.00, "franquia": 0.00, "impostos": 0.00, "total_faturado": 150.00}, "anexos_requeridos": ["descricoes"], "observacoes": "" } 

• Número de caracteres esperado: O JSON gerado deve ser conciso e informativo, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a complexidade da conta.

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 Consulta a Documento (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 Consulta a Documento (RF 2).

Realizar consulta a documentos de referência (políticas de faturamento do convênio e tabelas de codificação/valoração como TUSS/CBHPM) para obter regras e preços de referência aplicáveis aos códigos presentes na conta.

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 parâmetros de consulta já prontos para execução.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato de parâmetros JSON.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 3.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados de referência recuperados.
• Exemplo de Estrutura de Output:

   { "tabela_precos": [{"codigo": "A123", "descricao_ref": "Consulta Médica", "preco_ref": 150.00, "unidade_ref": "unidade", "vigencia": {"inicio": "2025-01-01", "fim": "2025-12-31"}, "fonte": "TUSS"}], "regras_aplicaveis": [{"id_regra": "R001", "tipo": "precificacao", "descricao": "Preço TUSS", "condicao_aplicacao": "", "parametros": "", "vigencia": {"inicio": "2025-01-01", "fim": "2025-12-31"}, "fonte": "TUSS"}], "incompatibilidades": [], "pacotes": [], "observacoes_consulta": "Consulta realizada com sucesso" } 

• Número de caracteres esperado: O JSON gerado deve ter 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: Este agente executa consultas a documentos externos conforme as regras definidas no prompt.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Este agente se conecta a sistemas externos para realizar consultas a documentos de referência.

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 Auditoria de Contas Hospitalares (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Auditoria de Contas Hospitalares (RF 3).

Aplicar regras de faturamento e integridade sobre o json_conta_estruturada usando dados_referencia para identificar discrepâncias e sugerir correções precisas e mensuráveis.

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 um JSON estruturado da conta hospitalar e dados de referência para auditoria.
• 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é 10.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as discrepâncias identificadas e as correções sugeridas.
• Exemplo de Estrutura de Output:

   { "discrepancias": [{"id_discrepancia": "D001", "severidade": "alta", "tipo": "precificacao", "item_ref": {"id_item": "001", "codigo": "A123", "descricao": "Consulta Médica"}, "regra_base": {"id_regra": "R001", "fonte": "TUSS"}, "valor_encontrado": 160.00, "valor_esperado": 150.00, "delta_valor": 10.00, "explicacao": "Preço acima do referencial TUSS", "acao_sugerida": {"tipo": "alterar_valor", "parametros": {"novo_valor_unitario": 150.00}}, "impacto_financeiro": {"sinal": "-", "valor": 10.00}}], "totais_recalculados": {"antes": 160.00, "depois": 150.00}, "conformidade_geral": {"status": "nao_conforme", "resumo": "Discrepâncias identificadas"}, "pendencias_documentais": [] } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.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: Utiliza lógica interna para cálculo de discrepâncias e correções.
• Busca Online: Não utiliza.
• 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 Geração de Relatório e Plano de Correção (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatório e Plano de Correção (RF 4).

Consolidar os achados da auditoria e produzir materiais de saída para correção e envio: um relatório legível e um JSON operacional com as ações a executar na conta.

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 um JSON estruturado com os achados da auditoria.
• 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é 8.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve incluir dois artefatos: (1) um relatório legível em Markdown e (2) um JSON operacional com as ações a executar na conta.
• Exemplo de Estrutura de Output:

   # Relatório de Auditoria
  
  ## Resumo Executivo
  Foram identificadas discrepâncias nas contas hospitalares auditadas. Ações corretivas foram sugeridas.
  
  ## Tabela de Discrepâncias
  - **ID:** D001
  - **Severidade:** Alta
  - **Tipo:** Precificação
  - **Item:** Consulta Médica
  - **Valor Encontrado:** R$160,00
  - **Valor Esperado:** R$150,00
  - **Ação Sugerida:** Alterar valor para R$150,00
  
  ## Pendências Documentais
  Nenhuma pendência documental identificada.
  
  ## Totais Antes/Depois
  - **Total Antes:** R$160,00
  - **Total Depois:** R$150,00
  
  ## Checklist de Conformidade
  Discrepâncias corrigidas e conta pronta para envio.
  
  # JSON de Correções
  { "acoes": [{"ordem": 1, "tipo": "alterar_valor", "item_ref": {"id_item": "001"}, "parametros": {"novo_valor_unitario": 150.00}, "justificativa": "Preço ajustado conforme TUSS", "base_regulatoria": "TUSS"}], "novos_totais": {"antes": 160.00, "depois": 150.00}, "pronto_para_envio": true, "riscos_remanescentes": [] } 

• Número de caracteres esperado: O relatório deve ser conciso e informativo, com um tamanho estimado em torno de 6.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: Utiliza lógica interna para cálculo de totais e ações corretivas.
• 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 é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. O relatório e o JSON gerados são os resultados que devem ser disponibilizados ao usuário.