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 "Redação de Relatórios de Exames Laboratoriais", projetado para sintetizar dados de exames em relatórios claros e concisos para médicos e 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 é transformar dados laboratoriais brutos em relatórios de fácil compreensão para pacientes e resumos técnicos para profissionais de saúde, garantindo a confidencialidade dos dados dos pacientes.
2. Contexto e Problema
Problemas Específicos
O agente de IA para Redação de Relatórios de Exames Laboratoriais foi desenvolvido para resolver problemas específicos já conhecidos:
- Tempo excessivo gasto por médicos na compilação de relatórios laboratoriais.
- Necessidade de comunicação clara e acessível dos resultados dos exames para pacientes não especializados.
Regras para Solução dos Problemas
- Analisar dados laboratoriais brutos e extrair informações essenciais para relatórios.
- Utilizar linguagem simples e direta ao redigir relatórios destinados a pacientes.
- Fornecer resumos técnicos detalhados para profissionais de saúde com base nos dados analisados.
- Garantir a confidencialidade e segurança dos dados dos pacientes durante o processamento.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Reduzir o tempo de compilação de relatórios em pelo menos 70%.
- Melhorar a clareza e acessibilidade dos relatórios para pacientes.
- Aumentar a precisão e consistência dos resumos técnicos para profissionais de saúde.
- Assegurar a confidencialidade dos dados dos pacientes durante todo o processo.
4. Visão Geral da Solução
O agente de IA para redação de relatórios de exames laboratoriais processa dados brutos de exames, aplica regras de acordo com o contexto do paciente e prepara relatórios claros e concisos para envio direto a médicos e pacientes. 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 redação de relatórios que seguem as especificidades da sua clínica ou laboratório.
A solução consiste em um fluxo de automação composto por 5 agentes de IA. O processo inicia com a ingestão e validação dos dados laboratoriais e termina com a geração de relatórios personalizados para pacientes e profissionais de saúde.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Ingestão e Validação de Dados Laboratoriais (RF 1)
| Receber e validar dados laboratoriais brutos, padronizando estrutura e unidades. |
Agente de Enriquecimento com Intervalos de Referência (RF 2)
| Atribuir intervalos de referência aos exames considerando idade, sexo e unidade. |
Agente de Classificação e Interpretação dos Resultados (RF 3)
| Classificar exames e gerar achados principais e insights resumidos. |
Agente de Redação de Relatório para Pacientes (RF 4)
| Produzir relatório claro e acessível para pacientes. |
Agente de Redação de Resumo Técnico para Profissionais de Saúde (RF 5)
| Gerar resumo técnico conciso para rápida revisão clínica. |
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 médicos e pacientes receberão. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Ingestão e Validação de Dados Laboratoriais
1.1 Tarefa do Agente
Receber dados laboratoriais brutos, validar integridade e padronizar estrutura, unidades e metadados do paciente para uso analítico.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados laboratoriais brutos em formato JSON ou CSV, incluindo informações do paciente e resultados de exames. # 2. Objetivo Validar a integridade dos dados, padronizar a estrutura e unidades para garantir que estejam prontos para análise. # 3. Regras que você deve seguir para gerar sua resposta - Considere obrigatórios: data de coleta, data de nascimento do paciente, sexo, nome do exame, valor do exame e unidade. Se faltar, registre em campos_faltantes e prossiga apenas com o que for válido. - Normalize sexo para: M, F, Outro, NaoInformado. Datas no formato ISO 8601 (YYYY-MM-DD). - Padronize unidades para SI quando aplicável. Conversões padrão: glicose mg/dL→mmol/L ÷18; colesterol total/LDL/HDL mg/dL→mmol/L ×0,02586; triglicerideos mg/dL→mmol/L ×0,01129; creatinina mg/dL→µmol/L ×88,4; ureia mg/dL→mmol/L ×0,1665; sodio/potasio mmol/L já SI; TSH µIU/mL manter em µIU/mL; hemoglobina g/dL manter. - Remova caracteres não numéricos de valor, interpretando vírgula como separador decimal quando presente. - Se metodo não informado, defina como null; não infira método. - Historico: padronize unidades aplicando mesmas regras e ordene por data ascendente. - Observações pré-analíticas: mantenha texto e normalize flags conhecidas (ex.: hemolise_suspeita=true se string contém "hemólise"). - Não inclua identificadores sensíveis no output além de paciente.id; se nome vier no input, não replique no 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 dados laboratoriais brutos 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 arquivo na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um arquivo JSON ou CSV contendo dados laboratoriais.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos:
.json,.csv. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 50.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON padronizado contendo dados validados e estruturados prontos para análise posterior.
-
Exemplo de Estrutura de Output:
{ "paciente": {"id": "hash_ou_id", "data_nascimento": "YYYY-MM-DD", "sexo": "M|F|Outro|NaoInformado"}, "amostra": {"data_coleta": "YYYY-MM-DD", "jejum": true|false|null}, "exames_padronizados": [ {"nome_exame": "Glicose", "valor": 5.2, "unidade": "mmol/L", "unidade_original": "mg/dL", "valor_original": 94, "metodo": "enzimatico"|null } ], "historico_padronizado": [ ... ], "inconsistencias": ["mensagens"], "campos_faltantes": ["lista_de_campos"], "padronizacao": {"unidades": "SI", "regras_conversao_aplicadas": ["glicose mg/dL->mmol/L (÷18)"]} } - Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 4.000 caracteres.
1.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
1.3.4 Ferramentas do Agente
- Documentos: Não consulta documentos externos.
- Calculadora: Utiliza lógica interna para conversão de unidades.
- 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 Enriquecimento com Intervalos de Referência (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Enriquecimento com Intervalos de Referência (RF 2).
RF 2. Agente de Enriquecimento com Intervalos de Referência
2.1 Tarefa do Agente
Atribuir intervalos de referência apropriados por exame considerando idade, sexo, unidade e, quando disponível, referência do laboratório.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados laboratoriais padronizados incluindo informações do paciente, exames e histórico. # 2. Objetivo Atribuir intervalos de referência apropriados para cada exame, considerando idade, sexo, unidade e, quando disponível, referência do laboratório. # 3. Regras que você deve seguir para gerar sua resposta - Se referencia_lab_opcional existir e a unidade coincidir com a unidade padronizada, priorize-a e marque fonte_referencia="referencias_do_lab_usadas". - Se não houver referencia do lab, aplique tabela_referencias_opcional quando presente, selecionando o estrato por idade (calcular idade inteira em anos) e sexo. Se jejum=true e houver estrato específico de jejum, utilize-o. - Na ausência de qualquer tabela, aplique faixas genéricas para adultos (18–65) com unidade SI. - Garanta compatibilidade de unidades; se unidade de referência divergir, converta a referência para a unidade do resultado. - Registre por exame: ref_min, ref_max, fonte_referencia e quaisquer pressupostos (ex.: jejum assumido como null se não informado).
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 padronizado contendo dados laboratoriais validados.
-
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é 4.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo os exames enriquecidos com intervalos de referência e informações adicionais.
-
Exemplo de Estrutura de Output:
{ "exames_enriquecidos": [ {"nome_exame": "Glicose", "valor": 5.2, "unidade": "mmol/L", "ref_min": 3.9, "ref_max": 5.5, "fonte_referencia": "tabela_fornecida|generica", "contexto": {"jejum": true} } ], "flags_referencia": ["referencias_genericas_usadas"|"referencias_do_lab_usadas"], "alertas_enriquecimento": ["mensagens"] } - Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.500 caracteres.
2.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
2.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Utiliza lógica interna para cálculo de idade e compatibilidade de unidades.
- 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 de Classificação e Interpretação dos Resultados (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Classificação e Interpretação dos Resultados (RF 3).
RF 3. Agente de Classificação e Interpretação dos Resultados
3.1 Tarefa do Agente
Classificar cada exame em baixo/normal/alto/crítico, gerar achados principais e insights resumidos com base em referências e histórico.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados laboratoriais enriquecidos com intervalos de referência e informações adicionais. # 2. Objetivo Classificar cada exame e gerar achados principais e insights resumidos com base nas referências e histórico disponíveis. # 3. Regras que você deve seguir para gerar sua resposta - Classificação por exame: baixo se valor < ref_min; normal se ref_min ≤ valor ≤ ref_max; alto se valor > ref_max. - Crítico: defina critico=true se ultrapassar limiares comuns de segurança quando aplicável. - Calcule desvio_percentual e delta_historico_percentual quando aplicável. - Gere até 5 achados_relevantes ordenados por prioridade. - Registre limitações interpretativas se houver interferentes conhecidos.
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 exames enriquecidos com intervalos de referência.
-
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é 3.500 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo a classificação dos exames, achados principais e insights resumidos.
-
Exemplo de Estrutura de Output:
{ "classificacao_por_exame": [ {"nome_exame": "Glicose", "status": "normal|baixo|alto|critico", "desvio_percentual": -5.5, "delta_historico_percentual": 12.3|null, "racional": "texto curto"} ], "achados_relevantes_top": ["até 5 bullets"], "sinais_alarme": ["bullets de valores potencialmente críticos"], "limitacoes_interpretativas": ["ex.: hemólise pode falsear potássio"], "sumario_tecnico_curto": "parágrafo de 3-5 linhas" } - Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.000 caracteres.
3.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
3.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Utiliza lógica interna para cálculos percentuais e classificações.
- 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 de Redação de Relatório para Pacientes (RF 4) e o Agente de Redação de Resumo Técnico para Profissionais de Saúde (RF 5).
3.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Redação de Relatório para Pacientes (RF 4) e o Agente de Redação de Resumo Técnico para Profissionais de Saúde (RF 5).
RF 4. Agente de Redação de Relatório para Pacientes
4.1 Tarefa do Agente
Produzir relatório claro, curto e acessível para pacientes, explicando o essencial e orientando a busca por avaliação médica quando necessário.
4.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo a classificação dos exames e achados principais para redigir um relatório para pacientes. # 2. Objetivo Produzir um relatório claro e curto para pacientes, explicando o essencial e orientando a busca por avaliação médica quando necessário. # 3. Regras que você deve seguir para gerar sua resposta - Linguagem de fácil compreensão (nível leigo), frases curtas, evitar jargões; se jargão for necessário, ofereça definição simples entre parênteses. - Destaque apenas os 3–5 achados mais relevantes; valores normais extensos podem ser agrupados como "demais exames dentro do esperado". - Sempre inclua um aviso: "Este relatório não substitui avaliação médica" e orientação para procurar atendimento imediato se existir qualquer item em sinais_alarme. - Formatação objetiva com listas; evite parágrafos longos.
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: Este agente deve ser apto a receber como input um JSON contendo a classificação dos exames e achados principais.
-
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é 3.000 caracteres.
4.3.2 Especificação do Output
- Formato de output: O output deve ser um texto estruturado em seções claras e concisas para o paciente.
-
Exemplo de Estrutura de Output:
Resumo: Este relatório apresenta os resultados dos seus exames laboratoriais de forma simplificada. Principais Pontos: - Exame X: Normal - Exame Y: Alto (pode indicar necessidade de avaliação) - Exame Z: Baixo (consulte seu médico) Resultados por Exame: ... Avisos Importantes: Este relatório não substitui avaliação médica. Procure atendimento imediato se necessário.
- Número de caracteres esperado: O texto final deve ter um tamanho estimado em torno de 2.500 caracteres.
4.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
4.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- 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 é o entregável final para o paciente e não é passada para outros agentes internos.
4.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo de relatórios para pacientes.
RF 5. Agente de Redação de Resumo Técnico para Profissionais de Saúde
5.1 Tarefa do Agente
Gerar resumo técnico conciso com detalhamento suficiente para rápida revisão clínica por médicos e equipe de saúde.
5.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo a classificação dos exames e achados principais para redigir um resumo técnico para profissionais de saúde. # 2. Objetivo Gerar um resumo técnico conciso com detalhamento suficiente para rápida revisão clínica por médicos e equipe de saúde. # 3. Regras que você deve seguir para gerar sua resposta - Utilize terminologia clínica padrão e mantenha concisão; priorize informação acionável. - Inclua Δ% histórico quando disponível e referência utilizada (lab vs genérica) no rodapé ou nota. - Se algum resultado crítico foi detectado, apresente no topo do resumo técnico com destaque textual. - Aponte potenciais interferentes pré-analíticos quando aplicável. - Não prescrever tratamento; formular sugestões como "considerar repetir em x dias" ou "correlacionar clinicamente" quando pertinentes.
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 3).
- Tipo do input: Este agente deve ser apto a receber como input um JSON contendo a classificação dos exames e achados principais.
-
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é 3.000 caracteres.
5.3.2 Especificação do Output
- Formato de output: O output deve ser um texto estruturado em seções técnicas claras e concisas para profissionais de saúde.
-
Exemplo de Estrutura de Output:
Cabeçalho: Paciente: ID, Sexo, Idade, Data de Coleta, Jejum Resumo por Exame: Exame | Resultado | Unidade | Ref (min–max) | Status | Δ% Achados e Considerações: ... Notas e Limitações: ... Sugestões Orientativas: ...
- Número de caracteres esperado: O texto final deve ter um tamanho estimado em torno de 2.500 caracteres.
5.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
5.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- 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 para profissionais de saúde 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 de resumos técnicos para profissionais de saúde.