Agente de IA para Registro de Evolução de Pacientes

Definir escopo e parâmetros de coleta diária da evolução do paciente a partir das fontes disponíveis.

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 identificadores mínimos do paciente e lista de fontes habilitadas 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 csv na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: Dados estruturados em formato CSV ou JSON contendo identificadores do paciente e parâmetros de coleta.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .csv e .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: O output deve ser um JSON estruturado contendo o plano de coleta com todos os parâmetros definidos.
• Exemplo de Estrutura de Output:

   {
    "plano_coleta": {
      "fontes": [
        {
          "fonte_nome": "EHR_observacoes",
          "tipo_acesso": "api",
          "endpoint_ou_referencia": "/api/ehr/observacoes",
          "filtros": {
            "patient_id": "12345",
            "admission_id": "54321",
            "data_inicial": "2025-12-01T00:00:00-03:00",
            "data_final": "2025-12-17T23:59:59-03:00"
          },
          "campos_requeridos": ["timestamp", "autor_categoria", "texto_livre"],
          "limite_registros": 1000,
          "ordenacao_por": "timestamp asc",
          "incluir_apenas_campos_essenciais": true
        }
      ],
      "proposito_tratamento": "documentacao_evolucao",
      "audiencia_prevista": ["equipe_enfermagem", "equipe_medica"]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho médio 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: 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 Execução de Chamada à API - EHR/HIS (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 Chamada à API - EHR/HIS (RF 2).

Executar chamadas às APIs do prontuário/hospital (EHR/HIS) conforme o plano de coleta.

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: JSON estruturado contendo o plano de coleta com referências de APIs a serem chamadas.
• 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 os dados brutos retornados pelas APIs, preservando metadados como http_status e timestamps.
• Exemplo de Estrutura de Output:

   {
    "dados_brutos": [
      {
        "fonte": "EHR_observacoes",
        "http_status": 200,
        "carimbo_tempo_coleta": "2025-12-17T12:22:00-03:00",
        "dados": [
          {
            "timestamp": "2025-12-17T08:00:00-03:00",
            "autor_categoria": "enfermeira",
            "texto_livre": "Paciente estável, sem queixas."
          }
        ]
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho médio 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 Execução de Consulta a Documento (RF 3).

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

Executar consultas a documentos de evolução/anexos para recuperar textos de observações de enfermagem e documentos correlatos.

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 estruturado contendo parâmetros de consulta para documentos e anexos.
• 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 JSON com trechos de texto recuperados por documento, incluindo metadados como documento_id, tipo_documento e timestamp.
• Exemplo de Estrutura de Output:

   {
    "documentos_recuperados": [
      {
        "documento_id": "doc_98765",
        "tipo_documento": "observacao_enfermagem",
        "timestamp": "2025-12-17T08:00:00-03:00",
        "autor_categoria": "enfermeira",
        "trecho_textual": "Paciente estável, sem queixas."
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho médio de 2.500 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 Execução de Consultas em Banco de Dados (RF 4).

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

Executar consultas SQL/analytics em data warehouse clínico quando necessá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: JSON estruturado contendo parâmetros de consulta SQL.
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON com o resultado tabular da consulta, incluindo metadados como duracao_ms e linhas_afetadas.
• Exemplo de Estrutura de Output:

   {
    "resultado_sql": {
      "duracao_ms": 120,
      "linhas_afetadas": 50,
      "dados": [
        {
          "timestamp": "2025-12-17T08:00:00-03:00",
          "sinal_vital": "FC_bpm",
          "valor": 72
        }
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho médio de 3.000 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 Consolidação e Normalização de Dados de Evolução (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação e Normalização de Dados de Evolução (RF 5).

Unificar e padronizar dados brutos das múltiplas fontes em um schema clínico único para evolução diária.

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 estruturado contendo dados brutos de múltiplas fontes.
• 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.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado contendo o objeto evolucao_normalizada com seções padronizadas.
• Exemplo de Estrutura de Output:

   {
    "evolucao_normalizada": {
      "identificacao": {
        "patient_id": "12345",
        "admission_id": "54321"
      },
      "sinais_vitais": [
        {
          "timestamp": "2025-12-17T08:00:00-03:00",
          "FC_bpm": 72
        }
      ],
      "medicamentos": [],
      "observacoes_enfermagem": [],
      "procedimentos": [],
      "exames": [],
      "dispositivos": [],
      "intercorrencias": [],
      "lacunas_dados": []
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho médio de 5.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: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 Checagem de Qualidade e Completude dos Dados (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Checagem de Qualidade e Completude dos Dados (RF 6).

Avaliar consistência, completude e plausibilidade clínica mínima dos dados normalizados.

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 estruturado contendo o objeto evolucao_normalizada.
• 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.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o quality_report com pontuações e recomendações.
• Exemplo de Estrutura de Output:

   {
    "quality_report": {
      "score_completude": 85,
      "inconsistencias": [],
      "outliers": [],
      "itens_esperados_nao_encontrados": [],
      "recomendacoes_de_coleta": [
        "Capturar PA em repouso"
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho médio de 3.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 se conecta a sistemas externos.

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 deve ser visível para o Agente de Geração de Relatório de Evolução Padronizado (RF 7).

6.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 Padronizado (RF 7).

Produzir o relatório diário padronizado de evolução para equipe médica e de enfermagem.

7.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 6).
• Tipo do input: JSON estruturado contendo o objeto evolucao_normalizada e o quality_report.
• 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.

7.3.2 Especificação do Output

• Formato de output: O output deve ser dois formatos: um JSON estruturado relatorio_evolucao e um texto_clinico_formatado.
• Exemplo de Estrutura de Output:

   {
    "relatorio_evolucao": {
      "identificacao_resumida": {
        "idade": 65,
        "sexo": "Feminino",
        "leito": "101",
        "dia_internacao": 4
      },
      "resumo_ultimas_24h": "Paciente estável, sem queixas.",
      "sinais_vitais_resumo": {
        "min": 60,
        "max": 80,
        "media": 70
      },
      "medicamentos_administrados": [],
      "procedimentos_realizados": [],
      "intercorrencias": [],
      "avaliacao_enfermagem": "Paciente respondeu bem às intervenções.",
      "plano_de_cuidados": "Continuar monitoramento.",
      "pendencias": "Exames de sangue aguardando resultados."
    },
    "texto_clinico_formatado": "Dados compilados de EHR e registros de enfermagem. Paciente estável, sem queixas."
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho médio de 4.000 caracteres.

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

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

7.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 Insights e Alertas Clínicos (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Insights e Alertas Clínicos (RF 8).

Derivar insights acionáveis e alertas de risco a partir dos dados normalizados.

8.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 7).
• Tipo do input: JSON estruturado contendo o objeto evolucao_normalizada e o quality_report.
• 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.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo insights_alertas com alertas e recomendações acionáveis.
• Exemplo de Estrutura de Output:

   {
    "insights_alertas": {
      "alertas": [
        "Monitorar PA a cada 30 min"
      ],
      "recomendacoes_acionaveis": [
        "Reavaliar analgesia"
      ],
      "justificativas": [
        "SpO2 < 92%"
      ],
      "nivel_prioridade": "alto",
      "escore_risco_global": 90
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho médio de 3.000 caracteres.

8.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

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

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

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

A execução deste agente finaliza o fluxo, gerando insights e alertas que devem ser disponibilizados à equipe médica e de enfermagem.