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 "Suporte na Decisão de Alta Médica", uma solução de automação projetada para recomendar o momento ideal para a alta médica 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 é utilizar dados clínicos e históricos de pacientes para proporcionar recomendações seguras e informadas sobre o momento de alta, assegurando que todos os aspectos clínicos e sociais sejam considerados.
2. Contexto e Problema
Cenário Atual
Atualmente, o processo de decisão sobre a alta médica de pacientes enfrenta diversos desafios:
- Dificuldade em determinar o momento ideal para a alta médica dos pacientes.
- Falta de análise integrada de dados clínicos e históricos para suporte na decisão de alta.
Os profissionais de saúde muitas vezes precisam tomar decisões complexas sem o suporte adequado de dados integrados e análises preditivas, o que pode levar a decisões precipitadas ou atrasadas, impactando a qualidade do atendimento e a eficiência do sistema de saúde.
Problemas Identificados
- Decisões não informadas: A falta de integração de dados pode resultar em decisões de alta baseadas em informações incompletas.
- Risco de complicações: Altas prematuras ou atrasadas podem aumentar o risco de complicações para os pacientes.
- Uso ineficiente de recursos: Manter pacientes internados por mais tempo do que o necessário ocupa leitos que poderiam ser utilizados por outros pacientes.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Aumentar a precisão na determinação do momento ideal para alta médica.
- Reduzir o tempo de internação desnecessário, liberando leitos para novos pacientes.
- Melhorar a segurança do paciente, garantindo que as altas sejam realizadas em condições ideais.
- Fornecer suporte baseado em dados para decisões clínicas, aumentando a confiança dos profissionais de saúde.
4. Visão Geral da Solução
O agente de IA para suporte na decisão de alta médica analisa dados clínicos e históricos de pacientes para recomendar o momento ideal para a alta médica. 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 decisão de alta médica, assegurando a consideração de múltiplos fatores clínicos e sociais.
A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a normalização e validação dos dados clínicos e termina com a geração de um checklist de pré-alta, caso a alta seja recomendada.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo. O fluxo inclui etapas condicionais que são executadas apenas se critérios específicos forem atendidos, conforme detalhado após a tabela.
| Agentes | Função Principal |
|---|---|
Agente de Normalização e Validação de Dados Clínicos (RF 1)
| Validar e normalizar dados clínicos e históricos para análise de alta médica. |
Agente de Análise de Alta Médica (RF 2)
| Calcular prontidão para alta e recomendar momento ideal de alta. |
Agente de Checklist de Pré-Alta Agente Condicionado (RF 3)
| Gerar checklist de segurança antes da alta quando recomendada. |
Regras de Execução Condicional ou Edges
- Ativação do Agente de Checklist de Pré-Alta (RF 3): Este agente só será executado se o status de recomendação gerado pelo Agente de Análise de Alta Médica (RF 2) for
"alta_recomendada". Caso contrário, o fluxo pulará esta etapa.
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 Normalização e Validação de Dados Clínicos
1.1 Tarefa do Agente
Validar completude mínima e normalizar dados clínicos e históricos do paciente em um esquema canônico para análise de alta médica.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON bruto com dados clínicos e históricos do paciente. Campos esperados incluem paciente_id, idade, sexo, diagnóstico_principal, entre outros.
# 2. Objetivo
Validar a completude e normalizar os dados em um formato canônico para análise posterior.
# 3. Regras que você deve seguir para gerar sua resposta
- Verifique a presença de campos críticos e normalizar unidades de medida para o sistema SI.
- Consolidar registros de sinais vitais e exames laboratoriais em um formato estruturado com timestamp.
- Deduplicar registros e garantir a consistência dos dados.
- Derivar flags para oxigenoterapia e uso de antibióticos.
# 4. Exemplo de Output que você deve produzir
{
"schema_version": "1.0",
"paciente_id": "12345",
"demographics": {
"idade": 65,
"sexo": "Feminino"
},
"diagnostico_principal": "Pneumonia",
"comorbidades": ["Hipertensão"],
"alergias": [],
"vitais": {
"ultimo_24h": {
"pa_sistolica_mmHg": 120,
"pa_diastolica_mmHg": 80,
"fc_bpm": 70,
"fr_irpm": 18,
"temp_c": 36.8,
"spo2_pct": 95
},
"serie_72h": [
{"ts": "2025-12-14T10:00:00Z", "temp_c": 36.8, "fc_bpm": 70}
]
},
"labs": {
"por_nome": {
"glicose": {
"ultimo_24h": {"valor_SI": 5.5, "ts": "2025-12-16T09:00:00Z"},
"serie_72h": [{"ts": "2025-12-14T09:00:00Z", "valor_SI": 5.5}]
}
}
}
} 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 clínicos e históricos do paciente via API após o atendimento ser finalizado. Na fase de testes, os dados serão enviados pelo agente diretamente por upload de um arquivo JSON na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um JSON bruto com dados clínicos e históricos do paciente.
-
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é 20.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON canônico validado e normalizado, estruturado conforme o esquema especificado no prompt.
-
Exemplo de Estrutura de Output:
{ "schema_version": "1.0", "paciente_id": "12345", "demographics": { "idade": 65, "sexo": "Feminino" }, "diagnostico_principal": "Pneumonia", "comorbidades": ["Hipertensão"], "alergias": [], "vitais": { "ultimo_24h": { "pa_sistolica_mmHg": 120, "pa_diastolica_mmHg": 80, "fc_bpm": 70, "fr_irpm": 18, "temp_c": 36.8, "spo2_pct": 95 }, "serie_72h": [ {"ts": "2025-12-14T10:00:00Z", "temp_c": 36.8, "fc_bpm": 70} ] }, "labs": { "por_nome": { "glicose": { "ultimo_24h": {"valor_SI": 5.5, "ts": "2025-12-16T09:00:00Z"}, "serie_72h": [{"ts": "2025-12-14T09:00:00Z", "valor_SI": 5.5}] } } } } - Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a completude dos dados.
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: Utiliza lógica interna para normalizaçã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 devem ser visíveis para o Agente de Análise de Alta Médica (RF 2).
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Análise de Alta Médica (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Análise de Alta Médica (RF 2).
RF 2. Agente de Análise de Alta Médica
2.1 Tarefa do Agente
Calcular prontidão para alta e recomendar momento ideal de alta com justificativas objetivas, a partir do JSON canônico validado.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON canônico validado e normalizado que contém dados clínicos e históricos do paciente.
# 2. Objetivo
Calcular a prontidão para alta e recomendar o momento ideal de alta com justificativas baseadas em dados.
# 3. Regras que você deve seguir para gerar sua resposta
- Avalie a estabilidade hemodinâmica, controle de infecção, pendências críticas e critérios sociais.
- Calcule um score de prontidão e determine o nível de risco associado.
- Proporcione justificativas detalhadas para cada recomendação.
# 4. Exemplo de Output que você deve produzir
{
"status_recomendacao": "alta_recomendada",
"prontidao_score_0a100": 85,
"nivel_risco": "baixo",
"momento_ideal_de_alta": {
"tipo": "em_horas",
"valor": 24
},
"criterios_atingidos": [
{"criterio": "Estabilidade Hemodinâmica", "evidencias": [{"variavel": "fc_bpm", "valor": 70, "ts": "2025-12-16T09:00:00Z"}]}
]
} 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 canônico validado e normalizado, que corresponde aos dados clínicos e históricos do paciente.
-
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é 5.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON de recomendação, detalhando o status da recomendação, score de prontidão, nível de risco e justificativas.
-
Exemplo de Estrutura de Output:
{ "status_recomendacao": "alta_recomendada", "prontidao_score_0a100": 85, "nivel_risco": "baixo", "momento_ideal_de_alta": { "tipo": "em_horas", "valor": 24 }, "criterios_atingidos": [ {"criterio": "Estabilidade Hemodinâmica", "evidencias": [{"variavel": "fc_bpm", "valor": 70, "ts": "2025-12-16T09:00:00Z"}]} ] } - Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.500 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: Utiliza lógica interna para cálculo de scores e níveis de risco.
- 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 devem ser visíveis para o Agente de Checklist de Pré-Alta (RF 3).
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Checklist de Pré-Alta (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente avalia o status de recomendação. Se status_recomendacao for "alta_recomendada", aciona o Agente de Checklist de Pré-Alta (RF 3).
RF 3. Agente de Checklist de Pré-Alta Agente Condicionado
3.1 Tarefa do Agente
Gerar checklist objetivo de segurança e ações antes da alta quando a recomendação for 'alta_recomendada'.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um JSON de recomendação do Agente de Análise de Alta Médica e o JSON canônico normalizado.
# 2. Objetivo
Gerar um checklist com itens obrigatórios de segurança e ações necessárias antes da alta médica.
# 3. Regras que você deve seguir para gerar sua resposta
- Verifique se todos os itens obrigatórios para alta estão concluídos.
- Documente instruções claras para o paciente e orientações sobre medicações e sinais de alarme.
- Inclua necessidades de suporte e agendamento de follow-up, quando necessário.
# 4. Exemplo de Output que você deve produzir
{
"itens_obrigatorios_concluidos_bool": true,
"itens": [
{"descricao": "Prescrição de alta gerada", "status": "feito"}
],
"instrucoes_ao_paciente": ["Manter repouso"],
"orientacoes_medicacao": [
{"medicamento": "Paracetamol", "dose": "500mg", "horario": "8/8h", "alerta": "Não exceder 4g por dia"}
],
"sinais_alarme_para_retorno": ["Febre acima de 38 C"],
"necessidades_de_suporte": [
{"tipo": "Transporte para consulta", "status": "pendente"}
],
"followup": {"especialidade": "Clínica Geral", "data_sugerida_ou_confirmada": "2025-12-20"}
} 3.3 Configurações do Agente
3.3.1 Condições de Ativação
Este agente é acionado somente se a seguinte condição for atendida:
- O campo
status_recomendacaono output do Agente de Análise de Alta Médica (RF 2) é igual a "alta_recomendada".
3.3.2 Especificação do Input
- Mecanismo de Acionamento: Este agente deve ser acionado condicionalmente após a conclusão do agente anterior (RF 2), apenas se a alta for recomendada.
- Tipo do input: Este agente deve ser apto a receber dois artefatos como input: o JSON de recomendação (vindo do RF 2) e o JSON canônico normalizado (vindo do RF 1).
-
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 combinado de até 7.500 caracteres.
3.3.3 Especificação do Output
- Formato de output: O output deve ser um JSON checklist_pre_alta, detalhando os itens obrigatórios, instruções ao paciente e necessidades de suporte.
-
Exemplo de Estrutura de Output:
{ "itens_obrigatorios_concluidos_bool": true, "itens": [ {"descricao": "Prescrição de alta gerada", "status": "feito"} ], "instrucoes_ao_paciente": ["Manter repouso"], "orientacoes_medicacao": [ {"medicamento": "Paracetamol", "dose": "500mg", "horario": "8/8h", "alerta": "Não exceder 4g por dia"} ], "sinais_alarme_para_retorno": ["Febre acima de 38 C"], "necessidades_de_suporte": [ {"tipo": "Transporte para consulta", "status": "pendente"} ], "followup": {"especialidade": "Clínica Geral", "data_sugerida_ou_confirmada": "2025-12-20"} } - Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.500 caracteres.
3.3.4 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
3.3.5 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.6 Memória
- Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
- Visibilidade da Resposta: A resposta (checklist de pré-alta) é o entregável final e não é passada para outros agentes internos.
3.3.7 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. O checklist gerado é o resultado que deve ser disponibilizado ao usuário.