Agente de IA para Registro e Síntese de Atendimentos Médicos

Realizar a transcrição do áudio do atendimento médico para texto em português do Brasil, preservando marcações de falante quando 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 um arquivo de áudio do atendimento médico 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 áudio na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um arquivo de áudio do atendimento médico.
• Formatos Suportados: Esse agente deve ser capaz de receber áudios nos formatos: .mp3, .wav, .m4a.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 90.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um texto transcrito contendo as falas do médico e do paciente, com marcações de falante e timestamps.
• Exemplo de Estrutura de Output:

   Médico: Olá, como você está se sentindo hoje?
  Paciente: Estou sentindo uma dor na região do peito há dois dias.
  Médico: Você pode descrever a dor?
  [00:02:15] Paciente: É uma dor aguda que piora quando respiro fundo. 

• Número de caracteres esperado: O texto final deve ser conciso e informativo, com um tamanho estimado em torno de 4.500 caracteres, podendo variar conforme a complexidade do atendimento transcrito.

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 Extração e Estruturação Clínica (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Extração e Estruturação Clínica (RF 2).

Converter o texto do atendimento (transcrito ou digitado) em um JSON clínico estruturado pronto para integração com o prontuário.

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 texto transcrito do atendimento médico.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .txt (Texto Plano).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 90.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo as informações clínicas estruturadas.
• Exemplo de Estrutura de Output:

   {
    "identificacao_atendimento": { "id_atendimento": "12345", "id_paciente": "67890", "nome_paciente": "João Silva", "sexo": "M", "idade_anos": 45, "peso_kg": 80 },
    "queixa_principal": "Dor no peito",
    "HPI": { "inicio": "Há dois dias", "curso": "Dor aguda que piora ao respirar fundo", "sintomas_associados": ["Dispneia"], "fatores_agravantes": ["Movimento"], "fatores_amenizantes": ["Repouso"], "antecedentes_relevantes_para_HPI": [] },
    "antecedentes": { "patologicos": [], "cirurgicos": [], "familiares": [], "obstetricos": [], "sociais": [] },
    "alergias": { "possui": false, "itens": [] },
    "medicacoes_uso": [],
    "sinais_vitais": { "pas_mmHg": 120, "pad_mmHg": 80, "fc_bpm": 75, "fr_irpm": 18, "temp_c": 36.5, "spO2_pct": 98, "glicemia_mgdl": null },
    "exame_fisico": { "geral": "Paciente consciente e orientado", "sistemas": [{ "sistema": "Cardiovascular", "achados": "Ritmo cardíaco regular" }] },
    "hipoteses_diagnosticas": [{ "descricao": "Angina", "prioridade": 1, "evidencias": ["Dor no peito", "Dispneia"] }],
    "conduta_plano": { "medidas_imediatas": ["Oxigênio suplementar"], "exames": ["ECG", "Ecodopplercardiograma"], "encaminhamentos": ["Cardiologista"], "seguimento": "Retorno em uma semana" },
    "exames_solicitados": [{ "nome": "ECG", "justificativa": "Avaliar função cardíaca", "urgencia": "alta" }],
    "prescricoes": [{ "principio_ativo_ou_nome": "AAS", "dose": "100mg", "via": "VO", "frequencia": "1x ao dia", "duracao": "Indefinido", "indicacoes_especiais": "Tomar com água" }],
    "orientacoes": ["Evitar esforços físicos excessivos"],
    "risco_urgente": true,
    "red_flags": ["Dor torácica com dispneia"],
    "carimbos_de_tempo": { "data_hora_inicio_atendimento": "2025-12-10T03:00:00Z", "data_hora_fim_atendimento": "2025-12-10T03:30:00Z", "fuso": "GMT-3" },
    "pendencias_de_informacao": [],
    "provenance": { "fonte_texto": "transcricao", "versao_esquema": "1.0", "avisos": [] }
  } 

• Número de caracteres esperado: A estimativa é que o JSON gerado contenha aproximadamente 2.500 caracteres, variando de acordo com a complexidade do atendimento médico.

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 (JSON) gerada por este agente deve ser visível para o Agente de Codificação e Normalização Terminológica (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Codificação e Normalização Terminológica (RF 3).

Atribuir códigos padronizados (CID-10 e, quando aplicável, SNOMED CT) às hipóteses diagnósticas e normalizar termos de procedimentos e medicamentos.

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 JSON clínico estruturado do atendimento médico.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 90.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON enriquecido com códigos padronizados e normalizações.
• Exemplo de Estrutura de Output:

   {
    "identificacao_atendimento": { "id_atendimento": "12345", "id_paciente": "67890", "nome_paciente": "João Silva", "sexo": "M", "idade_anos": 45, "peso_kg": 80 },
    "queixa_principal": "Dor no peito",
    "HPI": { "inicio": "Há dois dias", "curso": "Dor aguda que piora ao respirar fundo", "sintomas_associados": ["Dispneia"], "fatores_agravantes": ["Movimento"], "fatores_amenizantes": ["Repouso"], "antecedentes_relevantes_para_HPI": [] },
    "antecedentes": { "patologicos": [], "cirurgicos": [], "familiares": [], "obstetricos": [], "sociais": [] },
    "alergias": { "possui": false, "itens": [] },
    "medicacoes_uso": [],
    "sinais_vitais": { "pas_mmHg": 120, "pad_mmHg": 80, "fc_bpm": 75, "fr_irpm": 18, "temp_c": 36.5, "spO2_pct": 98, "glicemia_mgdl": null },
    "exame_fisico": { "geral": "Paciente consciente e orientado", "sistemas": [{ "sistema": "Cardiovascular", "achados": "Ritmo cardíaco regular" }] },
    "hipoteses_diagnosticas": [{ "descricao": "Angina", "prioridade": 1, "evidencias": ["Dor no peito", "Dispneia"], "codificacoes": { "diagnosticos_cid10": [{ "codigo": "I20.0", "descricao": "Angina instável", "confianca": 0.9 }], "snomed": { "code": "233604007", "term": "Unstable angina" } } }],
    "conduta_plano": { "medidas_imediatas": ["Oxigênio suplementar"], "exames": ["ECG", "Ecodopplercardiograma"], "encaminhamentos": ["Cardiologista"], "seguimento": "Retorno em uma semana" },
    "exames_solicitados": [{ "nome": "ECG", "justificativa": "Avaliar função cardíaca", "urgencia": "alta" }],
    "prescricoes": [{ "principio_ativo_ou_nome": "AAS", "dose": "100mg", "via": "VO", "frequencia": "1x ao dia", "duracao": "Indefinido", "indicacoes_especiais": "Tomar com água" }],
    "orientacoes": ["Evitar esforços físicos excessivos"],
    "risco_urgente": true,
    "red_flags": ["Dor torácica com dispneia"],
    "carimbos_de_tempo": { "data_hora_inicio_atendimento": "2025-12-10T03:00:00Z", "data_hora_fim_atendimento": "2025-12-10T03:30:00Z", "fuso": "GMT-3" },
    "pendencias_de_informacao": [],
    "provenance": { "fonte_texto": "transcricao", "versao_esquema": "1.0", "avisos": [] }
  } 

• Número de caracteres esperado: A estimativa é que o JSON enriquecido contenha aproximadamente 3.000 caracteres, dependendo da quantidade de códigos e normalizações aplicadas.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

3.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• 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 (JSON enriquecido) deve ser visível para o Agente de Validação de Consistência Clínica e Compliance (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Validação de Consistência Clínica e Compliance (RF 4).

Checar coerência clínica, faixas de referência, conflitos e completude mínima antes do envio ao prontuá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: Este agente deve ser apto a receber como input um JSON clínico estruturado e codificado.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 90.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON com listas de inconsistências, recomendações e o campo pronto_para_envio.
• Exemplo de Estrutura de Output:

   {
    "identificacao_atendimento": { "id_atendimento": "12345", "id_paciente": "67890", "nome_paciente": "João Silva", "sexo": "M", "idade_anos": 45, "peso_kg": 80 },
    "queixa_principal": "Dor no peito",
    "HPI": { "inicio": "Há dois dias", "curso": "Dor aguda que piora ao respirar fundo", "sintomas_associados": ["Dispneia"], "fatores_agravantes": ["Movimento"], "fatores_amenizantes": ["Repouso"], "antecedentes_relevantes_para_HPI": [] },
    "antecedentes": { "patologicos": [], "cirurgicos": [], "familiares": [], "obstetricos": [], "sociais": [] },
    "alergias": { "possui": false, "itens": [] },
    "medicacoes_uso": [],
    "sinais_vitais": { "pas_mmHg": 120, "pad_mmHg": 80, "fc_bpm": 75, "fr_irpm": 18, "temp_c": 36.5, "spO2_pct": 98, "glicemia_mgdl": null },
    "exame_fisico": { "geral": "Paciente consciente e orientado", "sistemas": [{ "sistema": "Cardiovascular", "achados": "Ritmo cardíaco regular" }] },
    "hipoteses_diagnosticas": [{ "descricao": "Angina", "prioridade": 1, "evidencias": ["Dor no peito", "Dispneia"], "codificacoes": { "diagnosticos_cid10": [{ "codigo": "I20.0", "descricao": "Angina instável", "confianca": 0.9 }], "snomed": { "code": "233604007", "term": "Unstable angina" } } }],
    "conduta_plano": { "medidas_imediatas": ["Oxigênio suplementar"], "exames": ["ECG", "Ecodopplercardiograma"], "encaminhamentos": ["Cardiologista"], "seguimento": "Retorno em uma semana" },
    "exames_solicitados": [{ "nome": "ECG", "justificativa": "Avaliar função cardíaca", "urgencia": "alta" }],
    "prescricoes": [{ "principio_ativo_ou_nome": "AAS", "dose": "100mg", "via": "VO", "frequencia": "1x ao dia", "duracao": "Indefinido", "indicacoes_especiais": "Tomar com água" }],
    "orientacoes": ["Evitar esforços físicos excessivos"],
    "risco_urgente": true,
    "red_flags": ["Dor torácica com dispneia"],
    "carimbos_de_tempo": { "data_hora_inicio_atendimento": "2025-12-10T03:00:00Z", "data_hora_fim_atendimento": "2025-12-10T03:30:00Z", "fuso": "GMT-3" },
    "pendencias_de_informacao": [],
    "provenance": { "fonte_texto": "transcricao", "versao_esquema": "1.0", "avisos": [] },
    "inconsistencias": [],
    "recomendacoes": [],
    "pronto_para_envio": true
  } 

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.500 caracteres, dependendo das inconsistências e recomendações identificadas.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• 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 (JSON validado) deve ser visível para o Agente de Síntese Narrativa para Prontuário (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 Narrativa para Prontuário (RF 5).

Gerar resumos clínicos claros e padronizados (formato SOAP e Sumário de Atendimento) coerentes com o JSON validado.

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 como input um JSON clínico estruturado e validado.
• Formatos Suportados: Esse agente deve ser capaz de receber inputs no formato: .json (JSON).
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 90.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo no formato JSON contendo os resumos clínicos padronizados e o campo pronto_para_envio.
• Exemplo de Estrutura de Output:

   {
    "nota_SOAP": {
      "S": "Paciente relata dor no peito há dois dias, piora ao respirar fundo.",
      "O": "Sinais vitais: PAS 120 mmHg, PAD 80 mmHg, FC 75 bpm, FR 18 irpm, Temp 36.5°C, SpO2 98%. Achados: Ritmo cardíaco regular.",
      "A": "Hipótese principal: Angina. Evidências: Dor no peito, dispneia.",
      "P": "Medidas imediatas: Oxigênio suplementar. Exames: ECG, Ecodopplercardiograma. Prescrições: AAS 100mg VO 1x ao dia. Orientações: Evitar esforços físicos excessivos."
    },
    "sumario_atendimento": "Paciente de 45 anos, sexo masculino, com dor no peito e dispneia. Hipótese de angina. Medidas imediatas e exames solicitados. Retorno em uma semana.",
    "justificativas_de_codigos": [],
    "pronto_para_envio": true,
    "carimbo": "Gerado automaticamente em 2025-12-10T03:30:00Z"
  } 

• Número de caracteres esperado: O JSON de output terá um tamanho aproximado de 2.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.
• 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 (resumos clínicos) é 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. Os resumos clínicos gerados são o resultado que deve ser disponibilizado ao usuário.