Agente de IA para Integração de Dados de Laboratório

Conciliar e vincular resultados laboratoriais ao paciente correto no prontuário eletrônico (EHR), definindo uma chave única de paciente para o fluxo.

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 laboratoriais e prontuários eletrônicos 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 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 informações de pacientes e resultados laboratoriais.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json, .csv.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado que representa o estado de conciliação dos pacientes.
• Exemplo de Estrutura de Output:

   {
    "patient_match_status": "matched",
    "matched_patient_id": "12345",
    "candidate_patient_ids": [],
    "linkage_map": [{"lab_patient_key": "mrn123", "ehr_patient_id": "12345"}],
    "issues": []
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.500 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.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Padronização e Deduplicação de Resultados de Exames (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Padronização e Deduplicação de Resultados de Exames (RF 2).

Padronizar códigos e unidades de exames, validar consistência de valores e remover duplicidades antes da integração ao EHR.

2.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 1).
• Tipo do input: Este agente deve ser apto a receber como input um JSON estruturado contendo resultados laboratoriais e o estado de conciliação de pacientes.
• 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 texto com até 60.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado que representa os resultados laboratoriais padronizados e deduplicados.
• Exemplo de Estrutura de Output:

   {
    "lab_results_normalizados": [{"patient_id": "12345", "loinc": "1234-5", "test_code_origem": "test123", "value_num": 5.6, "value_text": null, "unit_ucum": "mg/dL", "ref_interval": {"low": 4.0, "high": 6.0}, "specimen": "sangue", "status_finalidade": "final", "collected_at": "2025-12-01T10:00:00Z", "resulted_at": "2025-12-02T10:00:00Z", "accession_number": "acc123", "proveniencia": {"sistema": "LIS", "fonte": "LIS"}}], "duplicatas_descartadas": [{"accession_number": "acc124", "motivo": "duplicata_mesmo_conteudo"}], "alertas_normalizacao": [{"tipo": "unidade_nao_mapeada", "detail": "Unidade desconhecida para test_code test124", "test_code": "test124"}] }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 5.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.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Consolidação Clínica no Prontuário (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação Clínica no Prontuário (RF 3).

Integrar os exames normalizados à linha do tempo do EHR, associando a encontros/episódios e produzindo interpretações e sinalizações clínicas.

3.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 2).
• Tipo do input: Este agente deve ser apto a receber como input um JSON estruturado contendo exames laboratoriais normalizados e o contexto clínico do 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 texto com até 80.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado que representa a integração dos exames na linha do tempo do EHR.
• Exemplo de Estrutura de Output:

   {
    "dados_integrados": {"prontuario": {"patient_id": "12345", "encounters": [...]}, "exames": [{"loinc": "1234-5", "valor": {"num": 5.6, "texto": null}, "unit_ucum": "mg/dL", "interpretacao": "normal", "ref_interval": {"low": 4.0, "high": 6.0}, "vinculo_encounter_id": "enc123", "collected_at": "2025-12-01T10:00:00Z", "resulted_at": "2025-12-02T10:00:00Z", "flags": ["novo"], "proveniencia": {"sistema": "LIS", "accession_number": "acc123"}}] }, "consistencia": {"upserts": 1, "skips": 0, "erros": []} }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 6.000 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.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Geração de Modelo de Visualização para Médicos (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Modelo de Visualização para Médicos (RF 4).

Produzir um modelo de visualização pronto para interface clínica, com resumos, destaques e séries temporais por analito.

4.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão bem-sucedida do agente anterior (RF 3).
• Tipo do input: Este agente deve ser apto a receber como input um JSON estruturado contendo dados integrados e normalizados de exames laboratoriais.
• 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 texto com até 40.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON estruturado que representa o modelo de visualização para interface clínica.
• Exemplo de Estrutura de Output:

   {
    "view_model": {"resumo_paciente": {"patient_id": "12345", "ultimos_exames_data": "2025-12-02T10:00:00Z"}, "destaques": [{"tipo": "critico", "descricao": "Potássio alto", "loinc": "1234-5", "resulted_at": "2025-12-02T10:00:00Z"}], "series_temporais": [{"loinc": "1234-5", "nome_exame": "Potássio sérico", "pontos": [{"t": "2025-12-01T10:00:00Z", "v": 5.6}], "unit": "mg/dL", "ref_low": 4.0, "ref_high": 6.0}], "organizacao_por_paineis": [{"painel": "bioquimica", "itens": ["1234-5"]}] }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 4.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: Após gerar o view_model, enviar o payload final para o sistema de prontuário eletrônico configurado para apresentação clínica.

4.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente.
• Visibilidade da Resposta: A resposta gerada por este agente é o entregável final para o sistema de prontuário eletrônico.

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

A execução deste agente finaliza o fluxo. O view_model gerado é o resultado que deve ser disponibilizado ao usuário.