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
- 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 Validação e Conferência de Alta Hospitalar (RF 2).
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.