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
- 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 de Gravidade e Priorização de Incidentes.
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
- 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 Recomendações de Intervenções Preventivas.
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.