1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados, busca online, consulta a documentos e demais requisitos funcionais para o Agente de IA para Gestão de Protocolos Clínicos. 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 é garantir que a equipe médica tenha acesso a protocolos clínicos atualizados e organizados, reduzindo erros médicos e facilitando a personalização conforme as necessidades específicas de diferentes departamentos.
2. Contexto e Problema
Problemas Específicos
O agente de IA para gestão de protocolos clínicos foi criado para resolver problemas críticos, tais como:
- Manutenção e atualização constantes dos protocolos clínicos para refletir as melhores práticas e diretrizes.
- Garantia de que todos os membros da equipe médica tenham acesso fácil e rápido a protocolos atualizados.
- Redução de erros médicos causados por informações desatualizadas ou incompletas.
3. Impactos Esperados
A implementação deste agente visa alcançar os seguintes resultados:
- Atualização contínua dos protocolos clínicos com base nas melhores práticas.
- Acesso fácil e rápido para a equipe médica a informações atualizadas.
- Redução de erros médicos por meio de protocolos completos e atualizados.
- Personalização dos protocolos para atender necessidades específicas de diferentes departamentos.
4. Visão Geral da Solução
O agente de IA para gestão de protocolos clínicos organiza e atualiza protocolos garantindo que a equipe médica tenha acesso a diretrizes atualizadas e personalizáveis. 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 gestão de protocolos clínicos.
A solução é composta por cinco agentes de IA que trabalham em conjunto para garantir a atualização, organização e personalização dos protocolos clínicos.
| Agentes | Função Principal |
|---|---|
Agente de Busca Online de Atualizações de Protocolos Clínicos (RF 1)
| Realizar busca online nas fontes confiáveis para coletar novas versões, erratas e revisões de protocolos clínicos. |
Agente Analítico de Monitoramento e Triagem de Atualizações (RF 2)
| Deduplicar e qualificar os resultados coletados, comparando com versões vigentes para identificar mudanças relevantes. |
Agente de Organização e Padronização de Protocolos Clínicos (RF 3)
| Converter as atualizações aprovadas em protocolos padronizados, navegáveis e consistentes. |
Agente de Notificação de Atualizações de Protocolos (RF 4)
| Preparar e direcionar notificações para a equipe clínica, priorizando atualizações críticas. |
Agente de Personalização de Protocolos por Departamento Agente Condicionado (RF 5)
| Adaptar protocolos padronizados às necessidades locais dos departamentos. |
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 a equipe médica receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Busca Online de Atualizações de Protocolos Clínicos
1.1 Tarefa do Agente
Realizar busca online nas fontes confiáveis indicadas para coletar possíveis novas versões, erratas e revisões de protocolos clínicos.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo parâmetros de busca prontos contendo: lista_fontes (URLs e identificadores), termos_busca por tema/protocolo, data_ultima_coleta, idiomas_aceitos, limites_paginacao. # 2. Objetivo Realizar busca online nas fontes confiáveis indicadas para coletar possíveis novas versões, erratas e revisões de protocolos clínicos. # 3. Regras que você deve seguir para gerar sua resposta - Utilize os parâmetros fornecidos para realizar buscas precisas e direcionadas. - Coletar dados como fonte_id, url, titulo, data_publicacao, data_efetividade, versao_declarada, hash_conteudo, tipo_documento (guia, guideline, protocolo, errata), snippet_resumo, link_download. - Garanta que os resultados sejam relevantes e atualizados de acordo com as diretrizes mais recentes disponíveis nas fontes confiáveis. # 4. Exemplo de Output que você deve produzir Resultados brutos por fonte com campos: fonte_id, url, titulo, data_publicacao, data_efetividade, versao_declarada, hash_conteudo, tipo_documento (guia, guideline, protocolo, errata), snippet_resumo, link_download.
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 parâmetros de busca via API. Na fase de testes, o fluxo será iniciado pelo envio manual dos dados, que serão enviados para o agente diretamente por upload de um arquivo de texto na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: Parâmetros de busca estruturados em um arquivo de texto.
-
Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos:
.txt. - 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 uma lista de resultados brutos por fonte, estruturados em um arquivo JSON.
-
Exemplo de Estrutura de Output:
{ "resultados": [ { "fonte_id": "1", "url": "http://exemplo.com/protocolo1", "titulo": "Protocolo de Exemplo 1", "data_publicacao": "2025-12-01", "data_efetividade": "2025-12-15", "versao_declarada": "1.0", "hash_conteudo": "abc123", "tipo_documento": "protocolo", "snippet_resumo": "Descrição breve do protocolo", "link_download": "http://exemplo.com/download/protocolo1" } ] } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.000 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 documentos externos.
- Calculadora: Não utiliza.
- Busca Online: Utiliza busca online para coletar atualizações de protocolos.
- 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 Analítico de Monitoramento e Triagem de Atualizações (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente Analítico de Monitoramento e Triagem de Atualizações (RF 2).
RF 2. Agente Analítico de Monitoramento e Triagem de Atualizações
2.1 Tarefa do Agente
Deduplicar e qualificar os resultados coletados, comparando com versões vigentes e identificando mudanças relevantes e seu nível de criticidade.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo os resultados brutos por fonte e o registro atual de versões vigentes. # 2. Objetivo Deduplicar e qualificar os resultados coletados, comparando com versões vigentes e identificando mudanças relevantes e seu nível de criticidade. # 3. Regras que você deve seguir para gerar sua resposta - Trate como a mesma atualização documentos com mesmo hash_conteudo ou versao_declarada e datas iguais; mantenha apenas o mais recente por fonte. - Calcule criticidade baseada em mudança de campos: segurança do paciente (contraindicação nova/alterada, alerta de faixa etária/gestação) = crítica; mudança de posologia/esquema = alta; elegibilidade/fluxo = média; formatação/terminologia sem impacto clínico = baixa. - Se a fonte for órgãos reconhecidos (ex.: OMS/WHO, CDC, Ministério da Saúde, sociedades médicas nacionais), marque confiabilidade_fonte = alta; se revista indexada com peer review, média-alta; blogs/portais não oficiais, baixa. - Sempre compare versao_declarada e data_efetividade com a versão vigente; se ausentes, use inferência por data_publicacao e título. - Gere delta_mudancas estruturado com chaves: indicacao, contraindicacao, posologia, exames_previos, fluxograma, alertas_de_seguranca, populacoes_especificas, evidencias (nível/força). - Se houver errata que contradiz atualização recente, a errata prevalece e a acao_recomendada torna-se atualizar_imediato com nota de correção. - Não aprove atualizações cuja confiabilidade_fonte seja baixa; classifique como observar. # 4. Exemplo de Output que você deve produzir Lista de atualizações qualificadas com campos: protocolo_id, versao_nova, versao_atual, delta_mudancas (resumo estruturado), criticidade (critica, alta, média, baixa), impacto_previsto (seguranca_paciente, elegibilidade, posologia, fluxograma, contraindicações), confiabilidade_fonte (alta/média/baixa), acao_recomendada (atualizar_imediato, revisar_prioritaria, observar), referencias_normativas (DOI/URL), data_efetividade, data_expiracao_se_houber.
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: Resultados brutos por fonte e registro atual de versões vigentes.
-
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é 15.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser uma lista de atualizações qualificadas, estruturadas em um arquivo JSON.
-
Exemplo de Estrutura de Output:
{ "atualizacoes": [ { "protocolo_id": "123", "versao_nova": "2.0", "versao_atual": "1.0", "delta_mudancas": { "indicacao": "Nova indicação para faixa etária 60+", "contraindicacao": "Contraindicado para gestantes", "posologia": "Ajuste de dosagem para 50mg", "exames_previos": "Incluir teste de função hepática", "fluxograma": "Atualização de passos 3 e 4", "alertas_de_seguranca": "Alergia a penicilina", "populacoes_especificas": "Ajuste para IR leve", "evidencias": "Nível de evidência A" }, "criticidade": "critica", "impacto_previsto": "seguranca_paciente", "confiabilidade_fonte": "alta", "acao_recomendada": "atualizar_imediato", "referencias_normativas": "http://doi.org/10.1000/xyz123", "data_efetividade": "2025-12-15", "data_expiracao_se_houber": null } ] } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.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 documentos externos.
- Calculadora: Não utiliza.
- 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 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 Organização e Padronização de Protocolos Clínicos (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Organização e Padronização de Protocolos Clínicos (RF 3).
RF 3. Agente de Organização e Padronização de Protocolos Clínicos
3.1 Tarefa do Agente
Converter as atualizações aprovadas em protocolos padronizados, navegáveis e consistentes, com metadados clínicos completos.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo uma lista de atualizações qualificadas. # 2. Objetivo Converter as atualizações aprovadas em protocolos padronizados, navegáveis e consistentes, com metadados clínicos completos. # 3. Regras que você deve seguir para gerar sua resposta - Mantenha IDs estáveis: se protocolo_base existir, incremente versao sem alterar protocolo_id; caso novo, gere novo protocolo_id e defina versao = 1.0. - Em posologia, normalize unidades (mg/kg/dia, mg/dose, mL/h) e inclua faixas por peso/idade quando aplicável; registre intervalo mínimo e máximo seguros. - Em alertas_seguranca, liste interações críticas, ajuste por função renal/hepática (use faixas de ClCr/Child-Pugh se fornecidas nas fontes), e alergias absolutas. - Construa fluxograma_textual em passos numerados com condições if/then explícitas e critérios de progressão. - Inclua referências com tipo (guideline, RCT, meta-análise), ano, DOI/URL; se houver divergência entre fontes, priorize diretrizes nacionais vigentes e registre nota de divergência no changelog. - Preencha metadados: especialidade (ex.: infectologia), cenário (ambulatório, emergência, UTI), público (adulto/pediátrico), e tags de codificação quando fornecidas; se não houver, deixe null, nunca invente códigos. - Defina matriz de acesso com perfis mínimos (ex.: médico, enfermeiro, farmacêutico) e ações permitidas (visualizar, executar, prescrever quando aplicável). - Atualize o changelog com campos: versao_anterior, versao_nova, resumo_deltas (por seção), data, referência_fonte, motivo (segurança, evidência nova, padronização). # 4. Exemplo de Output que você deve produzir Protocolo padronizado com estrutura: cabeçalho (protocolo_id, versao, data_efetividade, fonte, confiabilidade), seções [objetivo, escopo, critérios_indicacao, criterios_exclusao, avaliações_iniciais, conduta/passo_a_passo, posologia, monitorização, alertas_seguranca, fluxograma_textual, populações_especiais (gestantes, pediatria, geriatria, IRC/IH), referências], metadados de classificação (especialidade, condição_clínica, cenário de cuidado, nível de cuidado, tags SNOMED/ICD quando disponíveis), matriz de acesso (perfis elegíveis), changelog estruturado.
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: Lista de atualizações qualificadas.
-
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é 20.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um protocolo padronizado, estruturado em um arquivo JSON.
-
Exemplo de Estrutura de Output:
{ "protocolo_id": "123", "versao": "2.0", "data_efetividade": "2025-12-15", "fonte": "OMS", "confiabilidade": "alta", "secoes": { "objetivo": "Atualizar práticas para pacientes geriátricos", "escopo": "Aplicável em ambiente hospitalar", "criterios_indicacao": "Todos os pacientes acima de 60 anos", "criterios_exclusao": "Pacientes com alergia a penicilina", "avaliacoes_iniciais": "Avaliação de função renal", "conduta/passo_a_passo": "1. Avaliar função renal... 2. Administrar 50mg de medicamento X...", "posologia": "50mg/dia", "monitorizacao": "Monitorar função renal semanalmente", "alertas_seguranca": "Alergia a penicilina, ajuste para IR leve", "fluxograma_textual": "1. Se função renal < 30, ajustar dosagem...", "populacoes_especiais": "Ajuste para IR leve", "referencias": "http://doi.org/10.1000/xyz123" }, "metadados": { "especialidade": "geriatria", "condicao_clinica": "insuficiência renal", "cenario_cuidado": "hospitalar", "nivel_cuidado": "UTI", "tags_SNOMED": "123456", "tags_ICD": "A123" }, "matriz_acesso": { "perfis_elegiveis": ["médico", "enfermeiro", "farmacêutico"], "acoes_permitidas": ["visualizar", "executar"] }, "changelog": { "versao_anterior": "1.0", "versao_nova": "2.0", "resumo_deltas": "Atualização de dosagem e inclusão de novas indicações", "data": "2025-12-15", "referencia_fonte": "OMS", "motivo": "segurança" } } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.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 se conecta a sistemas externos.
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 Notificação de Atualizações de Protocolos (RF 4).
3.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Notificação de Atualizações de Protocolos (RF 4).
RF 4. Agente de Notificação de Atualizações de Protocolos
4.1 Tarefa do Agente
Preparar e direcionar notificações para a equipe clínica, priorizando atualizações críticas e personalizando por departamento/perfil.
4.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo protocolos padronizados novos/atualizados com criticidade e matriz de acesso, além de preferências de notificação por departamento/perfil. # 2. Objetivo Preparar e direcionar notificações para a equipe clínica, priorizando atualizações críticas e personalizando por departamento/perfil. # 3. Regras que você deve seguir para gerar sua resposta - Para criticidade = crítica, definir urgencia = imediata e canal_sugerido com push/app ou SMS além de email; incluir destaque de segurança do paciente e data_efetividade. - Para criticidade alta/média, agrupar em resumo semanal; para baixa, consolidar em boletim mensal. - Segmentar publico_alvo usando especialidade, cenário de cuidado e matriz de acesso; nunca notificar perfis sem permissão de visualização. - Se houver janelas silenciosas configuradas, programe envio fora dessas janelas exceto para criticidade crítica. - Inclua links diretos para a seção impactada (ex.: posologia) e para o changelog; se alteração exigir ação (ex.: suspender medicamento), coloque CTA explícito. - Marque flag leitura_requerida = true quando criticidade ≥ alta; inclua prazo de confirmação de leitura quando indicado pelas políticas locais. # 4. Exemplo de Output que você deve produzir Lotes de notificações com payload: publico_alvo (departamento, perfis), titulo, resumo_clinico_30s, porque_importa (impacto/risco), mudanças-chave bullet, CTAs (abrir protocolo, ver changelog), criticidade, canal_sugerido (email, app, SMS, portal), urgencia (imediata, semanal), indicadores de leitura requerida.
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: Protocolos padronizados novos/atualizados com criticidade e matriz de acesso; preferências de notificação por departamento/perfil.
-
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.
4.3.2 Especificação do Output
- Formato de output: O output deve ser lotes de notificações com payload, estruturados em um arquivo JSON.
-
Exemplo de Estrutura de Output:
{ "notificacoes": [ { "publico_alvo": { "departamento": "geriatria", "perfis": ["médico", "enfermeiro"] }, "titulo": "Atualização Crítica de Protocolo", "resumo_clinico_30s": "Nova dosagem para pacientes geriátricos", "porque_importa": "Risco elevado de reação adversa", "mudancas-chave": ["Ajuste de dosagem", "Inclusão de novas indicações"], "CTAs": ["abrir protocolo", "ver changelog"], "criticidade": "critica", "canal_sugerido": "email, app", "urgencia": "imediata", "indicadores_leitura_requerida": true } ] } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.500 caracteres.
4.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
4.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.
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 Personalização de Protocolos por Departamento (RF 5).
4.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Personalização de Protocolos por Departamento (RF 5).
RF 5. Agente de Personalização de Protocolos por Departamento Agente Condicionado
5.1 Tarefa do Agente
Adaptar protocolos padronizados às necessidades locais dos departamentos, mantendo conformidade regulatória e consistência técnica.
5.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um protocolo padronizado e políticas locais. # 2. Objetivo Adaptar protocolos padronizados às necessidades locais dos departamentos, mantendo conformidade regulatória e consistência técnica. # 3. Regras que você deve seguir para gerar sua resposta - Nunca altere recomendações de segurança de alto nível do protocolo base; personalize apenas camadas operacionais (fluxo, disponibilidade, responsabilidades) e substituições terapêuticas equivalentes justificadas. - Para substituições de fármacos, exija equivalência terapêutica (mesma classe/efeito, dose equipotente); registre justificativa e fonte de equivalência. - Se recurso/equipamento do protocolo base não existir localmente, proponha caminho alternativo aprovado (ex.: referenciar serviço) e sinalize no anexo local. - Mantenha vínculo: personalize com campo parent_protocolo_id e herde versao_base; incremente versao_local separadamente. - Valide compatibilidade com políticas e regulamentações locais; se houver conflito, crie nota de conformidade com a regra aplicável e ajuste operacional. - Gere lista de diferenças entre base e local (diff_local) por seção; inclua impacto_clínico previsto (nenhum, baixo, moderado). # 4. Exemplo de Output que você deve produzir Protocolo personalizado por departamento com anexos locais: ajustes de fluxos, substituições de fármacos por formulário, checkpoints de segurança, responsabilidades de equipe, limites operacionais, mantendo referência ao protocolo base.
5.3 Configurações do Agente
5.3.1 Condições de Ativação
Este agente é acionado somente se a seguinte condição for atendida:
- O campo
departamento_requer_personalizacaofor igual a "true".
5.3.2 Especificação do Input
- Mecanismo de Acionamento: Este agente deve ser acionado condicionalmente após a conclusão do agente anterior (RF 4).
- Tipo do input: Protocolo padronizado e políticas locais.
-
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é 12.000 caracteres.
5.3.3 Especificação do Output
- Formato de output: O output deve ser um protocolo personalizado por departamento, estruturado em um arquivo JSON.
-
Exemplo de Estrutura de Output:
{ "protocolo_id": "123", "parent_protocolo_id": "123", "versao_base": "2.0", "versao_local": "2.1", "anexos_locais": { "ajustes_fluxos": "Ajuste no passo 3 para incluir avaliação local", "substituicoes_farmacos": "Substituir medicamento X por Y equivalente", "checkpoints_seguranca": "Revisão semanal de função renal", "responsabilidades_equipe": "Enfermeiros responsáveis por monitoramento", "limites_operacionais": "Uso restrito a pacientes internados" }, "diff_local": { "fluxos": "Ajuste no passo 3", "farmacos": "Substituição de X por Y", "impacto_clinico_previsto": "baixo" } } - Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 4.000 caracteres.
5.3.4 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.6
5.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.
5.3.6 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 resultado final e não é passada para outros agentes internos.
5.3.7 Regras de Orquestração e Transição
A execução deste agente pode ser repetida para diferentes departamentos conforme necessário.