Agente de IA para Gerenciamento de Protocolos de Cuidados

13 de December de 2025 • Tempo de leitura: 5 min

Como criar um agente de IA que auxilia na atualização e monitoramento da adesão a protocolos de cuidados clínicos.

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 Gerenciamento de Protocolos de Cuidados. 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 é atualizar e monitorar a adesão a protocolos de cuidados clínicos em pacientes internados, garantindo a conformidade e eficácia dos cuidados prestados.

2. Contexto e Problema

Os hospitais enfrentam desafios significativos na manutenção e atualização dos protocolos de cuidados clínicos, que são essenciais para garantir a qualidade e segurança dos cuidados prestados aos pacientes. Problemas específicos incluem:

  • Dificuldade na atualização constante dos protocolos de cuidados clínicos.
  • Falta de monitoramento contínuo da adesão aos protocolos estabelecidos.
  • Necessidade de garantir a conformidade e eficácia dos cuidados prestados.

3. Impactos Esperados

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

  • Automatizar a atualização dos protocolos de cuidados com base nas diretrizes mais recentes.
  • Monitorar a adesão dos profissionais de saúde aos protocolos, emitindo alertas em caso de não conformidade.
  • Fornecer relatórios analíticos sobre a eficácia dos protocolos e sugerir melhorias contínuas.

4. Visão Geral da Solução

O agente de IA para gerenciamento de protocolos de cuidados atualiza automaticamente os protocolos com base nas diretrizes mais recentes, monitora a adesão dos profissionais e fornece relatórios analíticos. 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 eficaz e autônomo no gerenciamento de protocolos de cuidados.

A solução consiste em um fluxo de automação composto por 6 agentes de IA. O processo inicia com a busca e atualização das diretrizes clínicas e termina com a geração de relatórios analíticos sobre a eficácia dos protocolos.

Agentes Função Principal
Agente de Busca Online de Diretrizes Clínicas (RF 1) Localizar e recuperar diretrizes clínicas oficiais e atualizadas.
Agente de Execução de Consulta a Documento (RF 2) Recuperar a versão vigente dos protocolos institucionais.
Agente Analítico de Harmonização e Atualização de Protocolos (RF 3) Comparar diretrizes externas com protocolos internos e propor atualizações.
Agente de Execução de Consultas em Banco de Dados (RF 4) Obter dados brutos de adesão aos protocolos.
Agente de Monitoramento de Adesão e Geração de Alertas (RF 5) Calcular a adesão e emitir alertas de não conformidade.
Agente de Relatório Analítico de Protocolos (RF 6) Gerar relatório analítico sobre a eficácia dos protocolos.

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 Busca Online de Diretrizes Clínicas

1.1 Tarefa do Agente

Localizar e recuperar diretrizes clínicas oficiais e atualizadas para os temas/protocolos informados.

1.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo parâmetros de busca para localizar diretrizes clínicas.

# 2. Objetivo
Localizar e recuperar diretrizes clínicas oficiais e atualizadas para os temas/protocolos informados, com metadados suficientes para avaliação de qualidade e escopo.

# 3. Regras que você deve seguir para gerar sua resposta
- Priorize fontes institucionais e sociedades reconhecidas (ex.: OMS/WHO, CDC, NIH, Ministério da Saúde, CONITEC, sociedades de especialidade nacionais e internacionais).
- Aceite apenas documentos publicados dentro da janela de anos de recência especificada; se vazio, use padrão de 5 anos.
- Exclua documentos cujo escopo não corresponda aos requisitos (ex.: excluir pediatria quando solicitado adulto).
- Deduplicate por (organização emissora + título aproximado + ano/versão). Prefira a versão mais recente quando múltiplas versões forem identificadas.
- Capture sempre a URL oficial primária (não repositórios espelhados).
- Se o documento declarar níveis de evidência ou forças de recomendação, registre exatamente como publicado.
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 por uma atualização programada semanalmente. Na fase de testes, o fluxo será iniciado pelo envio manual dos parâmetros de busca diretamente na interface da Prototipe AI, para acelerar o processo de validação.
  • Tipo do input: JSON com parâmetros de busca.
  • Formatos Suportados: .json
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 10.000 caracteres.

1.3.2 Especificação do Output

  • Formato de output: JSON lista_diretrizes com diretrizes recuperadas.
  • Exemplo de Estrutura de Output:
     {
      "lista_diretrizes": [
        {
          "titulo": "Diretriz de Tratamento de Diabetes",
          "organizacao_emissora": "OMS",
          "ano_publicacao": 2023,
          "url_oficial": "https://www.who.int/diabetes-guidelines"
        }
      ]
    } 
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 2.000 caracteres.

1.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

1.3.4 Ferramentas do Agente

  • Documentos: Consulta diretrizes online.
  • Calculadora: Não utiliza.
  • Busca Online: Utiliza para localizar diretrizes.
  • Sistemas Externos: Não utiliza.

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 Execução de Consulta a Documento (RF 2).

RF 2. Agente de Execução de Consulta a Documento

2.1 Tarefa do Agente

Realizar consulta ao repositório interno para recuperar a versão vigente dos protocolos institucionais relacionados aos temas solicitados.

2.2 Prompt ou Instruções do Agente
 Este agente não precisa de instruções para LLM. Sua única função é executar a consulta ao documento via parâmetros recebidos e retornar o conteúdo recuperado. 
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: Parâmetros prontos para consulta.
  • Formatos Suportados: .json
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 5.000 caracteres.

2.3.2 Especificação do Output

  • Formato de output: JSON protocolos_vigentes com protocolos recuperados.
  • Exemplo de Estrutura de Output:
     {
      "protocolos_vigentes": [
        {
          "id_protocolo": "123",
          "titulo": "Protocolo de Cuidados com Diabetes",
          "versao": "1.0",
          "data_validacao": "2025-01-01"
        }
      ]
    } 
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 2.500 caracteres.

2.3.3 Parâmetros de Geração

  • Modelo: Não se aplica (não utiliza LLM)
  • Temperatura: Não se aplica

2.3.4 Ferramentas do Agente

  • Documentos: Consulta repositório interno.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Conecta-se ao repositório interno de documentos.

2.3.5 Memória

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

Ao concluir sua execução, esse agente aciona o Agente Analítico de Harmonização e Atualização de Protocolos (RF 3).

RF 3. Agente Analítico de Harmonização e Atualização de Protocolos

3.1 Tarefa do Agente

Comparar diretrizes externas recuperadas com os protocolos internos vigentes, propor atualização consolidada e registrar matriz de mudanças com justificativas.

3.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo diretrizes externas e protocolos internos para comparação e harmonização.

# 2. Objetivo
Comparar diretrizes externas recuperadas com os protocolos internos vigentes, propor atualização consolidada e registrar matriz de mudanças com justificativas.

# 3. Regras que você deve seguir para gerar sua resposta
- Estruture o protocolo na ordem definida em padrao_estrutura_protocolo.
- Priorize diretrizes nacionais/regulatórias vigentes.
- Respeite restrições institucionais.
- Padronize doses com unidades SI.
- Diferencie recomendações por população.
- Para cada mudança, classifique impacto_clinico e necessidade_treinamento.
- Versionamento: incremente versao_sugerida conforme necessário.
- Defina sugestao_data_revisao em 12 meses por padrão.
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: JSON com diretrizes externas e protocolos internos.
  • Formatos Suportados: .json
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 15.000 caracteres.

3.3.2 Especificação do Output

  • Formato de output: JSON com protocolo atualizado e matriz de mudanças.
  • Exemplo de Estrutura de Output:
     {
      "protocolo_atualizado": {
        "titulo": "Protocolo de Cuidados com Diabetes Atualizado",
        "versao_sugerida": "1.1"
      },
      "matriz_mudancas": [
        {
          "tipo_mudanca": "inclusao",
          "secao": "condutas",
          "descricao_mudanca": "Adição de nova medicação",
          "justificativa": "Baseado na diretriz OMS 2023"
        }
      ]
    } 
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 4.000 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 documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não utiliza.

3.3.5 Memória

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

Ao concluir sua execução, esse agente aciona o Agente de Execução de Consultas em Banco de Dados (RF 4).

RF 4. Agente de Execução de Consultas em Banco de Dados

4.1 Tarefa do Agente

Realizar conexão com o sistema assistencial para obter dados brutos de adesão aos protocolos.

4.2 Prompt ou Instruções do Agente
 Este agente não precisa de instruções para LLM. Sua única função é executar a consulta ao banco de dados com parâmetros recebidos e retornar os dados. 
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: Parâmetros prontos para consulta em banco de dados.
  • Formatos Suportados: .json
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 8.000 caracteres.

4.3.2 Especificação do Output

  • Formato de output: JSON dados_adesao_brutos com dados de adesão recuperados.
  • Exemplo de Estrutura de Output:
     {
      "dados_adesao_brutos": [
        {
          "id_paciente": "001",
          "episodio": "E123",
          "unidade": "Cardiologia",
          "timestamp_evento": "2025-12-12T09:00:00Z"
        }
      ]
    } 
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 3.500 caracteres.

4.3.3 Parâmetros de Geração

  • Modelo: Não se aplica (não utiliza LLM)
  • Temperatura: Não se aplica

4.3.4 Ferramentas do Agente

  • Documentos: Não consulta documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Conecta-se ao sistema assistencial para consulta de dados.

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 Monitoramento de Adesão e Geração de Alertas (RF 5).

RF 5. Agente de Monitoramento de Adesão e Geração de Alertas

5.1 Tarefa do Agente

Calcular a adesão por indicador e emitir alertas de não conformidade conforme regras e limiares definidos.

5.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de adesão e definições de indicadores para cálculo e geração de alertas.

# 2. Objetivo
Calcular a adesão por indicador e emitir alertas de não conformidade conforme regras e limiares definidos, além de produzir visão operacional agregada.

# 3. Regras que você deve seguir para gerar sua resposta
- Calcule adesão = numerador/denominador considerando exclusões antes do cálculo.
- Não gere alerta se denominador < minimo_denominador.
- Aplique grace_period_min para eventos com janela temporal.
- Limiar padrão de adesão = 90%.
- Classifique severidade: alto, médio, baixo conforme adesão observada.
- Implemente supressão de repetição.
- Inclua recomendação de ação imediata e prazo_sla_horas conforme severidade.
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: JSON com dados de adesão e definições de indicadores.
  • Formatos Suportados: .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: JSON com alertas de não conformidade e visão operacional.
  • Exemplo de Estrutura de Output:
     {
      "alertas": [
        {
          "indicador": "Uso de EPI",
          "unidade": "UTI",
          "severidade": "alto",
          "adesao_observada": "85%"
        }
      ]
    } 
  • Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 3.000 caracteres.

5.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

5.3.4 Ferramentas do Agente

  • Documentos: Não consulta documentos externos.
  • Calculadora: Utiliza lógica interna para cálculo de adesão.
  • 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 deve ser visível para o Agente de Relatório Analítico de Protocolos (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Relatório Analítico de Protocolos (RF 6).

RF 6. Agente de Relatório Analítico de Protocolos

6.1 Tarefa do Agente

Gerar relatório analítico periódico sobre eficácia dos protocolos, relacionando adesão com desfechos e recomendando melhorias.

6.2 Prompt ou Instruções do Agente
 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo visão operacional e dados de desfechos clínicos para gerar relatório analítico.

# 2. Objetivo
Gerar relatório analítico periódico sobre eficácia dos protocolos, relacionando adesão com desfechos e recomendando melhorias.

# 3. Regras que você deve seguir para gerar sua resposta
- Compare períodos pre_pos utilizando a data de vigência da última versão do protocolo como ponto de corte.
- Sinalize indicadores com tendência de piora.
- Relacione adesão com desfechos quando houver compatibilidade temporal.
- Produza recomendações priorizadas por matriz impacto x esforço.
- Inclua anexo metodológico.
- Se a cobertura de dados < 85%, aponte limitação.
6.3 Configurações do Agente

6.3.1 Especificação do Input

  • Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 5).
  • Tipo do input: JSON com visão operacional e dados de desfechos clínicos.
  • Formatos Suportados: .json
  • Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 12.000 caracteres.

6.3.2 Especificação do Output

  • Formato de output: Relatório em markdown estruturado + JSON metrificado.
  • Exemplo de Estrutura de Output:
     {
      "sumario_executivo": "Relatório de Análise de Protocolos",
      "destaques": "Melhoras observadas em adesão ao protocolo de diabetes",
      "analises_segmentadas": "Adesão por unidade e turno"
    } 
  • Número de caracteres esperado: O relatório gerado deve ter um tamanho estimado em 5.000 caracteres.

6.3.3 Parâmetros de Geração

  • Modelo: GPT-5
  • Temperatura: 0.6

6.3.4 Ferramentas do Agente

  • Documentos: Não consulta documentos externos.
  • Calculadora: Não utiliza.
  • Busca Online: Não utiliza.
  • Sistemas Externos: Não utiliza.

6.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.

6.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.