Agente de IA para Suporte na Decisão Clínica

Realizar chamadas às APIs dos sistemas hospitalares (EMR/HIS, LIS, PACS, PDMS/monitores, sistemas de farmácia) para recuperar dados clínicos atualizados do paciente em janela temporal definida.

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 uma solicitação via API contendo as informações necessárias para acessar os sistemas clínicos. 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: Dados estruturados contendo detalhes de autenticação e endpoints para APIs de sistemas clínicos.
• Formatos Suportados: Esse agente deve ser capaz de receber dados em formato 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 consolidando os dados recuperados de cada sistema clínico consultado.
• Exemplo de Estrutura de Output:

   {
    "raw_data": {
      "EMR": {...},
      "LIS": {...},
      "PACS": {...},
      "PDMS": {...},
      "PHARMACY": {...}
    },
    "fetched_at": "iso_datetime",
    "latency_ms": {
      "EMR": 120,
      "LIS": 240,
      "PACS": 310
    },
    "request_correlation_id": "uuid"
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.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: Executa chamadas às APIs dos sistemas hospitalares conforme especificado no input.

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

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

Ao concluir sua execução, esse agente aciona o Agente de Normalização e Integração de Dados Clínicos (RF 2).

Padronizar unidades, alinhar timestamps, deduplicar e consolidar dados clínicos multi-fontes em um contexto único do paciente, com relatório de qualidade dos dados.

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: Dados brutos estruturados em JSON, contendo informações clínicas de múltiplos sistemas.
• 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é 15.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o contexto unificado do paciente, incluindo dados demográficos, vitais, laboratoriais, medicamentos e dispositivos, além de um relatório de qualidade dos dados.
• Exemplo de Estrutura de Output:

   {
    "patient_context": {"demographics": {"id": "string", "age": 0, "sex": "M|F|X"}, "vitals_last_2h": [{"type": "HR", "value": 88, "unit": "bpm", "ts": "iso_datetime", "source": "PDMS"}], "labs_last_24h": [{"analyte": "Lactato", "value": 1.8, "unit": "mmol/L", "ts": "iso_datetime", "loinc": "xxxx"}], "meds_active": [{"drug": "Norepinefrina", "dose": {"value": 0.05, "unit": "mcg/kg/min"}, "route": "IV", "status": "running"}], "allergies": ["penicilinas"], "diagnoses": [{"code": "A41.9", "system": "ICD10", "desc": "Sepsis"}], "devices": [{"type": "Ventilador", "mode": "AC-VC", "settings": {...}}]}, "data_quality_report": {"completeness": {"vitals": 0.92, "labs": 0.85}, "latency_minutes": {"vitals": 3, "labs": 45}, "plausibility_flags": [{"signal": "HR", "ts": "iso_datetime", "issue": "out_of_range", "value": 220}]}, "normalization_notes": ["Unidades convertidas para SI", "Timestamps alinhados a America/Sao_Paulo" ]} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 10.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: Utiliza lógica interna para conversão de unidades e alinhamento de timestamps.
• 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 Estratificação de Risco e Sinais de Alarme (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Estratificação de Risco e Sinais de Alarme (RF 3).

Calcular escores de risco clinicamente aceitos com dados disponíveis, identificar sinais de alarme e listar dados críticos ausentes que impedem avaliação adequada.

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: Contexto clínico unificado do paciente em formato JSON, incluindo dados demográficos, vitais, laboratoriais e medicamentos.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o resumo dos escores de risco, sinais de alarme identificados e dados críticos ausentes.
• Exemplo de Estrutura de Output:

   {
    "risk_summary": {"qSOFA": {"score": 2, "components": [{"criterion": "FR>=22", "value": 28, "met": true}]}, "NEWS2": {"score": 6}}, "red_flags": [{"item": "PAM<65 mmHg", "ts": "iso_datetime", "severity": "alta"}, {"item": "Lactato>=4 mmol/L", "severity": "crítica"}], "contraindications": [{"context": "Alergia a penicilinas", "affects": ["piperacilina-tazobactam"]}], "missing_critical_data": ["PaO2/FiO2", "creatinina recente (<24h)"]} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 5.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: Utiliza lógica interna para cálculo de escores de risco e identificação de sinais de alarme.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Consulta a Documento (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 Consulta a Documento (RF 4).

Recuperar trechos de protocolos e diretrizes clínicas internas para embasar recomendações ao caso atual.

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: Consultas pré-definidas em formato JSON, incluindo identificador do corpus e parâmetros de filtro.
• 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 contendo trechos de evidências clínicas recuperados, com metadados completos.
• Exemplo de Estrutura de Output:

   {
    "evidence_snippets": [{"title": "Protocolo de Sepse 2023", "section": "Antibióticos iniciais", "snippet": "Iniciar antibiótico de amplo espectro em até 1h...", "source_id": "doc_123", "url": "interna://...", "year": 2023}], "queries_executed": ["manejo de sepse em UTI"], "corpus_id": "diretrizes_hospitalares_v1"} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno 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: Executa consultas em um corpus interno de diretrizes clínicas.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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 Síntese e Priorização de Recomendações Clínicas (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Síntese e Priorização de Recomendações Clínicas (RF 5).

Produzir recomendações clínicas contextualizadas e priorizadas para apoio à decisão em tempo real, incluindo justificativas, citações e requisitos de monitorização.

5.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 4).
• Tipo do input: Dados clínicos, escores de risco, sinais de alarme e evidências em formato 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é 10.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo recomendações clínicas contextualizadas e priorizadas, com justificativas, citações e requisitos de monitorização.
• Exemplo de Estrutura de Output:

   {
    "recommendations": [{"id": "REC-001", "title": "Reanimação volêmica cautelosa", "priority": "alta", "actions": ["Avaliar resposta a 250-500 mL de cristaloide"], "rationale": "PAM<65 mmHg e lactato elevado", "prerequisites": ["Acesso venoso pérvio"], "monitoring_plan": ["Reavaliar PAM e lactato em 30-60 min"], "contraindications_considered": ["Sobrecarga hídrica"], "sources": [{"title": "Protocolo de Sepse 2023", "source_id": "doc_123", "year": 2023}], "confidence": 0.78, "time_critical_window_min": 60, "expected_benefit": "Melhora de perfusão", "potential_harm": "Edema pulmonar", "human_approval_required": true}], "disclaimers": ["Conteúdo destinado a apoio à decisão; não substitui julgamento clínico."]} 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 8.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: Utiliza lógica interna para cálculo de prioridades e avaliação de impacto.
• 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 é 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. As recomendações geradas devem ser disponibilizadas ao usuário para apoio à decisão clínica.