Agente de IA para Relatórios de Evolução Clínica

Definir parâmetros de busca e escopo temporal para coletar informações diárias do prontuário do paciente a partir de identificadores fornecidos.

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: O input inicial para o fluxo é um conjunto de dados estruturados contendo identificadores do paciente e data de referência.
• 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é 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo JSON contendo os parâmetros de consulta definidos, incluindo o período de análise, prioridades e seções requeridas.
• Exemplo de Estrutura de Output:

   {
    "consulta_params": {
      "paciente_id": "string",
      "periodo": {
        "inicio": "YYYY-MM-DDTHH:mm:ssZ",
        "fim": "YYYY-MM-DDTHH:mm:ssZ"
      },
      "prioridades": ["evolucao_ultimas_24h", "mudancas_terapeuticas", "instabilidade_hemodinamica"],
      "secoes_requeridas": ["sinais_vitais", "medicacoes", "diagnosticos", "condutas", "exames_laboratoriais", "eventos_adversos"],
      "termos_clinicos_prioritarios": ["febre", "queda_saturacao", "dor", "hipotensao", "taquicardia", "oliguria"],
      "fontes": {
        "prontuario_texto": ["..."],
        "anexos_pdf": ["..."],
        "sistemas": ["..."]
      }
    }
  } 

• 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: Consulta documentos de prontuários médicos digitais.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Conecta-se a sistemas de prontuário eletrônico (EHR).

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

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

Realizar consulta aos documentos e sistemas de prontuário para obter trechos relevantes ao período e seções solicitadas.

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 um arquivo JSON contendo os parâmetros de consulta definidos pelo agente anterior.
• 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é 2.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo JSON contendo os dados recuperados do prontuário, incluindo seções, timestamps, origem e conteúdo bruto.
• Exemplo de Estrutura de Output:

   {
    "dados_recuperados": [
      {
        "secao": "sinais_vitais",
        "timestamp": "ISO8601",
        "origem": "EHR_X",
        "autor": "opcional",
        "texto": "conteudo bruto do trecho"
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

2.3.4 Ferramentas do Agente

• Documentos: Consulta documentos de prontuários médicos digitais.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Conecta-se a sistemas de prontuário eletrônico (EHR).

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 Normalização e Estruturação de Dados 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 Normalização e Estruturação de Dados Clínicos (RF 3).

Transformar trechos brutos do prontuário em JSON clínico padronizado e consistente para as últimas 24–72 horas.

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: Este agente deve ser apto a receber um arquivo JSON contendo os dados recuperados do prontuário pelo agente anterior.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo JSON clínico padronizado, contendo todas as informações estruturadas e consistentes para análise clínica.
• Exemplo de Estrutura de Output:

   {
    "paciente_id": "string",
    "periodo_analise": {
      "inicio": "ISO8601",
      "fim": "ISO8601"
    },
    "sinais_vitais": {
      "itens": [
        {
          "tipo": "PA|FC|FR|Temp|SpO2",
          "unidade": "mmHg|bpm|irpm|C|%",
          "valores": [
            {
              "timestamp": "ISO8601",
              "valor": 0
            }
          ],
          "min": 0,
          "max": 0,
          "media": 0,
          "ultimo": {
            "timestamp": "ISO8601",
            "valor": 0
          }
        }
      ]
    },
    "medicacoes": [
      {
        "nome": "string",
        "dose": 0,
        "unidade": "mg|mcg|g|mL|UI",
        "via": "VO|EV|IM|SC|Inalatória|Sonda",
        "frequencia": "q6h|1x/dia|contínua",
        "ultima_administracao": "ISO8601",
        "status": "iniciada|mantida|ajustada|suspensa",
        "indicacao_sugerida": "opcional"
      }
    ],
    "exames_laboratoriais": [
      {
        "nome": "Hemoglobina|Creatinina|PCR|...",
        "resultados": [
          {
            "timestamp": "ISO8601",
            "valor": 0,
            "unidade": "g/dL|mg/dL|mg/L|..."
          }
        ],
        "referencia": {
          "min": 0,
          "max": 0
        },
        "tendencia": {
          "h24": "subiu|caiu|estavel|sem_dados",
          "h48": "subiu|caiu|estavel|sem_dados",
          "h72": "subiu|caiu|estavel|sem_dados"
        }
      }
    ],
    "diagnosticos_ativos": ["string"],
    "comorbidades": ["string"],
    "alergias": ["string"],
    "dispositivos": [
      {
        "tipo": "CVC|SNG|SV|Ventilacao|Dreno|Cateter",
        "status": "em_uso|removido",
        "colocacao": "ISO8601"
      }
    ],
    "eventos_adversos": [
      {
        "tipo": "queda|reacao_medicamentosa|extravasamento|...",
        "timestamp": "ISO8601",
        "descricao": "string"
      }
    ],
    "procedimentos": [
      {
        "nome": "Hemocultura|TC|USG|...",
        "timestamp": "ISO8601",
        "resultado_resumo": "string"
      }
    ],
    "balanco_hidrico": {
      "entradas_mL": 0,
      "saidas_mL": 0,
      "resultado_mL": 0
    },
    "observacoes_relevantes": "string",
    "faltantes": ["campos_sem_dado"],
    "flags_consistencia": {
      "datas_incoerentes": false,
      "unidades_ausentes": [],
      "duplicidades": []
    },
    "padronizacao_realizada": "sim|nao"
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 7.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.4 Ferramentas do Agente

• Documentos: Consulta documentos de prontuários médicos digitais.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Conecta-se a sistemas de prontuário eletrônico (EHR).

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 Verificação de Consistência e Precisão Clínica (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Verificação de Consistência e Precisão Clínica (RF 4).

Revisar o JSON clínico estruturado, detectar incoerências e preparar uma versão validada para uso no relatório.

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: Este agente deve ser apto a receber um arquivo JSON clínico padronizado gerado pelo agente anterior.
• 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é 7.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo JSON contendo o JSON clínico validado, lista de erros detectados, ajustes aplicados e status de aprovação.
• Exemplo de Estrutura de Output:

   {
    "aprovado": true,
    "erros": ["lista de problemas"],
    "ajustes_aplicados": ["normalizacoes executadas"],
    "json_validado": {
      ...mesma estrutura corrigida...
    }
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 8.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.4 Ferramentas do Agente

• Documentos: Consulta documentos de prontuários médicos digitais.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Conecta-se a sistemas de prontuário eletrônico (EHR).

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 Geração de Relatório de Evolução Clínica (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatório de Evolução Clínica (RF 5).

Gerar relatório de evolução clínica padronizado, consistente e pronto para disponibilização diária à equipe médica.

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: Este agente deve ser apto a receber um arquivo JSON clínico validado gerado pelo agente anterior.
• 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.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um relatório de evolução clínica diário em texto estruturado (ex.: markdown) com seções fixas: Identificação, Resumo 24h, Sinais Vitais (com tendências), Laboratório (com tendências), Medicamentos e Intervenções, Dispositivos, Eventos/Procedimentos, Avaliação, Plano do Dia, Pendências/Exames Programados, Alertas/Flags.
• Exemplo de Estrutura de Output:

   Relatório de Evolução Clínica
  
  Identificação
  - Paciente ID: 12345
  - Período: 2025-12-14T00:00:00Z a 2025-12-14T23:59:59Z
  
  Resumo 24h
  - O paciente apresentou febre e hipotensão nas últimas 24 horas.
  - Ajuste na medicação para hipertensão foi realizado.
  
  Sinais Vitais
  - PA: 120/80 mmHg (min: 110/70, max: 130/85)
  - FC: 75 bpm (estável)
  
  Laboratório
  - Hemoglobina: 13.5 g/dL (subiu nas últimas 24h)
  
  Medicamentos e Intervenções
  - Novo medicamento: Lisinopril 10mg
  
  Dispositivos
  - CVC em uso desde 2025-12-13
  
  Eventos/Procedimentos
  - Hemocultura realizada em 2025-12-14
  
  Avaliação
  - Paciente estável, mas requer monitoramento contínuo para pressão arterial.
  
  Plano do Dia
  - Monitorar sinais vitais a cada 4 horas
  
  Pendências/Exames Programados
  - Ecocardiograma agendado para 2025-12-15
  
  Alertas/Flags
  - Nenhum alerta crítico identificado 

• Número de caracteres esperado: O relatório gerado terá um tamanho aproximado de 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.
• 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 não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta (relatório de evolução clínica) é 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 à equipe médica.