Agente de IA para Análise de Segurança Assistencial

29 de November de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que revisa incidentes de segurança assistencial, classifica por gravidade e sugere intervenções preventivas.

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 para Análise de Segurança Assistencial. 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 incidentes de segurança assistencial, classificá-los por gravidade e sugerir intervenções preventivas baseadas em dados históricos do hospital.

2. Contexto e Problema

Problemas Específicos

  • Incapacidade de classificar adequadamente incidentes de segurança assistencial por gravidade.
  • Falta de intervenções preventivas eficazes baseadas em dados de incidentes passados.

O agente deve resolver esses problemas revisando e classificando incidentes com base na gravidade e impacto potencial, analisando dados históricos para identificar padrões e prevendo possíveis incidentes futuros, além de sugerir intervenções preventivas adaptadas ao contexto específico do hospital.

3. Impactos Esperados

A implementação deste agente de IA visa alcançar os seguintes resultados:

  • Melhorar a classificação de incidentes de segurança assistencial por gravidade.
  • Aumentar a eficácia das intervenções preventivas através da análise de dados históricos.
  • Reduzir a recorrência de incidentes de segurança assistencial.

4. Visão Geral da Solução

O agente de IA para análise de segurança assistencial revisa incidentes, classifica-os por gravidade, analisa padrões históricos e sugere intervenções preventivas adaptadas ao contexto do hospital. 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 análise de segurança assistencial.

A solução consiste em um fluxo de automação composto por 5 agentes de IA. O processo inicia com a extração e estruturação de incidentes e termina com a geração de um plano de intervenções preventivas.

A execução dos agentes é sequencial, seguindo a ordem definida na tabela abaixo.

Agentes Função Principal
Agente de Extração e Estruturação de Incidentes Extrair informações-chave de relatos de incidentes de segurança assistencial e estruturar em JSON normalizado.
Agente de Classificação de Gravidade e Priorização de Incidentes Revisar e classificar a gravidade e o impacto potencial dos incidentes estruturados, atribuir pontuação de risco e prioridade de tratamento.
Agente de Análise de Padrões Históricos Analisar dados históricos de incidentes para identificar padrões, tendências, pontos quentes e causas frequentes.
Agente de Predição de Risco e Alerta Prospectivo Prever tipos de incidentes mais prováveis por unidade e turno no próximo período e gerar sinais de risco com confiança.
Agente de Recomendações de Intervenções Preventivas Sugerir intervenções preventivas específicas e acionáveis alinhadas ao contexto do hospital, priorizadas por risco e viabilidade.

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 e Estruturação de Incidentes

1.1 Tarefa do Agente

Extrair informações-chave de relatos de incidentes de segurança assistencial e estruturar em JSON normalizado.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um conjunto de relatos de incidentes de segurança assistencial em formato JSON.

# 2. Objetivo
Extrair informações-chave desses relatos e estruturar em um JSON normalizado.

# 3. Regras que você deve seguir para gerar sua resposta
- Preserve a integridade dos identificadores.
- Normalize os campos obrigatórios.
- Realize inferência controlada para o campo "tipo_evento_inferido".
- Preencha a "etapa_processo" com base nas categorias definidas.
- Identifique o "ponto_deteccao" mais específico disponível.
- Liste os "fatores_contribuintes" a partir de vocabulário controlado.
- Gere uma "descricao_normalizada" objetiva e concisa.
- Garanta consistência e contagem dos incidentes processados.
- Resolva ambiguidades de forma consistente.
- Retorne um JSON válido com as chaves na ordem especificada.
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 um objeto JSON com a lista de incidentes via API. Na fase de testes, os dados serão enviados diretamente por upload na interface da Prototipe AI, para acelerar o processo de validação.
  • Tipo do input: Um objeto JSON contendo a lista de incidentes.
  • 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é 50.000 caracteres.

1.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON normalizado contendo os incidentes estruturados.
  • Exemplo de Estrutura de Output:
     {"incidentes_estruturados": [{"id":"INC-001","unidade":"UTI Adulto","data":"2025-11-28","turno":"noturno","paciente_id":"P123","tipo_evento_inferido":"medicacao","etapa_processo":"administração","ponto_deteccao":"beira-leito","fatores_contribuintes":["falha de comunicação","semelhança de embalagem"],"descricao_normalizada":"Resumo objetivo do ocorrido"}],"total_processados": 100}
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 10.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: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não se conecta a sistemas externos.

1.3.5 Memória

1.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Classificação de Gravidade e Priorização de Incidentes.

RF 2. Agente de Classificação de Gravidade e Priorização de Incidentes

2.1 Tarefa do Agente

Revisar e classificar a gravidade e o impacto potencial dos incidentes estruturados, atribuir pontuação de risco e prioridade de tratamento.

2.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um conjunto de incidentes estruturados para revisão e classificação.

# 2. Objetivo
Classificar a gravidade e o impacto potencial dos incidentes, atribuindo pontuação de risco e prioridade de tratamento.

# 3. Regras que você deve seguir para gerar sua resposta
- Determine o alcance ao paciente com base em "ponto_deteccao".
- Classifique a severidade dos incidentes usando rótulos padronizados.
- Atribua o dano resultante apropriado.
- Avalie o potencial de impacto e a probabilidade de recorrência.
- Calcule a matriz de risco e a pontuação de risco.
- Atribua prioridades de tratamento com base na pontuação de risco.
- Forneça uma justificativa clara para cada classificação.
- Garanta coerência cruzada entre os campos de saída.
- Produza um array de classificações mantendo o id original dos incidentes.
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: Um JSON contendo os incidentes estruturados para revisão e classificação.
  • 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é 10.000 caracteres.

2.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON contendo a classificação dos incidentes, com detalhes sobre gravidade, risco e prioridade.
  • Exemplo de Estrutura de Output:
     {"classificacao": [{"id":"INC-001","severidade":"Moderado","alcance_ao_paciente":"sim","dano_resultante":"prolongou internacao","potencial_de_impacto":"alto","probabilidade_recorrencia":"alta","pontuacao_risco":12,"matriz_risco":"C3","prioridade":"P1","justificativa":"racional técnico sucinto"}],"tabela_regras_aplicadas_version":"1.0"}
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 5.000 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: 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 Análise de Padrões Históricos.

2.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Análise de Padrões Históricos.

RF 3. Agente de Análise de Padrões Históricos

3.1 Tarefa do Agente

Analisar dados históricos de incidentes para identificar padrões, tendências, pontos quentes e causas frequentes.

3.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo um conjunto de classificações de incidentes para análise de padrões históricos.

# 2. Objetivo
Identificar padrões, tendências, pontos quentes e causas frequentes nos dados históricos de incidentes.

# 3. Regras que você deve seguir para gerar sua resposta
- Considere apenas registros dentro da janela de tempo especificada.
- Calcule KPIs mínimos e tendências temporais.
- Realize análise de Pareto e identifique hotspots.
- Calcule recorrências e reincidências.
- Inclua observações analíticas e limitações.
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: Um JSON contendo as classificações de incidentes para análise histórica.
  • 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é 8.000 caracteres.

3.3.2 Especificação do Output

  • Formato de output: O output deve ser um relatório em formato Markdown contendo a análise de padrões históricos.
  • Exemplo de Estrutura de Output:
     # Relatório de Padrões de Incidentes (janela: 180 dias)
    
    ## KPIs
    - Total de incidentes: 380
    - Taxa por 1.000 pacientes-dia: 3,2
    - % por severidade: ...
  • Número de caracteres esperado: O relatório gerado deve ter um tamanho estimado em 7.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: 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 de Predição de Risco e Alerta Prospectivo.

3.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Predição de Risco e Alerta Prospectivo.

RF 4. Agente de Predição de Risco e Alerta Prospectivo

4.1 Tarefa do Agente

Prever tipos de incidentes mais prováveis por unidade e turno no próximo período e gerar sinais de risco com confiança.

4.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados históricos de incidentes classificados para prever riscos futuros.

# 2. Objetivo
Prever tipos de incidentes mais prováveis por unidade e turno no próximo período e gerar sinais de risco com confiança.

# 3. Regras que você deve seguir para gerar sua resposta
- Construa grupos por unidade e turno.
- Calcule probabilidades previstas por tipo de incidente.
- Determine o sinal de risco do grupo.
- Avalie a confiança das previsões.
- Identifique fatores indicativos e inclua restrições.
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: Um JSON contendo dados históricos de incidentes classificados.
  • 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é 6.000 caracteres.

4.3.2 Especificação do Output

  • Formato de output: O output deve ser um JSON contendo previsões de risco e sinais para cada unidade e turno.
  • Exemplo de Estrutura de Output:
     {"previsoes": [{"unidade":"UTI Adulto","turno":"noturno","top_incidentes_previstos":[{"tipo":"medicacao","probabilidade":0.42},{"tipo":"comunicacao","probabilidade":0.23}],"sinal_risco":"alto","confianca":"media","fatores_indicativos":["tendência ascendente 8 semanas","picos no fechamento de mês"]}]}
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 4.000 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

4.3.6 Regras de Orquestração e Transição

Ao concluir sua execução, esse agente aciona o Agente de Recomendações de Intervenções Preventivas.

RF 5. Agente de Recomendações de Intervenções Preventivas

5.1 Tarefa do Agente

Sugerir intervenções preventivas específicas e acionáveis alinhadas ao contexto do hospital, priorizadas por risco e viabilidade.

5.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo classificações de incidentes e previsões de risco para sugerir intervenções preventivas.

# 2. Objetivo
Sugerir intervenções preventivas específicas e acionáveis, alinhadas ao contexto do hospital.

# 3. Regras que você deve seguir para gerar sua resposta
- Construa um backlog de intervenções priorizadas.
- Proponha barreiras fortes para riscos de alta prioridade.
- Estruture cada intervenção com campos obrigatórios.
- Ajuste recomendações ao contexto local e recursos disponíveis.
- Garanta traçabilidade das intervenções sugeridas.
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: Um JSON contendo classificações de incidentes e previsões de risco.
  • 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é 10.000 caracteres.

5.3.2 Especificação do Output

  • Formato de output: O output deve ser um relatório em formato Markdown contendo o plano de intervenções preventivas.
  • Exemplo de Estrutura de Output:
     # Plano de Intervenções Preventivas
    
    ## Sumário Executivo
    - Foco: Erros de medicação no noturno da UTI Adulto (risco alto)
    
    ## Intervenções Priorizadas (P1–P4)
    1. Padronização de rótulos e segregação de altas-vigilância (P1)
       - Dono: Farmácia Clínica | Prazo sugerido: 30 dias
       - Esforço: médio | Impacto esperado: alto
       - Métricas: taxa de quase erro interceptado, incidentes por 1.000 pacientes-dia
  • Número de caracteres esperado: O relatório gerado deve ter um tamanho estimado em 8.000 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 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. O relatório gerado é o resultado que deve ser disponibilizado ao usuário.

© 2025 prototipe.ai. Todos os direitos reservados.