Agente de IA para Integração de Dados de Triagem

Definir com precisão o escopo de dados e as fontes necessárias para integrar informações de triagem com sistemas hospitalares, alinhando identificadores do paciente, janelas de tempo e seções clínicas a serem recuperadas.

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, contexto de atendimento e janela temporal.
• 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 dados com até 50.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o escopo de integração definido, incluindo fontes ativas, mapeamento de campos, identificadores, janela temporal, seções requeridas e requisitos de consentimento.
• Exemplo de Estrutura de Output:

   {
    "fontes_ativas": ["triagem_api", "ehr_api"],
    "mapeamento_campos": {"triagem":"modelo_comum", "ehr":"modelo_comum"},
    "identificadores": {"patient_id", "mrn", "cpf"},
    "janela_temporal": {"inicio": "...", "fim": "...", "unidade": "horas"},
    "secoes_requeridas": ["sinais_vitais", "alergias", "medicacoes", "problemas", "resultados"],
    "requisitos_consentimento": {"necessita_consentimento": true, "base_legal": "..."}
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, 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 Preparação de Payloads de Consulta (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Preparação de Payloads de Consulta (RF 2).

Converter o escopo definido em payloads concretos de consulta para cada fonte (triagem e EHR).

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 como input um JSON contendo o escopo de integração definido.
• 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é 3.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista de payloads prontos para execução, cada um detalhando tipo de payload, endpoint e parâmetros.
• Exemplo de Estrutura de Output:

   [
    {
      "tipo_payload": "triagem_api",
      "endpoint": ".../triagem",
      "parametros": {"patient_id": "...", "inicio": "...", "fim": "...", "campos": ["HR", "BP_sys", "BP_dia", "RR", "Temp", "SpO2", "nivel_consciencia", "escala_dor", "prioridade_triagem"]}
    },
    {
      "tipo_payload": "ehr_api",
      "endpoint": ".../ehr",
      "parametros": {"patient_id": "...", "inicio": "...", "fim": "...", "recursos": ["Allergies", "Medications", "Conditions", "Observations"]}
    }
  ] 

• Número de caracteres esperado: A lista de payloads deve ter um tamanho estimado em torno de 2.500 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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Chamada à API - Sistema de Triagem (RF 3) e o Agente de Execução de Chamada à API - Prontuário Eletrônico (EHR) (RF 4).

2.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 - Sistema de Triagem (RF 3).

Realizar chamada à API do Sistema de Triagem para obter sinais vitais, prioridade e observações de triagem.

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 item de payload com tipo_payload="triagem_api", endpoint e parâmetros prontos.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos retornados pela API de triagem.
• Exemplo de Estrutura de Output:

   {
    "HR": "72",
    "BP_sys": "120",
    "BP_dia": "80",
    "RR": "16",
    "Temp": "36.5",
    "SpO2": "98",
    "nivel_consciencia": "Alerta",
    "escala_dor": "0",
    "prioridade_triagem": "Baixa"
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 500 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: Não se aplica (uso de ferramenta)

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o payload recebido para a API externa de triagem e retornar os dados recebidos como resposta.

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 Agregação de Dados Brutos (RF 5).

3.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 - Prontuário Eletrônico (EHR) (RF 4).

Realizar chamada à API do EHR para obter alergias, medicações, problemas/condições e observações/exames.

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 item de payload com tipo_payload="ehr_api", endpoint e parâmetros prontos.
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos retornados pela API do EHR.
• Exemplo de Estrutura de Output:

   {
    "alergias": ["Penicilina", "Amendoim"],
    "medicacoes": ["Paracetamol", "Ibuprofeno"],
    "problemas": ["Asma", "Diabetes"],
    "observacoes": [
      {"tipo": "Exame de Sangue", "resultado": "Normal"},
      {"tipo": "Raio-X", "resultado": "Sem Alterações"}
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: Não se aplica (uso de ferramenta)

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o payload recebido para a API externa do EHR e retornar os dados recebidos como resposta.

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 Agregação de Dados Brutos (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Agregação de Dados Brutos (RF 5).

Unificar os dados brutos provenientes das fontes de triagem e EHR em um único pacote para normalização.

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 uma lista de resultados brutos das execuções de API, cada item com origem e conteúdo JSON.
• 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.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON unificado contendo dados brutos de triagem e EHR, bem como metadados de fontes recebidas e lacunas.
• Exemplo de Estrutura de Output:

   {
    "triagem_bruto": {"HR": "72", "BP_sys": "120", "BP_dia": "80"},
    "ehr_bruto": {"alergias": ["Penicilina"]},
    "fontes_recebidas": ["triagem_api", "ehr_api"],
    "lacunas": []
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.500 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 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 Padronização Clínica (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Normalização e Padronização Clínica (RF 6).

Transformar dados brutos de triagem e EHR para um modelo clínico comum com unidades, códigos e estrutura consistentes.

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: Este agente deve ser apto a receber um JSON agregado com dados brutos de triagem e EHR.
• 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 normalizado contendo dados transformados para um modelo clínico comum.
• Exemplo de Estrutura de Output:

   {
    "paciente": {"identificadores": {"patient_id": "..."}},
    "sinais_vitais": [
      {"tipo": "HR", "valor": "72", "unidade": "bpm", "timestamp": "...", "fonte": "triagem_api", "qualidade_dado": "high"}
    ],
    "problemas": [
      {"termo_normalizado": "asma", "status": "ativo", "texto_original": "Asma"}
    ],
    "alergias": [
      {"substancia": "Penicilina", "severidade": "desconhecida"}
    ],
    "medicacoes": [
      {"substancia": "Paracetamol", "via": "oral", "dosagem": "500mg", "inicio": "...", "fim": "...", "prescrito_por": "Dr. Silva", "fonte": "ehr_api"}
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Resolução de Identidade e Consolidação Temporal (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Resolução de Identidade e Consolidação Temporal (RF 7).

Reconciliar registros entre fontes pelo mesmo paciente e consolidar séries temporais.

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: Este agente deve ser apto a receber um JSON normalizado com coleções por seção e metadados de identificadores.
• 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é 3.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON consolidado com registros mesclados e trilhas de auditoria.
• Exemplo de Estrutura de Output:

   {
    "paciente": {"identificadores": {"patient_id": "..."}},
    "sinais_vitais": [
      {"tipo": "HR", "valor": "72", "unidade": "bpm", "timestamp": "...", "fonte": "triagem_api", "ultima_atualizacao": "..."}
    ],
    "consolidacao": {"criterios_usados": "patient_id", "itens_mesclados": 5, "conflitos_resolvidos": [{"campo": "HR", "valor_escolhido": "72", "valores_descartados": ["70", "71"]}]}
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.500 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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Conformidade e Privacidade (RF 8).

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

Ao concluir sua execução, esse agente aciona o Agente de Conformidade e Privacidade (RF 8).

Aplicar políticas de privacidade, consentimento e minimização de dados ao pacote consolidado antes da disponibilização.

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: Este agente deve ser apto a receber um JSON consolidado, juntamente com a finalidade do uso, requisitos de consentimento e políticas institucionais.
• 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é 4.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o status de conformidade, motivo de quebra (se houver), dados ajustados e campos mascarados/removidos.
• Exemplo de Estrutura de Output:

   {
    "registro_conforme": true,
    "motivo_quebra_conformidade": null,
    "dados": {"paciente": {"identificadores": {"patient_id": "..."}}, "sinais_vitais": [{"tipo": "HR", "valor": "72", "unidade": "bpm"}]},
    "mascaramentos_aplicados": [],
    "identificadores_removidos": []
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 2.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 deve ser visível para o Agente de Geração da Visão Holística do Paciente (RF 9).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração da Visão Holística do Paciente (RF 9).

Produzir a visão consolidada e utilizável pela equipe clínica para apoio à decisão.

9.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 8).
• Tipo do input: Este agente deve ser apto a receber um JSON conforme contendo dados consolidados ou null com motivo.
• 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é 4.000 caracteres.

9.3.2 Especificação do Output

• Formato de output: O output deve ser uma visão consolidada em JSON, contendo cabeçalho, resumo clínico e seções detalhadas.
• Exemplo de Estrutura de Output:

   {
    "cabecalho": {"paciente_hash": "...", "janela_temporal": "...", "fontes": ["triagem_api", "ehr_api"]},
    "resumo_clinico": {"prioridade_triagem": "Baixa", "alertas_chave": [{"tipo": "SpO2", "valor": "90", "timestamp": "..."}], "ultimos_sinais_vitais": [{"tipo": "HR", "valor": "72", "unidade": "bpm", "tempo_relativo": "5", "fonte": "triagem_api"}]},
    "secoes": {"dados_demograficos": "...", "queixa_atual": "...", "sinais_vitais_recente": [{"tipo": "HR", "valor": "72", "unidade": "bpm"}], "alergias": [{"substancia": "Penicilina", "severidade": "desconhecida"}], "problemas_ativos": [{"termo_normalizado": "asma", "status": "ativo"}], "medicacoes_atuais": [{"substancia": "Paracetamol", "via": "oral", "dosagem": "500mg"}], "resultados_recente": [{"tipo": "Exame de Sangue", "resultado": "Normal"}]},
    "trilha_proveniencia": [{"secoes": "sinais_vitais_recente", "ids_origem": ["..."], "timestamps": ["..."]}],
    "pronto_para_consumo": true
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.000 caracteres.

9.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

9.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

9.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 final deste agente não é repassada para outros agentes, é o entregável final.

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

A execução deste agente finaliza o fluxo, e a visão consolidada do paciente é o resultado que deve ser disponibilizado à equipe clínica.