PrototipeAI | Agente de IA para Geração de Relatórios Médicos

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 Suporte a Relatórios Médicos. 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 é processar dados clínicos do prontuário eletrônico para organizar e estruturar justificativas médicas, produzindo rascunhos de relatórios prontos para revisão e assinatura do médico.

2. Contexto e Problema

Atualmente, a elaboração de relatórios médicos detalhados e específicos para procedimentos como cirurgia eletiva, exames de alta complexidade, medicamentos de alto custo ou uso prolongado, e prolongamento ou internação domiciliar, é um processo manual e demorado. Os médicos precisam reunir dados de diversas fontes, o que pode ser propenso a erros e inconsistências.

Além disso, a pressão por eficiência e precisão na elaboração de tais documentos pode impactar negativamente o tempo disponível para atendimento ao paciente.

3. Impactos Esperados

Com a implementação do agente de IA, espera-se:

Redução do tempo necessário para a elaboração de relatórios médicos.
Aumento da precisão e consistência das justificativas médicas.
Liberação de tempo dos médicos para focar no atendimento ao paciente.
Padronização dos relatórios conforme normas médicas.

4. Visão Geral da Solução

O agente de IA para suporte a relatórios médicos processa dados clínicos do prontuário eletrônico do paciente, organiza e estrutura a justificativa médica, e produz rascunhos de relatórios para revisão e assinatura do médico. 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 elaboração de relatórios médicos precisos e padronizados.

A solução é composta por dois agentes de IA, que operam em sequência:

Agentes	Função Principal
`Agente de Processamento de Prontuário Médico` (RF 1)	Processar dados clínicos do prontuário eletrônico para estruturar justificativas médicas.
`Agente de Elaboração de Rascunho de Relatório Médico` (RF 2)	Produzir rascunhos de relatório médico prontos para revisão e assinatura do médico.

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.

Ver Agente na Prototipe AI

6. Requisitos Funcionais

RF 1. Agente de Processamento de Prontuário Médico

1.1 Tarefa do Agente

Receber e processar dados clínicos do prontuário eletrônico do paciente para estruturar justificativas médicas.

1.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados clínicos diretamente do prontuário eletrônico do paciente. Este conjunto de dados inclui informações sobre diagnósticos, tratamentos anteriores e planos de tratamento.

# 2. Objetivo
Processar esses dados para estruturar justificativas médicas, organizando as informações em grupos lógicos, como condição atual, histórico médico e plano de tratamento proposto.

# 3. Regras que você deve seguir para gerar sua resposta
- Extraia diagnósticos, tratamentos anteriores e planos de tratamento do prontuário.
- Estruture essas informações em grupos lógicos para facilitar a elaboração do relatório médico subsequente.
- Garanta que os dados estejam organizados de forma clara e coerente, prontos para serem utilizados pelo próximo agente.

# 4. Exemplo de Output que você deve produzir
**Condição Atual:** Paciente com hipertensão controlada.
**Histórico Médico:** Histórico de diabetes tipo 2, sem complicações.
**Plano de Tratamento Proposto:** Aumento da dosagem de metformina para 1000mg/dia.

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 dados do prontuário médico digital via API após o atendimento estar finalizado. Na fase de testes, os dados serão enviados pelo agente diretamente por upload de um csv na interface da Prototipe AI, para acelerar o processo de validação.
Tipo do input: Dados clínicos estruturados do prontuário médico.
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .csv, .json.
Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 50.000 caracteres.

1.3.2 Especificação do Output

Formato de output: O output deve ser um texto estruturado em **Markdown** contendo as seções de condição atual, histórico médico e plano de tratamento proposto.

Exemplo de Estrutura de Output:

 **Condição Atual:** Paciente com hipertensão controlada.
**Histórico Médico:** Histórico de diabetes tipo 2, sem complicações.
**Plano de Tratamento Proposto:** Aumento da dosagem de metformina para 1000mg/dia.

Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 3.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: 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 Elaboração de Rascunho de Relatório Médico (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Elaboração de Rascunho de Relatório Médico (RF 2).

RF 2. Agente de Elaboração de Rascunho de Relatório Médico

2.1 Tarefa do Agente

Produzir rascunhos de relatório específicos para cirurgia eletiva, exame de alta complexidade, medicamento de alto custo ou uso prolongado e prolongamento ou internação domiciliar.

2.2 Prompt ou Instruções do Agente

 # 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados estruturados do prontuário médico, que incluem informações sobre a condição atual do paciente, histórico médico e plano de tratamento proposto.

# 2. Objetivo
Compor a justificativa médica utilizando os dados estruturados, detalhando o procedimento ou tratamento recomendado, a necessidade clínica e os benefícios esperados.

# 3. Regras que você deve seguir para gerar sua resposta
- Formate o rascunho conforme normas médicas, assegurando que contenha todas as informações necessárias para a revisão médica.
- Inclua dados do paciente, diagnóstico, tratamento proposto e justificativa clínica.
- Garanta clareza e coerência na apresentação das informações.

# 4. Exemplo de Output que você deve produzir
---
**Relatório Médico**

**Paciente:** João da Silva
**Diagnóstico:** Hipertensão controlada
**Tratamento Proposto:** Aumento da dosagem de metformina para 1000mg/dia
**Justificativa Clínica:** O aumento da dosagem é necessário para melhor controle glicêmico, dado o histórico de diabetes tipo 2 do paciente.

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: Dados estruturados do prontuário médico, organizados em Markdown.
Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .md (Markdown).
Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 3.000 caracteres.

2.3.2 Especificação do Output

Formato de output: O output deve ser um rascunho de relatório médico formatado em **Markdown**.