1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados, ferramentas como chamadas a sistemas externos, consulta a documentos e demais requisitos funcionais para o Agente de IA para Suporte na Prescrição Médica. 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 é auxiliar médicos na escolha de prescrições, verificando interações medicamentosas e sugerindo alternativas seguras, integrando-se com sistemas de prescrição eletrônica para atualização contínua.
2. Contexto e Problema
No cenário atual, médicos enfrentam desafios significativos no que diz respeito à segurança e eficácia das prescrições médicas. Problemas como interações medicamentosas indesejadas podem levar a sérias complicações de saúde para os pacientes. Além disso, a escolha de medicamentos mais seguros é uma tarefa complexa que requer análise detalhada do histórico do paciente e consulta a diretrizes médicas atualizadas.
- Reduzir erros de prescrição médica causados por interações medicamentosas.
- Auxiliar médicos na escolha de medicamentos mais seguros para os pacientes.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Reduzir em até 90% os casos de interações medicamentosas indesejadas, melhorando a segurança do paciente.
- Aumentar a precisão na escolha de medicamentos, garantindo que as prescrições sejam baseadas nas melhores práticas e diretrizes médicas.
- Integrar e automatizar o processo de verificação de prescrições, minimizando a carga de trabalho manual dos médicos e permitindo que se concentrem mais no atendimento ao paciente.
4. Visão Geral da Solução
O agente de IA para suporte na prescrição médica analisa prescrições em tempo real, verifica interações medicamentosas e sugere alternativas seguras, integrando-se com sistemas de prescrição eletrônica. 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 escolha de prescrições médicas seguras.
A solução consiste em um fluxo de automação composto por 2 agentes de IA. O processo inicia com a análise das prescrições médicas e termina com a sugestão de alternativas seguras quando necessário.
A execução dos agentes é sequencial, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Verificação de Interações Medicamentosas (RF 1)
| Analisar prescrições médicas para verificar interações medicamentosas. |
Agente de Sugestão de Alternativas Seguras (RF 2)
| Sugerir alternativas seguras com base no histórico do paciente e diretrizes médicas. |
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 médico receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Verificação de Interações Medicamentosas
1.1 Tarefa do Agente
Analisar prescrições médicas para verificar interações medicamentosas.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo prescrições médicas em texto para análise. O objetivo é identificar interações medicamentosas potenciais.
# 2. Objetivo
Analisar as prescrições para verificar interações medicamentosas utilizando uma base de dados confiável e classificar as interações encontradas.
# 3. Regras que você deve seguir para gerar sua resposta
- Analise todas as combinações de medicamentos listados na prescrição para identificar possíveis interações.
- Consulte uma base de dados confiável de interações medicamentosas para cada combinação identificada.
- Classifique as interações encontradas em categorias de risco: 'crítica', 'moderada' ou 'leve'.
- Em caso de interação crítica, envie um alerta imediato para revisão humana.
# 4. Exemplo de Output que você deve produzir
{
"interacoes_detectadas": ["Medicamento A e Medicamento B"],
"status": "interacao_critica"
} 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 prescrições médicas em texto via API. Na fase de testes, o fluxo será iniciado pelo envio manual das prescrições, que serão enviadas para o agente diretamente por upload na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo são prescrições médicas em texto.
-
Formatos Suportados: Esse agente deve ser capaz de receber prescrições nos formatos:
.txt,.docx,.pdf. - 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 JSON contendo as interações medicamentosas detectadas e o status de risco.
-
Exemplo de Estrutura de Output:
{ "interacoes_detectadas": ["Medicamento A e Medicamento B"], "status": "interacao_critica" } - Número de caracteres esperado: O JSON gerado deve ser conciso, com um tamanho estimado em torno de 500 caracteres.
1.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
1.3.4 Ferramentas do Agente
- Documentos: Consulta a base de dados de interações medicamentosas durante a análise.
- 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 Sugestão de Alternativas Seguras (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 Alternativas Seguras (RF 2).
RF 2. Agente de Sugestão de Alternativas Seguras
2.1 Tarefa do Agente
Sugerir alternativas seguras com base no histórico do paciente e diretrizes médicas.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados de interações medicamentosas e histórico do paciente para sugerir alternativas seguras.
# 2. Objetivo
Sugerir alternativas seguras utilizando diretrizes médicas e considerando o histórico do paciente.
# 3. Regras que você deve seguir para gerar sua resposta
- Para cada interação crítica detectada, busque alternativas seguras na base de dados de diretrizes médicas.
- Considere o histórico do paciente ao sugerir alternativas, priorizando aquelas com menor risco de interação e eficácia comprovada.
- Gere um relatório de alternativas sugeridas, especificando a justificativa baseada em diretrizes médicas.
# 4. Exemplo de Output que você deve produzir
{
"alternativas": ["Medicamento C", "Medicamento D"],
"baseado_em": "diretrizes_medicas"
} 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 dados de interações medicamentosas e histórico 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 até 5.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo as alternativas seguras sugeridas e a justificativa baseada em diretrizes médicas.
-
Exemplo de Estrutura de Output:
{ "alternativas": ["Medicamento C", "Medicamento D"], "baseado_em": "diretrizes_medicas" } - Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 800 caracteres.
2.3.3 Parâmetros de Geração
- Modelo: GPT-5
- Temperatura: 0.5
2.3.4 Ferramentas do Agente
- Documentos: Consulta a base de dados de diretrizes médicas durante a geração das alternativas.
- 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 (JSON com alternativas) é o resultado final e não é passada para outros agentes internos.
2.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. A resposta gerada é o resultado que deve ser disponibilizado ao médico.