Agente de IA para Preparação de Documentação de Alta Hospitalar

12 de December de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que auxilia na compilação e verificação de documentos necessários para a alta hospitalar.

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 "Preparação de Documentação de Alta Hospitalar", uma solução projetada para garantir que a documentação de alta hospitalar esteja completa e correta antes da liberação do paciente. 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 verificação de documentos de alta, garantindo que todos os campos obrigatórios estejam preenchidos e sinalizando documentos que necessitam de revisão.

2. Contexto e Problema

Cenário Atual

Nos hospitais, a preparação da documentação de alta é um processo crítico que pode enfrentar diversos problemas:

  • Erros e omissões na documentação de alta hospitalar.
  • Atrasos na liberação dos pacientes devido à documentação incompleta.
  • Necessidade de revisão manual dos documentos por parte da equipe médica.

Esses problemas não apenas atrasam a alta dos pacientes, mas também aumentam a carga de trabalho da equipe médica, que precisa revisar manualmente cada documento.


Problemas Identificados

  • Erros Documentais: Erros e omissões nos documentos de alta podem levar a complicações legais e médicas.
  • Atrasos na Alta: Documentação incompleta causa atrasos na liberação dos pacientes, ocupando leitos desnecessariamente.
  • Carga de Trabalho: Revisões manuais aumentam a carga de trabalho da equipe médica, reduzindo a eficiência operacional.

3. Impactos Esperados

A implementação deste agente visa alcançar os seguintes resultados:

  • Reduzir erros na documentação de alta, garantindo que todos os campos obrigatórios estejam preenchidos corretamente.
  • Acelerar o processo de alta, minimizando atrasos na liberação dos pacientes.
  • Reduzir a carga de trabalho da equipe médica, automatizando a verificação e sinalização de documentos.

4. Visão Geral da Solução

O agente de IA para preparação de documentação de alta hospitalar verifica automaticamente a presença de todos os documentos necessários antes da alta, garante que todos os campos obrigatórios estejam preenchidos corretamente e sinaliza documentos que precisam de revisão ou correção. 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 preparação da documentação de alta hospitalar.

A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo inicia com a extração estruturada de dados dos documentos de alta e termina com a validação da completude e consistência dos documentos.

A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.

Agentes Função Principal
Agente de Extração Estruturada de Documentos de Alta Hospitalar (RF 1) Receber documentos de alta e organizar dados essenciais em um JSON unificado.
Agente de Validação e Conferência de Alta Hospitalar (RF 2) Validar completude documental e consistência para liberação de alta.

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 hospital receberá. Explore os links abaixo para entender melhor a solução em ação.

6. Requisitos Funcionais

RF 1. Agente de Extração Estruturada de Documentos de Alta Hospitalar

1.1 Tarefa do Agente

Receber documentos de alta (PDF/texto) e organizar em um JSON unificado e normalizado os dados essenciais do paciente, do episódio de internação e dos componentes obrigatórios de alta para uso por agentes de validação.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo documentos de alta hospitalar em formato PDF ou texto. Estes documentos contêm informações críticas sobre o paciente, o episódio de internação e os componentes obrigatórios para alta.

# 2. Objetivo
Organizar os dados essenciais em um JSON unificado e normalizado.

# 3. Regras que você deve seguir para gerar sua resposta
- Mapeie os documentos e padronize nomes em snake_case para tipos reconhecidos.
- Para cada tipo detectado, preencha subobjetos em campos_extraidos com chaves definidas no expected_output.
- Use o formato ISO-8601 para datas e normalize números e identificações conforme especificado.
- Extraia e repita nome/id/cpf/cartao_sus em todos os documentos onde constarem.
- Cada item de prescrição deve conter ao menos farmaco e dose, se frequência ausente, defina "frequencia": "indefinida".
- Retorne um JSON único exatamente no schema do expected_output.
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 documentos de alta hospitalar 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 documentos na interface da Prototipe AI, para acelerar o processo de validação.
  • Tipo do input: O input inicial para o fluxo são documentos de alta hospitalar em PDF ou texto.
  • Formatos Suportados: Esse agente deve ser capaz de receber documentos nos formatos: .pdf, .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 arquivo no formato JSON contendo os dados extraídos e normalizados dos documentos de alta.
  • Exemplo de Estrutura de Output:
     {"paciente": {"id_paciente": "string", "nome": "string", "data_nascimento": "YYYY-MM-DD", "sexo": "M|F|Outro|Ignorado", "cpf": "string|null", "cartao_sus": "string|null"}, "internacao": {"id_prontuario": "string", "data_admissao": "YYYY-MM-DDThh:mm:ssZ", "data_alta_prevista": "YYYY-MM-DD|null", "data_alta": "YYYY-MM-DDThh:mm:ssZ|null", "tipo_alta": "clinica|cirurgica|obstetrica|pediatrica|uti|psiquiatrica|outro", "regime": "SUS|Saude_Suplementar|Particular"}, "documentos_detectados": ["sumario_alta", "prescricao_alta", "receita", "orientacoes", "laudos_exames", "termo_consentimento", "relatorio_enfermagem", "epicrise", "guia_autorizacao", "checklist_segurança", "atestados", "encaminhamentos"], "campos_extraidos": {"sumario_alta": {"diagnostico_principal": "string|null", "diagnosticos_secundarios": ["string"], "cid10_principal": "string|null", "procedimentos_realizados": ["string"], "cirurgias": ["string"], "complicacoes": ["string"], "evolucao": "string|null"}, "prescricao_alta": {"itens": [{"farmaco": "string", "forma_farmaceutica": "string|null", "dose": "string", "frequencia": "string", "via": "string|null", "duracao": "string|null", "indicacao": "string|null"}]}, "receita": {"itens_controlados": true, "assinatura_medico": true, "carimbo_medico": true}, "orientacoes": {"cuidados_domiciliares": "string|null", "restricoes": ["string"], "sinais_alarme": ["string"], "curativos": "string|null", "dieta": "string|null"}, "follow_up": {"retorno_agendado": true, "data_retorno": "YYYY-MM-DD|null", "local_retorno": "string|null", "especialidade": "string|null"}, "seguranca": {"alergias": ["string"], "riscos": ["queda|lesao_pressao|outros"], "profilaxias": ["anticoagulacao|atb|outros"]}, "responsaveis": {"medico_responsavel": {"nome": "string|null", "crm": "string|null", "assinatura": true, "data_assinatura": "YYYY-MM-DD|null"}, "enfermagem": {"nome": "string|null", "coren": "string|null", "assinatura": true, "data_assinatura": "YYYY-MM-DD|null"}}, "pagador": {"convenio": "string|null", "numero_carteira": "string|null", "guia_autorizacao": "string|null"}}, "qualidade_extracao": {"confianca_campo": [{"campo": "path.json", "score": 0.0}], "itens_ilegiveis": ["path.json"], "paginas_sem_conteudo": [1,2]}}
  • Número de caracteres esperado: O JSON gerado deve ter 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

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

Ao concluir sua execução, esse agente aciona o Agente de Validação e Conferência de Alta Hospitalar (RF 2).

RF 2. Agente de Validação e Conferência de Alta Hospitalar

2.1 Tarefa do Agente

Validar completude documental e consistência clínica-administrativa para liberação de alta, sinalizando pendências, inconsistências e prioridades de correção.

2.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON estruturado produzido pelo Agente de Extração Estruturada de Documentos de Alta Hospitalar.

# 2. Objetivo
Validar a completude e consistência dos documentos de alta, sinalizando pendências e inconsistências.

# 3. Regras que você deve seguir para gerar sua resposta
- Defina itens obrigatórios mínimos por tipo_alta e regime de internação.
- Bloqueie a alta se assinaturas obrigatórias estiverem ausentes.
- Verifique a consistência temporal das datas e a presença de diagnósticos e CIDs.
- Sinalize a necessidade de revisão se houver bloqueios ou inconsistências críticas.
- Retorne um JSON padronizado conforme o schema do expected_output.
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 um JSON estruturado contendo os dados extraídos dos documentos de alta.
  • 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é 5.000 caracteres.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um arquivo no formato JSON detalhando a validação documental e as pendências identificadas.
  • Exemplo de Estrutura de Output:
     {"documentos_completos": true, "campos_preenchidos": true, "necessita_revisao": false, "itens_obrigatorios": {"obrigatorios_detectados": ["sumario_alta", "prescricao_alta", "orientacoes"], "faltantes": ["receita"], "assinaturas_faltantes": [{"documento": "sumario_alta", "responsavel": "medico_responsavel"}]}, "campos_obrigatorios_faltantes": [{"documento": "sumario_alta", "campo": "diagnostico_principal"}], "inconsistencias_criticas": ["data_alta_anterior_a_admissao"], "alertas_nao_criticos": ["cid10_inexistente_mas_diagnostico_textual_presente"], "bloqueios_para_alta": ["ausencia_sumario_assinado"], "sugestoes_correcao": [{"acao": "inserir_assinatura", "alvo": "sumario_alta.medico_responsavel.assinatura", "detalhe": "Médico responsável deve assinar e carimbar o Sumário de Alta."}], "prioridade": "alta", "resumo_validacao": "Faltam assinatura médica no sumário e receita controlada; datas consistentes; retorno agendado presente."}
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 4.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: Não se conecta a sistemas externos.

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 é passada para outros agentes, pois finaliza o fluxo.

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

A execução deste agente finaliza o fluxo, garantindo que a documentação de alta esteja pronta para revisão ou liberação final.

© 2025 prototipe.ai. Todos os direitos reservados.