1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados, ferramentas como consulta a documentos e demais requisitos funcionais para o Agente de IA de Triagem de Documentação de Pacientes. 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 e validar a documentação necessária para a admissão de pacientes, incluindo seguros, autorizações e consentimentos, garantindo conformidade e evitando atrasos no processo de admissão.
2. Contexto e Problema
Problemas Identificados
- Atrasos na admissão: A documentação incompleta ou incorreta resulta em atrasos na admissão de pacientes.
- Risco de não conformidade: Falhas na revisão de documentos podem levar à não conformidade com regulamentações.
3. Impactos Esperados
A implementação deste agente visa alcançar os seguintes resultados:
- Reduzir atrasos na admissão ao garantir que toda documentação esteja completa e correta antes da admissão.
- Aumentar a conformidade com regulamentações ao verificar todos os documentos necessários.
- Melhorar a eficiência do processo de admissão, liberando a equipe para outras atividades críticas.
4. Visão Geral da Solução
O agente de IA para triagem de documentação de pacientes analisa e valida documentos de seguros, autorizações e consentimentos, garantindo que estejam completos e em conformidade com as regulamentações vigentes. 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 no processo de admissão de pacientes.
A solução consiste em um fluxo de automação composto por 5 agentes de IA. O processo inicia com a extração estruturada dos documentos e termina com a notificação à equipe hospitalar sobre pendências críticas.
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 Admissão (RF 1)
| Extrair e normalizar campos necessários dos documentos enviados para admissão. |
Agente de Execução de Consulta a Documento (RF 2)
| Consultar o Guia de Regulamentações de Seguros para obter regras aplicáveis. |
Agente Analítico de Conformidade de Seguro (RF 3)
| Validar o documento de seguro quanto à completude e conformidade. |
Agente Analítico de Autorizações e Consentimentos (RF 4)
| Verificar completude e conformidade das autorizações médicas e termos de consentimento. |
Agente Consolidado de Triagem e Notificação (RF 5)
| Consolidar resultados das validações e notificar a equipe hospitalar sobre pendências críticas. |
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 Admissão
1.1 Tarefa do Agente
Extrair e normalizar, em formato JSON estruturado, os campos necessários dos documentos de seguro, autorizações médicas e termos de consentimento enviados para admissão.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo documentos de seguro, autorizações médicas e termos de consentimento em formato PDF ou imagem. Esses documentos são parte do processo de admissão de pacientes. # 2. Objetivo Extrair e normalizar os campos necessários dos documentos recebidos, estruturando-os em um formato JSON padronizado. # 3. Regras que você deve seguir para gerar sua resposta - Para doc_type=seguro, extrair: numero_apolice, seguradora, tipo_plano, nome_titular, nome_dependente (se houver), validade_inicio, validade_fim, uf_atendimento, abrangencia, codigo_cartao (se houver), frente_verso_cartao_presente (true/false). - Para doc_type=autorizacao, extrair: numero_autorizacao, pagadora (seguradora/operadora), data_emissao, validade_fim, procedimentos (lista de códigos e descrições), cids (se houver), nome_prestador, cnpj_prestador, local_atendimento, assinatura_prestador_presente, carimbo_prestador_presente. - Para doc_type=consentimento, extrair: tipo_procedimento, escopo_procedimento, paciente_ou_representante, nome_assinante, relacao_assinante, documento_identificacao, data_assinatura, hora_assinatura (se houver), testemunha_nome (se exigido), assinaturas_presentes (paciente/rep e prestador), paginas_inicializadas (true/false), clausula_revogacao (true/false), consentimento_privacidade_LGPD (true/false). - Normalizar datas para ISO 8601 (YYYY-MM-DD) e horas HH:MM. Normalizar nomes em caixa-título; remover espaços duplos; padronizar UF em duas letras. - Avaliar legibilidade: se mais de 30% do texto não for reconhecível ou fotos desfocadas, marcar legivel=false e extraction_quality=baixa; incluir em inconsistencias: "documento_ilegivel". - Verificar consistência de nomes: comparar patient_name do metadado com nome_titular/nome_dependente/nome_assinante; se similaridade < 0,90, registrar em inconsistencias: "nome_divergente" com pares comparados. - Validar presença de assinatura quando esperada: se doc_type=autorizacao ou consentimento e assinaturas_presentes=false, incluir em campos_faltantes: "assinatura_obrigatoria". - Preencher pronto_para_validacao=true somente se legivel=true.
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 arquivos de documentos (PDF/imagem) 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: Arquivos de documentos (PDF/imagem) com metadados mínimos: {patient_name, patient_id (opcional), doc_type ∈ [seguro, autorizacao, consentimento], data_admissao prevista (YYYY-MM-DD)}.
-
Formatos Suportados: Esse agente deve ser capaz de receber documentos nos formatos:
.pdf,.jpg,.png. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto extraído com até 10.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON estruturado contendo todos os campos extraídos dos documentos, além de informações sobre a qualidade da extração e qualquer inconsistência detectada.
-
Exemplo de Estrutura de Output:
{"docs_extraidos": [{"doc_type": "seguro|autorizacao|consentimento", "extraction_quality": "alta|media|baixa", "legivel": true, "paginas": 3, "campos": { ...campos_extraidos... }, "campos_faltantes": ["campo"], "inconsistencias": ["descricao"], "alertas_formais": ["descricao"]}], "pronto_para_validacao": true} - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.500 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 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).
RF 2. Agente de Execução de Consulta a Documento
2.1 Tarefa do Agente
Realizar consulta ao documento Guia de Regulamentações de Seguros para obter regras aplicáveis de cobertura, vigência e requisitos de autorização conforme plano e procedimento.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo parâmetros prontos para consulta e instruções específicas. Sua tarefa é consultar o Guia de Regulamentações de Seguros. # 2. Objetivo Obter regras aplicáveis para cobertura, vigência e requisitos de autorização com base nos parâmetros recebidos. # 3. Regras que você deve seguir para gerar sua resposta - Execute a consulta ao documento e retorne trechos e regras pertinentes conforme os parâmetros recebidos. - Não realize análise ou decisão, apenas forneça as informações encontradas no documento. - Estruture a resposta em um JSON com as regras encontradas, referências do documento e status da consulta.
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: Parâmetros prontos: {seguradora, tipo_plano, uf_atendimento, data_admissao, procedimentos (lista de códigos/descrições), necessidade_autorizacao_explicita (true/false)} e instruções de consulta.
- 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é 2.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo as regras encontradas, as referências do documento e o status da consulta.
-
Exemplo de Estrutura de Output:
{"regras_encontradas": [{"topico": "cobertura|vigencia|autorizacao|carencia|coparticipacao|rede", "resumo_regra": "...", "trecho_fonte": "...", "confianca": 0.0}], "referencias_documento": ["capitulo/pagina/section"], "consulta_sucesso": true} - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.000 caracteres.
2.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
2.3.4 Ferramentas do Agente
- Documentos: Consulta o documento Guia de Regulamentações de Seguros.
- Calculadora: Não utiliza.
- 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 deve ser visível para o Agente Analítico de Conformidade de Seguro (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente Analítico de Conformidade de Seguro (RF 3).
RF 3. Agente Analítico de Conformidade de Seguro
3.1 Tarefa do Agente
Validar o documento de seguro quanto à completude e conformidade com as regras da operadora/regulamentação aplicável para a data e local de admissão.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo a saída do Agente de Extração e do Agente de Execução de Consulta a Documento, além de metadados relevantes. # 2. Objetivo Valide o documento de seguro verificando sua completude e conformidade com as regras aplicáveis. # 3. Regras que você deve seguir para gerar sua resposta - Vigência: validade_inicio <= data_admissao <= validade_fim; se não, marcar vigencia_ok=false e adicionar motivos_invalidacao "fora_de_vigencia". - Identificação: nome_ok=true se patient_name corresponder a nome_titular ou nome_dependente com similaridade ≥ 0,90; caso contrário, pendencias_corrigiveis "comprovar_vinculo". - Número de apólice: aceitar alfanumérico 8–20 caracteres; se fora, pendencias_corrigiveis "numero_apolice_formato_suspeito". - Cobertura: se regras_encontradas indicarem exclusão do procedimento ou rede não abrangida na UF, cobertura_ok=false e motivos_invalidacao "sem_cobertura". - Autorização: se regra exigir autorização prévia, definir autorizacao_necessaria=true; se numero_autorizacao não presente nos documentos, pendencias_corrigiveis "apresentar_autorizacao" e autorizacao_apresentada=false. - Cartão do plano: se exigido frente e verso e frente_verso_cartao_presente=false, incluir pendencias_corrigiveis "frente_e_verso_cartao". - Coparticipação/carência: se regra apontar carência vigente para o procedimento na data, motivos_invalidacao "carencia_vigente"; se apenas coparticipação, não invalida, mas incluir observação em pendencias_corrigiveis "coparticipacao_informar_paciente". - Severidade: critico se vigencia_ok=false ou cobertura_ok=false; alto se autorizacao_necessaria=true e autorizacao_apresentada=false; medio para formatações/documentos complementares; baixo para divergências menores de grafia.
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: Saída do Agente de Extração para doc_type=seguro + saída do Agente de Execução de Consulta a Documento (regras_encontradas) + metadados {patient_name, data_admissao}.
- 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é 3.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON detalhando a validade do seguro, motivos de invalidação, pendências corrigíveis, campos a corrigir e nível de severidade.
-
Exemplo de Estrutura de Output:
{"seguro_valido": true, "motivos_invalidacao": ["descricao"], "pendencias_corrigiveis": ["descricao"], "campos_corrigir": ["campo"], "validacoes": {"vigencia_ok": true, "cobertura_ok": true, "autorizacao_necessaria": true, "autorizacao_apresentada": true, "nome_ok": true}, "nivel_severidade": "critico|alto|medio|baixo"} - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.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 utiliza.
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 Analítico de Autorizações e Consentimentos (RF 4).
3.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente Analítico de Autorizações e Consentimentos (RF 4).
RF 4. Agente Analítico de Autorizações e Consentimentos
4.1 Tarefa do Agente
Verificar completude e conformidade das autorizações médicas e termos de consentimento associados à admissão.
4.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo a saída do Agente de Extração para doc_type=autorizacao e doc_type=consentimento, além de metadados relevantes. # 2. Objetivo Verifique a completude e conformidade das autorizações e consentimentos, garantindo que estejam corretos e completos. # 3. Regras que você deve seguir para gerar sua resposta - Autorização médica: • Deve conter numero_autorizacao, pagadora, nome_prestador/cnpj_prestador, local_atendimento, data_emissao e validade_fim; campos ausentes vão para pendencias. • Datas: data_emissao <= data_admissao <= validade_fim; se não, problemas_identificados "autorizacao_fora_de_validade" e autorizacao_valida=false. • Procedimentos: a lista deve contemplar os procedimentos previstos; se divergirem, problemas_identificados "procedimento_nao_autorizado". • Assinatura/carimbo do prestador ou comprovante oficial (ex.: protocolo com hash) devem estar presentes; se ausentes, pendencias "validar_autenticidade_autorizacao". - Consentimento: • Deve conter escopo claro do procedimento, identificação do assinante (paciente/representante), documento_identificacao, data_assinatura; ausências viram pendencias. • Assinaturas: paciente/representante e prestador presentes; se várias páginas, paginas_inicializadas=true, senão pendencias. • Privacidade: consentimento_privacidade_LGPD=true; se falso/ausente, pendencias "coletar_consentimento_LGPD". • Clausula de revogação deve existir; se ausente, pendencias "incluir_clausula_revogacao". - Relação assinante: se assinante ≠ paciente, exigir relacao_assinante válida (ex.: responsável legal) e documento comprobatório; caso contrário, problemas_identificados "representacao_nao_comprovada". - Classificar consentimento_valido=false quando faltarem assinaturas obrigatórias, escopo inadequado ao procedimento ou data_assinatura posterior à admissão sem justificativa.
4.3 Configurações do Agente
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: Saída do Agente de Extração para doc_type=autorizacao e doc_type=consentimento + metadados {patient_name, data_admissao, procedimentos previstos}.
- 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é 3.000 caracteres.
4.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON detalhando a validade das autorizações e consentimentos, problemas identificados, pendências e checklist de conformidade.
-
Exemplo de Estrutura de Output:
{"autorizacao_valida": true, "consentimento_valido": true, "problemas_identificados": ["descricao"], "pendencias": ["descricao"], "checklist": {"assinaturas_ok": true, "dados_prestador_ok": true, "procedimentos_conferem": true, "datas_cobrem_admissao": true, "consentimento_privacidade_ok": true}} - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.500 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: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
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 deve ser visível para o Agente Consolidado de Triagem e Notificação (RF 5).
4.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente Consolidado de Triagem e Notificação (RF 5).
RF 5. Agente Consolidado de Triagem e Notificação
5.1 Tarefa do Agente
Consolidar os resultados das validações, determinar status da triagem e preparar mensagem operacional para notificar a equipe hospitalar sobre pendências críticas antes da admissão.
5.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo as saídas dos agentes de conformidade de seguro e de autorizações/consentimentos, além de metadados relevantes. # 2. Objetivo Consolide os resultados das validações, determine o status da triagem e prepare mensagem para notificação da equipe hospitalar. # 3. Regras que você deve seguir para gerar sua resposta - Definição de status: • aprovado: seguro_valido=true e autorizacao_valida=true e consentimento_valido=true. • recusado: seguro_valido=false por vigência/cobertura/carência, independentemente dos demais. • pendente: qualquer pendencia_corrigivel ou problema não crítico pendente. - Prioridade: • critico se houver itens_criticos (ex.: fora de vigência, sem cobertura, ausência de assinatura obrigatória) ou se data_admissao ≤ 24h. • alto quando faltar autorização exigida ou documento essencial legível mas incompleto. • medio/baixo conforme quantidade e impacto das pendências. - Construção de mensagem_notificacao: incluir patient_name, data_admissao, lista de pendências com ação clara (ex.: "Solicitar frente/verso do cartão"), evitar exposição de dados sensíveis além do necessário (não incluir números completos de documentos; mascarar com **** últimos 4 quando presente). - Destinatários: incluir admissao sempre; incluir faturamento quando houver questões de cobertura/autorização; incluir enfermagem apenas quando impacto operacional direto. - SLA: 12h padrão; reduzir para 4h se prioridade=critico e data_admissao ≤ 24h; aumentar para 24h se apenas ajustes formais de baixa severidade. - Ordenar recomendacoes_passo_a_passo pela sequência lógica de desbloqueio: (1) vigência/cobertura, (2) autorização, (3) assinaturas/consentimentos, (4) correções formais.
5.3 Configurações do Agente
5.3.1 Especificação do Input
- Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 4).
- Tipo do input: Saídas dos agentes de conformidade de seguro e de autorizações/consentimentos + metadados {patient_name, patient_id (se houver), data_admissao}.
- 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é 4.000 caracteres.
5.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON consolidando o status da triagem, prioridade, resumo de pendências, itens críticos e mensagem de notificação.
-
Exemplo de Estrutura de Output:
{"triage_status": "aprovado|pendente|recusado", "prioridade": "critico|alto|medio|baixo", "resumo_pendencias": ["descricao"], "itens_criticos": ["descricao"], "mensagem_notificacao": "texto conciso com paciente, pendências e ações", "destinatarios_sugeridos": ["admissao", "faturamento", "enfermagem"], "sla_horas": 12, "recomendacoes_passo_a_passo": ["acao 1", "acao 2"]} - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.000 caracteres.
5.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
5.3.4 Ferramentas do Agente
- Documentos: Não consulta documentos externos.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
5.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.
5.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. A mensagem de notificação gerada é o resultado que deve ser disponibilizado ao usuário.