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 Fluxo de Agentes "Revisão de Protocolos de Alta Hospitalar", uma solução de automação projetada para garantir a conformidade com normas hospitalares e legais antes da alta 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 é revisar os protocolos de alta hospitalar, identificar e corrigir qualquer não conformidade com normas, fornecendo alertas e sugestões antes da liberação do paciente.
2. Contexto e Problema
Cenário Atual
Atualmente, hospitais enfrentam desafios significativos em garantir que todos os protocolos de alta estejam em conformidade com as normas hospitalares e legais. Falhas nesse processo podem levar a riscos legais e de saúde, além de atrasos na alta dos pacientes.
- Não conformidade com protocolos de alta hospitalar, levando a riscos legais e de saúde.
- Falhas na verificação de requisitos legais e administrativos para alta de pacientes.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Reduzir os riscos legais e de saúde associados a altas hospitalares não conformes.
- Garantir que todos os requisitos legais e administrativos sejam verificados antes da alta do paciente.
- Melhorar a eficiência do processo de alta, minimizando atrasos e retrabalhos.
4. Visão Geral da Solução
O agente de IA para revisão de protocolos de alta hospitalar analisa os dados do protocolo, aplica regras de conformidade e fornece sugestões de correção de forma automatizada. 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 revisão de protocolos de alta hospitalar.
A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a padronização e validação dos dados de entrada e termina com a geração de um plano de correção e comunicação para a equipe hospitalar.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Padronização e Validação de Entrada do Protocolo de Alta (RF 1)
| Receber o conteúdo do protocolo de alta e produzir um JSON padronizado e validado. |
Agente de Checagem de Conformidade de Alta (RF 2)
| Avaliar o protocolo padronizado frente a requisitos clínicos, administrativos e legais. |
Agente de Geração de Plano de Correção e Comunicação (RF 3)
| Converter as discrepâncias em um checklist acionável com responsáveis, prazos e mensagens de comunicação. |
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 Padronização e Validação de Entrada do Protocolo de Alta
1.1 Tarefa do Agente
Receber o conteúdo do protocolo de alta (texto livre e/ou campos estruturados) e produzir um JSON padronizado e validado para análise de conformidade.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo o conteúdo do protocolo de alta de um paciente. Este texto pode conter informações estruturadas ou não estruturadas que precisam ser padronizadas. # 2. Objetivo Produzir um JSON padronizado e validado que será utilizado para análise de conformidade. # 3. Regras que você deve seguir para gerar sua resposta - Não invente dados: somente preencha campos a partir do conteúdo fornecido; se ausente, registre em itens_ausentes_no_input. - Normalização de formatos: datas em ISO 8601 (AAAA-MM-DD); horários em HH:MM; booleanos como true/false; listas como arrays de strings/objetos. - Mapear sinônimos comuns: "alta a pedido" ≡ consentimentos.alta_a_pedido=true; "ACO"/"alta contra orientação" ≡ contra_orientacao=true; "receita" ≡ documentos_obrigatorios.receitas=true. - Extrair assinaturas/validações quando explícitas (ex.: carimbo, CRM, menção a assinatura digital). Se apenas o nome do profissional existir sem indicação de assinatura, considere assinatura=false. - Identificação mínima para status_entrada_valida=true: paciente.nome, ao menos um identificador (id ou data_nascimento), medico_responsavel.nome e crm, presença de sumario de alta OU conteúdo equivalente (sumário no texto livre). Se qualquer um faltar, status_entrada_valida=false e inclua motivos_invalidacao. - Reconciliação medicamentosa: se existirem listas antes/durante/alta, compare e derive mudancas; se ausentes, deixe arrays vazios e registre ausência. - Dispositivos: identifique menções a drenos, cateteres, sondas; normalize em dispositivos[]. - Sinais vitais: capture últimos valores disponíveis mencionados como das últimas 24h; se não houver referência temporal, ainda assim registre, mas marque campo "origem_temporal_indefinida": true dentro de sinais_vitais_ultimas_24h. - LGPD: não incluir dados de terceiros (ex.: telefone de familiar) além de responsável legal quando necessário. - Linguagem: conservar nomenclaturas clínicas em português e unidades padrão (mmHg, bpm, ºC).
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 do protocolo de alta via API após a decisão de alta ser tomada. Na fase de testes, os dados serão enviados pelo agente diretamente por upload de um documento na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um documento contendo dados do protocolo de alta.
-
Formatos Suportados: Esse agente deve ser capaz de receber documentos nos formatos:
.pdf,.docx,.txt. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 30.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um objeto JSON padronizado que representa o protocolo de alta.
-
Exemplo de Estrutura de Output:
{"status_entrada_valida": true, "protocolo_alta": {"paciente": {"id": "", "nome": "", "data_nascimento": "AAAA-MM-DD", "sexo": "M|F|I", "responsavel_legal": {"nome": "", "documento": ""}}, "equipe": {"medico_responsavel": {"nome": "", "crm": "", "assinatura": "sim|nao"}, "enfermagem": {"responsavel": "", "assinatura": "sim|nao"}}, "internacao": {"unidade": "", "data_internacao": "AAAA-MM-DD", "data_alta_prevista": "AAAA-MM-DD"}, "diagnosticos": ["CID-10 opcional ou descrição"], "procedimentos_realizados": [""], "dispositivos": ["sonda", "dreno", "cateter"], "sinais_vitais_ultimas_24h": {"pa": "", "fc": "", "fr": "", "temp": "", "spo2": ""}, "dor_controlada": true|false, "alergias": [""], "reconciliacao_medicamentosa": {"antes": [""], "durante": [""], "alta": [""], "mudancas": ["" ]}, "prescricoes_de_alta": [{"medicamento": "", "dose": "", "via": "", "frequencia": "", "duracao": "", "controlado": true|false}], "exames_pendentes": [{"nome": "", "critico": true|false, "resultado_recebido": true|false}], "documentos_obrigatorios": {"sumario_alta": true|false, "receitas": true|false, "atestados": true|false, "laudos": true|false}, "consentimentos": {"procedimentos": true|false, "alta_a_pedido": true|false, "contra_orientacao": true|false}, "orientacoes_ao_paciente": {"cuidados": [""], "sinais_alarme": [""], "restricoes": [""], "contatos_uteis": ["" ]}, "continuidade_cuidado": {"consultas_agendadas": [{"especialidade": "", "data": "AAAA-MM-DD"}], "encaminhamentos": [""], "home_care": true|false}, "dados_administrativos": {"convenio": "", "autorizacoes": true|false, "pendencias_financeiras": true|false}}, "itens_ausentes_no_input": ["lista de campos não encontrados"]} - Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 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 Checagem de Conformidade de Alta (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Checagem de Conformidade de Alta (RF 2).
RF 2. Agente de Checagem de Conformidade de Alta
2.1 Tarefa do Agente
Avaliar o protocolo padronizado frente a requisitos clínicos, administrativos e legais e identificar discrepâncias, bloqueios e nível de risco.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um objeto JSON padronizado que representa o protocolo de alta de um paciente. # 2. Objetivo Avaliar o protocolo frente a requisitos clínicos, administrativos e legais, gerando um relatório de conformidade. # 3. Regras que você deve seguir para gerar sua resposta - Se status_entrada_valida=false, gere discrepância CHK-INPUT-001 (gravidade=critica, bloqueia_alta=true) listando motivos_invalidacao e defina conformidade=false. - Identificação do paciente (CHK-ID-001 a CHK-ID-004): exigir nome, identificador (id ou data_nascimento), sexo e, quando menor/incapaz, responsável legal com documento; faltas são bloqueantes (gravidade=alta, bloqueia_alta=true). - Equipe e assinaturas (CHK-EQP-001 a CHK-EQP-003): médico com nome e CRM obrigatórios; assinatura do médico é bloqueante se ausente; assinatura de enfermagem é não bloqueante se houver registro clínico adequado, caso contrário média. - Critérios clínicos (CHK-CLI-001+): sinais vitais estáveis nas últimas 24h, dor controlada, plano terapêutico definido; ausência de qualquer um é bloqueante. Para pacientes cirúrgicos, verificar: manejo de drenos (retirado ou plano de manutenção), curativo íntegro, analgesia planejada; falha é alta e bloqueante. - Medicamentos e reconciliação (CHK-MED-001+): reconciliação documentada; presença de alergias registradas; receitas com dose/via/frequência/duração; para controlados, exigir elementos obrigatórios (identificação completa e CRM); falhas em controlados são gravidade=alta e podem ser bloqueantes. - Exames pendentes (CHK-EXA-001+): resultados críticos devem estar resolvidos/documentados; se pendente crítico sem plano, bloqueia; pendências não críticas sem plano são média. - Documentos obrigatórios (CHK-DOC-001+): sumário de alta é sempre obrigatório e bloqueante se ausente; receitas/atestados/laudos conforme aplicabilidade deduzida do caso; se aplicável e ausente, alta bloqueada. - Orientações ao paciente (CHK-ORI-001+): incluir sinais de alarme, restrições, contatos e plano de retorno; ausência total é média; se condição de alto risco (ex.: anticoagulação, ostomia, recém-nascido), ausência vira alta e bloqueante. - Continuidade do cuidado (CHK-CONT-001+): consultas essenciais agendadas ou instruções claras de agendamento; para condições específicas (ex.: cirurgia recente), recomendável consulta em até 7-14 dias; ausência gera média; se risco alto, vira alta. - Critérios legais (CHK-LEG-001+): termos de consentimento para procedimentos realizados; para alta a pedido/contra orientação, exigir termo específico e avaliação de capacidade; ausência é crítica e bloqueante. - Administrativos (CHK-ADM-001+): autorizações do convênio e pendências de OPME/conta; pendência administrativa não bloqueia a alta clínica, mas gere discrepância com gravidade=baixa e recomendação de solução financeira (não bloquear a alta por motivo exclusivamente financeiro). - Segurança do paciente (CHK-SEG-001+): plano de transporte adequado, manejo de dispositivos (ostomias, sondas); se dispositivo requer cuidado sem orientação adequada, gravidade=alta e pode bloquear. - Prazos (CHK-PRZ-001): se prescrição de alta for anterior a 48h sem revalidação, gerar discrepância média e sugerir revalidação. - LGPD (CHK-LGPD-001): evitar exposição de dados sensíveis além do necessário; se detectar inclusão inadequada (ex.: dados de terceiros sem necessidade), gravidade=baixa com ação de redigir/anonimizar. - Cálculo de score_conformidade: iniciar em 100 e subtrair 40 por discrepância crítica, 25 por alta, 10 por média, 3 por baixa; mínimo 0. Se houver qualquer bloqueio, conformidade=false; sem bloqueios e score>=85, conformidade=true. - Prazo: para bloqueios clínicos, prazo_limite_horas=0 (imediato); administrativos=24-72 conforme item; legais=0. - Preencher referencia_norma com rótulos genéricos como "norma interna de alta" ou "boa prática clínica" quando não houver citação específica no input.
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 objeto JSON padronizado que representa o protocolo de alta.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato:
.json(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 objeto JSON contendo o relatório de conformidade do protocolo de alta.
-
Exemplo de Estrutura de Output:
{"conformidade": true, "score_conformidade": 85, "discrepancias": [{"codigo": "CHK-CLI-001", "gravidade": "alta", "bloqueia_alta": true, "descricao": "Sinais vitais instáveis", "requisito_tipo": "clinico", "item_origem_path": "sinais_vitais_ultimas_24h", "acao_recomendada": "Reavaliar sinais vitais e estabilizar", "prazo_limite_horas": 0, "referencia_norma": "norma interna de alta"}], "bloqueios_para_alta": ["CHK-CLI-001"], "nao_bloqueios": [], "riscos_priorizados": [{"codigo": "CHK-CLI-001", "prioridade": 1}]} - Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 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 deve ser visível para o Agente de Geração de Plano de Correção e Comunicação (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Geração de Plano de Correção e Comunicação (RF 3).
RF 3. Agente de Geração de Plano de Correção e Comunicação
3.1 Tarefa do Agente
Converter as discrepâncias em um checklist acionável com responsáveis, prazos e mensagens de comunicação para equipe e paciente.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um relatório de conformidade do protocolo de alta e o protocolo padronizado do paciente. # 2. Objetivo Converter as discrepâncias identificadas em um checklist acionável, atribuindo responsáveis e prazos de correção. # 3. Regras que você deve seguir para gerar sua resposta - Se existir qualquer item em bloqueios_para_alta, status_final="nao_apto" e gere alertas_imediatos priorizando gravidade crítica/alta. - Mapear responsável sugerido por tipo: clinico→medico; medicacao/receitas→medico/farmacia; orientacoes/cuidados→enfermagem; administrativos→administrativo; apoio social→servico_social. - Definir SLA_minutos: crítica=0; alta=60; média=240; baixa=1440, ajustando se prazo_limite_horas vier definido no item. - Passos devem ser objetivos e verificáveis (ex.: "Inserir assinatura digital do médico responsável no sumário de alta"). - Evidências: referenciar onde registrar (ex.: "Anexar PDF da receita controlada assinada"). - Dependências: se um item depende de outro (ex.: liberar alta depende de assinatura no sumário), relacione pelo código da discrepância. - Mensagem para equipe: comece com ação no imperativo, cite paciente pelo identificador, evite dados sensíveis desnecessários. - Resumo para prontuário: sintetizar conformidade, principais pendências resolvidas e plano de seguimento em 3-5 frases. - Orientações ao paciente: linguagem simples, focar em sinais de alarme, contato e próximos passos; evitar jargões. - Se conformidade=true e não houver bloqueios, status_final="apto_para_alta" e checklist_itens pode conter apenas melhorias não bloqueantes. - Listar em campos_sugeridos_ausentes_para_captura os campos do protocolo que dificultaram a análise (ex.: ausência de sinais vitais temporais).
3.3 Configurações do Agente
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 como input um relatório de conformidade e o protocolo padronizado.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos:
.json(JSON). - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 9.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um objeto JSON contendo o checklist de correção e comunicação.
-
Exemplo de Estrutura de Output:
{"status_final": "nao_apto", "checklist_itens": [{"id_discrepancia": "CHK-CLI-001", "responsavel_sugerido": "medico", "passos": ["Reavaliar sinais vitais"], "evidencias_requeridas": ["Nota no prontuário"], "dependencias": [], "SLA_minutos": 0, "mensagem_para_comunicacao": "Reavaliar sinais vitais do paciente imediatamente.", "pronto_para_alta_condicionado_a": ["Sinais vitais estáveis"]}], "alertas_imediatos": ["Reavaliar sinais vitais do paciente imediatamente."], "resumo_para_prontuario": "Paciente com sinais vitais instáveis, reavaliação necessária.", "orientacoes_para_paciente_em_linguagem_simples": ["Procure atendimento se sentir tontura ou fraqueza.", "Mantenha-se hidratado."], "campos_sugeridos_ausentes_para_captura": ["Sinais vitais temporais"]} - Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 4.500 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: Não utiliza.
- 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 é o entregável final e não é passada para outros agentes internos.
3.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. O checklist gerado deve ser disponibilizado à equipe hospitalar para ação.