1. Propósito e Escopo
Este documento define todos os prompts e detalhes de requisitos para um requisitos para o Fluxo de Agentes "Avaliação de Risco de Quedas em Pacientes", uma solução de automação projetada para avaliar o risco de quedas de pacientes internados. 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 input de dados clínicos e comportamentais em uma avaliação detalhada do risco de quedas, sugerindo intervenções preventivas e alertando a equipe de enfermagem quando necessário.
2. Contexto e Problema
Cenário Atual
Em ambientes hospitalares, quedas de pacientes internados são um problema recorrente que pode resultar em lesões adicionais e complicações. Atualmente, a avaliação de risco de quedas não é contínua ou dinâmica, o que leva a intervenções preventivas inadequadas ou tardias.
Problemas Identificados
- Quedas frequentes: Pacientes internados frequentemente sofrem quedas, resultando em lesões adicionais.
- Avaliação de risco inconsistente: A falta de avaliação contínua e dinâmica do risco de quedas leva a intervenções inadequadas.
- Intervenções preventivas inadequadas: As intervenções preventivas são frequentemente inadequadas ou tardias devido à avaliação de risco ineficiente.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Reduzir o número de quedas de pacientes internados através de uma avaliação contínua e dinâmica.
- Melhorar a qualidade das intervenções preventivas com base em avaliações de risco precisas e oportunas.
- Aumentar a segurança dos pacientes ao alertar proativamente a equipe de enfermagem sobre riscos elevados.
4. Visão Geral da Solução
O agente de IA para avaliação de risco de quedas em pacientes analisa dados clínicos e comportamentais em tempo real para determinar o risco de quedas e sugere intervenções preventivas. 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 prevenção de quedas em pacientes internados.
A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a análise contínua dos dados do paciente e termina com a geração de alertas para a equipe de enfermagem.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Avaliação de Risco de Quedas (RF 1)
| Calcular continuamente o risco de quedas de pacientes internados a partir de dados clínicos e comportamentais. |
Agente de Sugestão de Intervenções Preventivas (RF 2)
| Gerar plano personalizado e priorizado de intervenções preventivas de quedas. |
Agente de Geração de Alertas para Enfermagem (RF 3)
| Criar alerta estruturado e priorizado para a equipe de enfermagem quando pacientes forem classificados com alto risco de queda. |
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 Avaliação de Risco de Quedas
1.1 Tarefa do Agente
Calcular continuamente o risco de quedas de pacientes internados a partir de dados clínicos e comportamentais, gerando escore, nível de risco e explicações dos fatores contribuintes.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um objeto JSON com dados clínicos e comportamentais de pacientes internados. Este objeto contém informações detalhadas sobre o estado de saúde e comportamento dos pacientes.
# 2. Objetivo
Calcular continuamente o risco de quedas de pacientes internados, gerando um escore de risco, nível de risco e explicações dos fatores contribuintes.
# 3. Regras que você deve seguir para gerar sua resposta
- Analise continuamente os dados clínicos e comportamentais dos pacientes para avaliar o risco de quedas.
- Sugerir intervenções preventivas com base na avaliação de risco.
- Alertar a equipe de enfermagem sobre pacientes em alto risco de quedas.
# 4. Exemplo de Output que você deve produzir
{
"paciente_id": "string",
"timestamp_avaliacao": "YYYY-MM-DDTHH:MM:SSZ",
"escore_risco": 0-100,
"nivel_risco": "baixo|moderado|alto",
"risco_alto": true|false,
"principais_contribuintes": [{"fator": "string", "impacto": "+N"}],
"sinais_de_alerta": ["string"],
"racional_clinico": "Texto curto explicando por que o risco está neste nível e quais dados faltam, se houver",
"campos_para_intervencoes": {
"necessita_sala_segura": true|false,
"necessita_ajuda_deambular": true|false,
"revisao_medicacoes": ["string"],
"ajustes_ambiente": ["string"]
}
} 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 comportamentais do paciente via API em tempo próximo do real. Na fase de testes, os dados serão enviados pelo agente diretamente por upload de um JSON na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um objeto JSON com dados clínicos e comportamentais 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é 10.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um objeto JSON contendo o escore de risco, nível de risco, fatores contribuintes e sugestões de intervenções.
-
Exemplo de Estrutura de Output:
{ "paciente_id": "12345", "timestamp_avaliacao": "2025-12-01T07:45:00Z", "escore_risco": 85, "nivel_risco": "alto", "risco_alto": true, "principais_contribuintes": [{"fator": "delirium ativo", "impacto": "+25"}], "sinais_de_alerta": ["delirium ativo", "queda <24h"], "racional_clinico": "O risco é alto devido ao delirium ativo e queda recente. Dados ausentes: ortostatismo, Na.", "campos_para_intervencoes": { "necessita_sala_segura": true, "necessita_ajuda_deambular": true, "revisao_medicacoes": ["benzodiazepínico"], "ajustes_ambiente": ["iluminação", "cabos"] } } - Número de caracteres esperado: O JSON de output 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.
- Calculadora: Utiliza lógica interna para calcular o escore de risco.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
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 Sugestão de Intervenções Preventivas (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Sugestão de Intervenções Preventivas (RF 2).
RF 2. Agente de Sugestão de Intervenções Preventivas
2.1 Tarefa do Agente
Gerar plano personalizado e priorizado de intervenções preventivas de quedas com base no nível de risco e fatores contribuintes do paciente.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um objeto JSON com a avaliação de risco de quedas e fatores contribuintes de um paciente internado.
# 2. Objetivo
Gerar um plano personalizado e priorizado de intervenções preventivas de quedas com base nos dados recebidos.
# 3. Regras que você deve seguir para gerar sua resposta
- Proporcione intervenções preventivas que sejam acionáveis, com responsável e janela temporal definidos.
- Ordene o plano de intervenções por prioridade e, dentro da mesma prioridade, pelos maiores contribuintes do agente anterior.
# 4. Exemplo de Output que você deve produzir
{
"paciente_id": "12345",
"nivel_risco": "alto",
"plano_intervencoes": [
{
"id": "INT-DEL-01",
"descricao": "Plano não farmacológico para delirium",
"justificativa": "Delirium ativo identificado",
"prioridade": "alta",
"quando_executar": "imediato",
"responsavel_sugerido": "Enfermagem/Terapia Ocupacional",
"itens_checklist": ["reorientação horária", "estímulos diurnos"],
"reavaliacao_em_horas": 12,
"prazo_sugerido_horas": null
}
],
"educacao_paciente_familiar": ["Importância da adesão às intervenções"],
"metas_proximas_24h": ["Reduzir episódios de delirium"],
"criterios_de_alta_do_plano": ["24h sem delirium"]
} 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 com a avaliação de risco de quedas 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 objeto JSON contendo o plano de intervenções preventivas, educação para o paciente e metas.
-
Exemplo de Estrutura de Output:
{ "paciente_id": "12345", "nivel_risco": "alto", "plano_intervencoes": [ { "id": "INT-DEL-01", "descricao": "Plano não farmacológico para delirium", "justificativa": "Delirium ativo identificado", "prioridade": "alta", "quando_executar": "imediato", "responsavel_sugerido": "Enfermagem/Terapia Ocupacional", "itens_checklist": ["reorientação horária", "estímulos diurnos"], "reavaliacao_em_horas": 12, "prazo_sugerido_horas": null } ], "educacao_paciente_familiar": ["Importância da adesão às intervenções"], "metas_proximas_24h": ["Reduzir episódios de delirium"], "criterios_de_alta_do_plano": ["24h sem delirium"] } - Número de caracteres esperado: O JSON de output 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 subsequente.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Geração de Alertas para Enfermagem (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 Alertas para Enfermagem (RF 3).
RF 3. Agente de Geração de Alertas para Enfermagem
3.1 Tarefa do Agente
Criar alerta estruturado e priorizado para a equipe de enfermagem quando pacientes forem classificados com alto risco de queda, incluindo mensagem, prioridade e parâmetros de acompanhamento.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um objeto JSON com a avaliação de risco de quedas e o plano de intervenções de um paciente internado.
# 2. Objetivo
Criar um alerta estruturado e priorizado para a equipe de enfermagem quando pacientes forem classificados com alto risco de queda.
# 3. Regras que você deve seguir para gerar sua resposta
- Emitir alerta apenas quando risco_alto = true OU quando houver gatilho crítico (delirium + sedativo, queda <24h, ortostatismo sintomático).
- Determinar a prioridade do alerta com base no escore e fatores críticos identificados.
- Criar uma mensagem clara e concisa, incluindo os principais fatores de risco e a ação imediata sugerida.
# 4. Exemplo de Output que você deve produzir
{
"paciente_id": "12345",
"prioridade_alerta": "crítico",
"canal_sugerido": "painel_enfermagem",
"mensagem": "Paciente em RISCO ALTO de queda (escore 85). Principais fatores: delirium ativo, queda <24h. Ação imediata: Plano não farmacológico para delirium.",
"recomendacoes_chave": ["Monitorar paciente a cada hora"],
"destinatarios": ["posto-enfermagem-geral"],
"prazo_resposta_minutos": 15,
"persistencia_reenvio": {"intervalo_minutos": 20, "max_tentativas": 3},
"deduplicacao_janela_minutos": 60,
"cancelar_alerta_condicao": "Redução para risco moderado/baixo",
"registros_auditoria": {"gerado_em": "2025-12-01T07:45:00Z", "gerado_por_agente": "Agente de Geração de Alertas para Enfermagem"}
} 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 objeto JSON com a avaliação de risco de quedas e o plano de intervenções 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.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um objeto JSON contendo o alerta estruturado com mensagem, prioridade e parâmetros de acompanhamento.
-
Exemplo de Estrutura de Output:
{ "paciente_id": "12345", "prioridade_alerta": "crítico", "canal_sugerido": "painel_enfermagem", "mensagem": "Paciente em RISCO ALTO de queda (escore 85). Principais fatores: delirium ativo, queda <24h. Ação imediata: Plano não farmacológico para delirium.", "recomendacoes_chave": ["Monitorar paciente a cada hora"], "destinatarios": ["posto-enfermagem-geral"], "prazo_resposta_minutos": 15, "persistencia_reenvio": {"intervalo_minutos": 20, "max_tentativas": 3}, "deduplicacao_janela_minutos": 60, "cancelar_alerta_condicao": "Redução para risco moderado/baixo", "registros_auditoria": {"gerado_em": "2025-12-01T07:45:00Z", "gerado_por_agente": "Agente de Geração de Alertas para Enfermagem"} } - Número de caracteres esperado: O JSON de output 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.
- 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 não são visíveis para agentes subsequentes.
- Visibilidade da Resposta: A resposta gerada por este agente 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, e o alerta gerado deve ser enviado para o sistema institucional de chamados/alertas clínicos conforme configurado manualmente.