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 "Resumo de Evolução Clínica Diária", uma solução projetada para sintetizar anotações médicas diárias em um resumo claro e conciso da evolução clínica 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 é transformar o volume excessivo de anotações médicas em resumos padronizados que facilitem a comunicação entre a equipe médica, garantindo precisão e relevância das informações.
2. Contexto e Problema
Cenário Atual
Os profissionais de saúde enfrentam um volume excessivo de anotações médicas diárias, o que sobrecarrega o processo de acompanhamento da evolução clínica dos pacientes. A dificuldade em obter uma visão clara e concisa da evolução do paciente compromete a eficiência na comunicação e na tomada de decisões clínicas.
Problemas Identificados
- Volume excessivo de anotações: A quantidade de informações diárias é alta e muitas vezes redundante, tornando difícil a análise rápida e eficiente.
- Falta de clareza: As anotações não padronizadas dificultam a extração de informações relevantes e a formação de uma visão consolidada da evolução clínica.
- Comunicação ineficiente: A ausência de resumos padronizados dificulta a comunicação entre os membros da equipe médica, afetando a continuidade do cuidado.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Reduzir o tempo de leitura e análise de anotações médicas diárias.
- Padronizar os resumos da evolução clínica para melhorar a comunicação entre a equipe médica.
- Aumentar a precisão e relevância das informações clínicas apresentadas.
4. Visão Geral da Solução
O agente de IA para resumo de evolução clínica diária processa anotações médicas diárias, extrai informações chave e gera um resumo claro e conciso da evolução do paciente. 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 síntese de informações clínicas diárias.
A solução consiste em um fluxo de automação composto por três agentes de IA. O processo inicia com a extração de texto de arquivos clínicos e termina com a geração de um resumo clínico padronizado.
A execução dos agentes é sequencial, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Execução de Extração de Texto de Arquivos Clínicos (RF 1)
| Realizar a extração de texto de arquivos de anotações médicas diárias para disponibilizar conteúdo bruto ao fluxo de normalização e síntese. |
Agente de Normalização e Estruturação de Notas Clínicas Diárias (RF 2)
| Limpar ruídos textuais, consolidar anotações do dia, e estruturar dados clínicos em JSON padronizado para consumo pelo agente de síntese. |
Agente de Síntese da Evolução Clínica Diária (RF 3)
| Processar as anotações médicas diárias estruturadas e gerar um resumo clínico claro, conciso e padronizado da evolução do paciente. |
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 cliente receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Execução de Extração de Texto de Arquivos Clínicos
1.1 Tarefa do Agente
Realizar a extração de texto de arquivos de anotações médicas diárias (PDF, imagens ou documentos) para disponibilizar conteúdo bruto ao fluxo de normalização e síntese.
1.2 Prompt ou Instruções do Agente
Esse agente é exclusivamente de execução de extração de texto a partir de arquivos recebidos. Não requer instruções para LLM, não realiza interpretação clínica, nem normalizações além da extração. Sua função é retornar o texto bruto e metadados conforme o 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 arquivos de anotações médicas diárias 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 do documento na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um arquivo de anotação médica, que será processado para extração de texto.
-
Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos:
.pdf,.jpg,.png,.heic,.docx. - 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 JSON contendo o texto bruto extraído e metadados associados.
-
Exemplo de Estrutura de Output:
{"paciente_id": "123456", "data_referencia": "2025-11-28", "fonte": "UTI A", "texto_bruto": "Texto extraído sequencial das anotações do dia, preservando conteúdo e ordem aparente, sem transformações semânticas.", "lingua_detectada": "pt-BR"} - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 1.000 caracteres.
1.3.3 Parâmetros de Geração
- Modelo: Não se aplica.
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.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Normalização e Estruturação de Notas Clínicas Diárias (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Normalização e Estruturação de Notas Clínicas Diárias (RF 2).
RF 2. Agente de Normalização e Estruturação de Notas Clínicas Diárias
2.1 Tarefa do Agente
Limpar ruídos textuais, consolidar anotações do dia, e estruturar dados clínicos em JSON padronizado para consumo pelo agente de síntese.
2.2 Prompt ou Instruções do Agente
Regra 1 (Escopo do Dia): Priorizar conteúdo referente às últimas 24h do campo data_referencia; quando houver menções antigas, ignorar ou marcar explicitamente como histórico sem incluir em arrays de dia.
Regra 2 (Limpeza de Ruído): Remover cabeçalhos/rodapés repetidos, numeração de páginas e carimbos administrativos; preservar termos clínicos, valores e unidades tal como escritos.
Regra 3 (Ordem Temporal): Identificar timestamps; ordenar itens por horário; na ausência de horário, manter ordem natural de aparição no texto.
Regra 4 (Deduplicação): Unificar registros duplicados textuais do mesmo evento/valor mantendo a versão mais completa; não deduplicar quando houver divergência relevante (neste caso, manter ambos e sinalizar no texto da nota).
Regra 5 (Padronização de Campos):
- sinais_vitais: extrair PA (formato 120/70), FC, FR, Temp (°C), SpO2 (%). Manter unidade explícita quando aplicável.
- labs: preencher {exame, valor, unidade, ref (se presente no texto), hora (se disponível)} sem interpretar.
- medicamentos: registrar apenas mudanças do dia com acao em {iniciado, ajustado, suspenso} e dose/via/intervalo conforme texto.
- procedimentos: descrever procedimento e horário quando informado.
- eventos: classificar tipo (ex.: intercorrencia, queda, uso de vasoativo, febre) e descrever literalmente.
Regra 6 (Negação e Contexto): Respeitar negações explícitas ("sem febre", "nega dor") e não transformar em eventos positivos; não inferir dados ausentes.
Regra 7 (Consistência Numérica): Para medidas fisiológicas, manter valores textuais; somente corrigir espaços e separadores decimais quando evidente, sem alterar a magnitude.
Regra 8 (Idioma): Produzir strings em pt-BR; manter nomes próprios e abreviações clínicas originais.
Regra 9 (Campos Vazios): Quando um bloco não for encontrado, devolver o array correspondente vazio; nunca inventar valores.
Regra 10 (Sem Diagnóstico): Não criar interpretações clínicas; limitar-se a estruturar o que está descrito. 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 bem-sucedida do agente anterior (RF 1).
- Tipo do input: Este agente deve ser apto a receber como input um JSON contendo o texto bruto extraído e metadados associados.
-
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é 30.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo dados clínicos estruturados e normalizados.
-
Exemplo de Estrutura de Output:
{"paciente_id": "string", "data_referencia": "YYYY-MM-DD", "notas": ["string", ...], "sinais_vitais": [{"hora": "HH:MM", "itens": {"PA": "120/70", "FC": 88, "FR": 18, "Temp": 37.2, "SpO2": 96}}], "labs": [{"exame": "Hb", "valor": 11.2, "unidade": "g/dL", "ref": "12-16", "hora": "HH:MM"}], "medicamentos": [{"nome": "Ceftriaxona", "acao": "iniciado|ajustado|suspenso", "dose": "1g 12/12h", "via": "IV"}], "procedimentos": [{"descricao": "TQT", "hora": "HH:MM"}], "eventos": [{"tipo": "intercorrencia", "descricao": "hipotensao", "hora": "HH:MM"}]} - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado 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: Não consulta.
- 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.
- Visibilidade da Resposta: A resposta (JSON estruturado) gerada por este agente deve ser visível para o Agente de Síntese da Evolução Clínica Diária (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Síntese da Evolução Clínica Diária (RF 3).
RF 3. Agente de Síntese da Evolução Clínica Diária
3.1 Tarefa do Agente
Processar as anotações médicas diárias estruturadas e gerar um resumo clínico claro, conciso e padronizado da evolução do paciente para facilitar a comunicação da equipe.
3.2 Prompt ou Instruções do Agente
Regra 1 (Processamento Diário): Sintetizar apenas o período das últimas 24h do data_referencia, reduzindo volume sem omitir conteúdo essencial que mude conduta. Regra 2 (Precisão e Relevância): Citar valores objetivos (com unidades e, quando disponível, referência) ao sustentar conclusões; evitar linguagem vaga; não repetir dados irrelevantes ou estáveis sem impacto. Regra 3 (Formato Padronizado): Seguir exatamente as seções e a ordem do expected_output; usar bullets curtos, linguagem técnica clara e foco clínico. Regra 4 (Problemas Ativos): Listar por prioridade clínica (via aérea/ventilação, circulação/hemodinâmica, neurológico, infecção/sepse, metabólico, outros). Cada problema deve ter status (melhora/piora/estável) e impacto. Regra 5 (Tendências de 24h): Descrever tendências de vitais (incluindo necessidade de O2/vasoativo, diurese/balanço se constarem nas notas) ao invés de listar todos os pontos cruamente. Regra 6 (Exames Relevantes): Selecionar exames que mudam conduta, são críticos ou marcam tendência; incluir valor, unidade, referência quando houver, e uma interpretação clínica breve e fundamentada no dado. Regra 7 (Intervenções e Resposta): Registrar intervenções (procedimentos/terapias/ajustes) e resposta observada; se a resposta não puder ser avaliada, declarar explicitamente. Regra 8 (Medicações): Consolidar apenas mudanças (iniciado/ajustado/suspenso) com dose/via/intervalo; não listar medicações inalteradas. Regra 9 (Riscos e Alertas): Evidenciar riscos agudos (sepse, insuficiência respiratória, sangramento ativo, delirium, deterioração hemodinâmica) justificando com dados objetivos quando disponíveis. Regra 10 (Pendências/Plano): Enumerar pendências objetivas (ex.: culturas em andamento, imagens pendentes, interconsultas) e próximo passo proposto; quando houver responsável/setor indicado, referenciar. Regra 11 (Consistência): Identificar incoerências claras (horários impossíveis, valores fisiológicos implausíveis) e sinalizar cautela sem criar hipóteses novas. Regra 12 (Concisão): Resumo Executivo limitado a 3–6 bullets (aprox. 200–300 palavras no máximo salvo justificativa breve pela complexidade); frases curtas. Regra 13 (Sem Inferência Indevida): Não criar diagnósticos não suportados pelas notas e dados de entrada; interpretações devem ser estritamente ancoradas no conteúdo recebido. Regra 14 (Terminologia): Usar termos clínicos padronizados em pt-BR; manter abreviações consagradas (ex.: PA, FC, FR, SpO2) quando isso aumentar clareza.
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 JSON contendo dados clínicos estruturados e normalizados.
-
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é 2.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um texto formatado em Markdown contendo o resumo clínico da evolução do paciente.
-
Exemplo de Estrutura de Output:
## Resumo de Evolução Clínica Diária - Paciente:
- Data de referência: ### Resumo Executivo (em 3–6 pontos) - - - ### Problemas Ativos (priorizados por gravidade) 1. — status atual, impacto clínico 2. ### Evolução nas Últimas 24h - Sinais/Vitais: tendências relevantes (ex.: PA, FC, FR, Temp, SpO2) - Sintomas e exame clínico: ### Exames e Resultados Relevantes - (ref: ) — interpretação clínica breve ### Intervenções/Procedimentos e Resposta - — resposta observada ### Medicamentos (iniciados/ajustados/suspensos) - — , dose/via/intervalo ### Riscos e Alertas - (ex.: deterioração hemodinâmica, sepse, delirium) ### Pendências e Plano - — responsável/sugestão de prazo - Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno 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.
- 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.
- Visibilidade da Resposta: A resposta gerada por este agente é o entregável final do fluxo e não é passada para agentes subsequentes.
3.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. O resumo gerado é o resultado que deve ser disponibilizado ao usuário.