Agente de IA para Geração de Relatórios de Atendimento Médico

Receber os dados do atendimento inicial e entregar um JSON clínico normalizado, consistente e pronto para redação do relatório.

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 um JSON bruto do atendimento inicial 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 do JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um JSON bruto contendo dados do atendimento inicial.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 50.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON normalizado com schema padronizado: { patient_demographics, chief_complaint, history_of_present_illness, review_of_systems, past_medical_history, medications, allergies, vitals, physical_exam, tests_and_results, assessment_hypotheses[], plan, follow_up, consent }. Inclui campos: normalization_actions[], unit_harmonization[], missing_fields[], inconsistencies[], readiness_flag (true/false), notes.
• Exemplo de Estrutura de Output:

   {
    "patient_demographics": {...},
    "chief_complaint": "Febre alta",
    "history_of_present_illness": "Paciente relata febre há 3 dias...",
    "vitals": {
      "temperature": "38.5",
      "pressure": "120/80 mmHg",
      "heart_rate": "88 bpm"
    },
    "readiness_flag": true,
    "notes": "Todos os dados mínimos coletados."
  } 

• Número de caracteres esperado: O JSON final deve ser conciso, com um tamanho estimado em torno de 5.000 caracteres, podendo variar conforme a complexidade dos dados coletados.

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 Redator de Relatório Médico Padronizado (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente Redator de Relatório Médico Padronizado (RF 2).

Gerar o relatório médico estruturado e a narrativa padronizada a partir do JSON clínico normalizado.

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 normalizado, que corresponde aos dados clínicos já padronizados e validados 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 texto com até 5.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um report_package contendo: report_markdown (narrativa completa), structured_summary { sections_filled_map, missing_sections[], diagnostic_hypotheses[{descrição, evidências, confiança(0-1)}], risk_flags[], vitals_summary, plan_items[], follow_up_recommendations[], completeness_score(0-100) }, metadata { template_used, language('pt-BR'), creation_timestamp }.
• Exemplo de Estrutura de Output:

   {
    "report_markdown": "# Relatório Médico\n## Identificação\nNome: João da Silva\n...
    "structured_summary": {
      "sections_filled_map": {"Identificação": true, "Motivo da Consulta": true, ...},
      "completeness_score": 85
    },
    "metadata": {
      "template_used": "Padrão",
      "language": "pt-BR",
      "creation_timestamp": "2025-08-12T13:22:00"
    }
  } 

• Número de caracteres esperado: O report_package gerado deve ser claro e direto, com um tamanho estimado em 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: 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 Verificador de Conformidade e Completude (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente Verificador de Conformidade e Completude (RF 3).

Auditar o report_package para checar padronização, seções obrigatórias, consistência e prontidão para revisão clínica.

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 como input um report_package produzido pelo Agente Redator e, opcionalmente, checklist institucional com regras de obrigatoriedade por tipo de atendimento.
• 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é 10.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um compliance_report: { completeness_score, nonconformities[{code, section, description, severity}], missing_sections[], inconsistencies[], privacy_notes[], approval_recommendation ('aprovar' | 'ajustes necessários'), reviewer_briefing (sumário objetivo), ready_for_review (true/false) }.
• Exemplo de Estrutura de Output:

   {
    "completeness_score": 85,
    "nonconformities": [{"code": "SEC-REQ", "section": "Avaliação", "description": "Seção ausente", "severity": "alta"}],
    "approval_recommendation": "ajustes necessários",
    "ready_for_review": true
  } 

• Número de caracteres esperado: O compliance_report gerado deve ser claro e direto, com um tamanho estimado em 2.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 subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Consolidação Pós-Revisã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 Consolidação Pós-Revisão Clínica (RF 4).

Aplicar as edições do profissional de saúde ao relatório, consolidar alterações e emitir a versão final padronizada.

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 como input um report_package, compliance_report e as edições/anotações do revisor humano (diff textual ou instruções pontuais).
• 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é 12.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um final_package: { final_report_markdown, final_structured_json (mesmo schema do report_package, atualizado), change_log[{section, change_type, before, after, reason}], approval_status ('aprovado'|'reprovado'|'aprovado com ressalvas'), final_completeness_score, sign_off_block { reviewer_name, role, date_time } }.
• Exemplo de Estrutura de Output:

   {
    "final_report_markdown": "# Relatório Médico Final\n## Identificação\nNome: João da Silva\n...",
    "final_structured_json": {...},
    "change_log": [{"section": "Avaliação", "change_type": "edit", "before": "Hipótese A", "after": "Hipótese B", "reason": "override revisor"}],
    "approval_status": "aprovado",
    "final_completeness_score": 90,
    "sign_off_block": {"reviewer_name": "Dr. José", "role": "Médico Revisor", "date_time": "2025-08-12T14:00:00"}
  } 

• Número de caracteres esperado: O final_package gerado deve ser claro e direto, com um tamanho estimado em 10.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 é o entregável final e não é passada para outros agentes internos.

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

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