Agente de IA para Atualização de Registros de Pacientes

Receber os dados recém-coletados na admissão e padronizá-los para um modelo canônico, assegurando formato, tipagem, unidades e estrutura consistentes para uso pelos próximos agentes.

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 de admissão de pacientes 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 de um JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um JSON contendo dados brutos coletados durante a admissão.
• 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.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON padronizado, contendo os dados de admissão no formato canônico, juntamente com uma chave de idempotência e informações de normalização.
• Exemplo de Estrutura de Output:

   {
    "patient_input_canonico": {
      "nome": "Maria da Silva",
      "data_nascimento": "1980-01-01",
      "cpf": "12345678909",
      "telefone": "+5511999999999",
      "endereco": {
        "logradouro": "Rua Exemplo",
        "numero": "123",
        "cep": "12345678"
      }
    },
    "schema_valid": true,
    "normalizacoes_aplicadas": ["nome", "telefone"],
    "idempotency_key": "abc123",
    "admission_timestamp_utc": "2025-12-13T10:39:00Z"
  } 

• Número de caracteres esperado: O JSON final deve ser conciso, com um tamanho estimado em torno de 1.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: Utiliza lógica interna para gerar a chave de idempotência.
• 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 Execução de Chamada à API - Buscar Registro Atual do Paciente (RF 2).

1.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 - Buscar Registro Atual do Paciente (RF 2).

Realizar consulta no sistema hospitalar (EHR) para recuperar possíveis registros existentes do paciente com base em identificadores normalizados.

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 um payload JSON contendo possíveis chaves de busca do paciente.
• 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 uma lista de candidatos recuperados do EHR, contendo informações como patient_id, nome, data de nascimento, entre outros.
• Exemplo de Estrutura de Output:

   {
    "candidates": [
      {
        "patient_id": "123",
        "nome": "Maria da Silva",
        "data_nascimento": "1980-01-01",
        "cpf": "12345678909",
        "ultima_atualizacao": "2025-12-13T10:39:00Z"
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.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.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente executa a chamada ao sistema EHR usando o payload recebido.

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

2.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 Matching (RF 3).

Determinar se o paciente de admissão corresponde a um registro existente ou se deve ser criado um novo registro.

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 o JSON canônico do paciente e a lista de candidatos 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é 8.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o status de correspondência, escore de correspondência, ação sugerida e motivos.
• Exemplo de Estrutura de Output:

   {
    "match_status": "match",
    "match_score": 0.98,
    "acao_sugerida": "atualizar",
    "motivos": ["CPF coincide"]
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.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.
• 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 gerada por este agente deve ser visível para o Agente de Validação de Qualidade e Regras de Negócio (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 Qualidade e Regras de Negócio (RF 4).

Avaliar consistência dos dados de admissão versus registro alvo e definir se é seguro prosseguir com atualização automática.

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 o JSON canônico do paciente, o registro alvo do EHR e o status de correspondência.
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o status de validação, lista de inconsistências e alertas, e a decisão de prosseguir com a atualização.
• Exemplo de Estrutura de Output:

   {
    "validacao_status": "apto",
    "inconsistencias": [],
    "alertas": ["Mudança de endereço detectada"],
    "proceed_update": true
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.200 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.
• 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 Composição de Payload de Atualização (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Composição de Payload de Atualização (RF 5).

Construir o delta de atualização conforme as políticas de mesclagem e decisões da validação, pronto para envio ao EHR.

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 o JSON canônico do paciente, o registro alvo do EHR e o status de validação.
• 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.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o delta de atualização, justificativas para cada campo alterado e a decisão de prosseguir com a atualização.
• Exemplo de Estrutura de Output:

   {
    "proceed_update": true,
    "patient_id_alvo": "123",
    "payload_update": {
      "endereco": {
        "logradouro": "Rua Nova",
        "numero": "456"
      }
    },
    "justificativas_por_campo": {
      "endereco": "Mudança recente detectada"
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 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 Execução de Chamada à API - Atualizar Registro (RF 6).

5.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 - Atualizar Registro (RF 6).

Executar a atualização do registro do paciente no EHR com o payload de delta aprovado.

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 o delta de atualização aprovado, pronto para envio ao 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é 5.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o status da atualização, sucesso da operação e quaisquer erros encontrados.
• Exemplo de Estrutura de Output:

   {
    "status_http": 200,
    "sucesso": true,
    "patient_id": "123",
    "versao_nova": "v2"
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 800 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: O agente executa a chamada ao sistema EHR usando o payload de delta aprovado.

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 Consolidação de Resultado e Relato de Inconsistências (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Consolidação de Resultado e Relato de Inconsistências (RF 7).

Produzir o resultado final padronizado e compor mensagem de notificação quando houver inconsistências ou bloqueios.

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 os resultados dos agentes anteriores, incluindo status de atualização e inconsistências.
• 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é 8.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o resumo do resultado, detalhes da ação e notificação, se necessário.
• Exemplo de Estrutura de Output:

   {
    "resumo": {
      "acao": "atualizado",
      "detalhes": {
        "match_status": "match",
        "validacao_status": "apto"
      }
    },
    "notificacao": {
      "necessaria": false
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 1.200 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 Execução de Chamada à API - Enviar Notificação (RF 8).

7.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 - Enviar Notificação (RF 8).

Enviar notificação à equipe hospitalar sobre inconsistências, bloqueios ou resultados relevantes.

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 payload de notificação pronto para envio.
• 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é 3.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o status do envio, sucesso da operação e protocolo de envio.
• Exemplo de Estrutura de Output:

   {
    "status_http": 200,
    "sucesso": true,
    "protocolo_envio": "notif-123"
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 500 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: O agente executa a chamada ao sistema de mensageria usando o payload de notificação recebido.

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 é o entregável final e não é passada para outros agentes internos.

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

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