Agente de IA para Gestão de Reservas de Quartos Hospitalares

Transformar a solicitação do usuário em parâmetros estruturados para consulta de disponibilidade de quartos e recuperação de dados clínicos e preferências do paciente.

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 estruturados 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 arquivo 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, que inclui preferências e requisitos médicos do paciente.
• 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 até 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo parâmetros estruturados para consulta de disponibilidade de quartos e recuperação de dados clínicos e preferências do paciente.
• Exemplo de Estrutura de Output:

   {
    "availability_params": {
      "unidades": ["string"],
      "alas": ["string"],
      "tipos_permitidos": ["individual","duplo","isolamento","UTI"],
      "requisitos_infra": ["oxigenio","monitorizacao","acessibilidade"],
      "intervalo": {"inicio": "ISO8601", "fim": "ISO8601"}
    },
    "patient_params": { "patient_id": "string" },
    "contexto_preferencias": { ...cópia_normalizada_de_preferencias },
    "contexto_requisitos": { ...cópia_normalizada_de_requisitos_medicos },
    "acao": "alocar_paciente" | "consultar_disponibilidade"
  } 

• Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em 2.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: 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 - Disponibilidade de Quartos (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 - Disponibilidade de Quartos (RF 2).

Realizar chamada à API do Sistema hospital_room_availability para obter a disponibilidade de quartos no intervalo solicitado.

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 JSON contendo parâmetros estruturados para consulta de disponibilidade de quartos.
• 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.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos de disponibilidade de quartos.
• Exemplo de Estrutura de Output:

   { "availability_raw": [ {"room_id":"string","numero":"string","tipo":"individual|duplo|isolamento|UTI","ala":"string","andar":"string","unidade":"string","ocupacao":"livre|ocupado|manutencao","equipamentos":["..."],"isolamento":"nenhum|contato|goticulas|aerossol","sexo_permitido":"M|F|ambos","acessibilidade":true,"previsao_alta":"ISO8601|null"} ] } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 3.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: O agente se conecta ao sistema hospital_room_availability para obter os dados.

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 Analítico de Consolidação de Dados (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente Analítico de Consolidação de Dados (RF 4).

Realizar chamada à API do Prontuário (EHR) para recuperar dados clínicos resumidos e restrições do paciente.

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 um JSON contendo parâmetros estruturados para recuperação de dados clínicos 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 até 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados clínicos resumidos do paciente.
• Exemplo de Estrutura de Output:

   { "patient_raw": { "patient_id":"string", "sexo":"M|F", "diagnosticos":["CID..."], "preciso_isolamento":"nenhum|contato|goticulas|aerossol", "especialidade_referente":"string", "equipamentos_necessarios":["..."], "mobilidade_reduzida": true|false, "imunossuprimido": true|false } } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 3.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: O agente se conecta ao sistema EHR para obter os dados do paciente.

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 Analítico de Consolidação de Dados (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente Analítico de Consolidação de Dados (RF 4).

Unificar availability_raw, patient_raw e contexto de preferências/requisitos em um dataset filtrado para decisão.

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 múltiplos JSONs contendo dados brutos de disponibilidade de quartos, dados clínicos do paciente e contexto de preferências e requisitos.
• 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 combinado de até 10.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo candidatos filtrados, motivos de exclusão, dados normalizados do paciente e preferências.
• Exemplo de Estrutura de Output:

   {
    "candidatos_filtrados": [ {...quarto} ],
    "motivos_exclusao": [ {"room_id":"string","motivo":"string"} ],
    "dados_paciente_norm": {...},
    "preferencias_norm": {...} } 

• Número de caracteres esperado: O JSON gerado deve ter 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: 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 deve ser visível para o Agente Analítico de Ranqueamento e Seleção de Quarto (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente Analítico de Ranqueamento e Seleção de Quarto (RF 5).

Pontuar candidatos filtrados considerando preferências como soft constraints e escolher a melhor opção determinística.

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 um JSON contendo candidatos filtrados, dados normalizados do paciente e preferê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 até 8.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a recomendação de quarto, justificativa e score total, além de alternativas e viabilidade de alocação.
• Exemplo de Estrutura de Output:

   {
    "recommendation": {
      "room_id":"string",
      "justificativa":"string",
      "score_total": number,
      "componentes_score": {"proximidade_unidade": number, "tipo_quarto": number, "amenidades": number, "balanceamento_ocupacao": number},
      "restricoes_atendidas": ["string"],
      "preferencias_atendidas": ["string"],
      "preferencias_nao_atendidas": ["string"]
    },
    "alternativas": [ {"room_id":"string","score_total":number} ],
    "alocacao_viavel": true|false
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 5.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: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 Preparação de Reserva (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Preparação de Reserva (RF 6).

Gerar o payload final para efetivar a reserva do quarto recomendado ou de uma alternativa explicitamente escolhida pelo usuário.

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 um JSON contendo a recomendação de quarto, alternativas e dados clínicos 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 até 8.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o payload de reserva e validação pré-envio.
• Exemplo de Estrutura de Output:

   {
    "booking_payload": { "patient_id":"string", "room_id":"string", "inicio":"ISO8601", "fim":"ISO8601", "motivo":"internacao|observacao|pos_operatorio|...", "observacoes":"string" },
    "validacao_pre_envio": { "ok": true|false, "erros": ["string"] }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 4.000 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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 Execução de Chamada à API - Efetivar Reserva (RF 7).

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

Ao concluir sua execução, o fluxo avalia o output. Se o campo validacao_pre_envio.ok for true, esse agente aciona o Agente de Execução de Chamada à API - Efetivar Reserva (RF 7). Caso contrário, aciona o Agente Analítico de Escalonamento para Revisão Humana (RF 8).

Realizar chamada à API hospital_room_management para criar/atualizar a reserva do quarto selecionado.

7.3.1 Condições de Ativação

Este agente é acionado somente se a seguinte condição for atendida:

• O campo validacao_pre_envio.ok no output do Agente de Preparação de Reserva (RF 6) é igual a true.

7.3.2 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado condicionalmente após a conclusão do agente anterior (RF 6), apenas se a validação pré-envio for bem-sucedida.
• Tipo do input: Este agente deve ser apto a receber um JSON contendo o payload de reserva validado.
• 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.

7.3.3 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o resultado da reserva.
• Exemplo de Estrutura de Output:

   { "booking_result": { "status":"confirmado|recusado|conflito", "reserva_id":"string|null", "mensagem":"string" } } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 1.000 caracteres.

7.3.4 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

7.3.5 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente se conecta ao sistema hospital_room_management para efetivar a reserva.

7.3.6 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 ponto final da execução do agente condicionado.

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

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

Preparar relatório sucinto para revisão humana quando não houver alocação viável que atenda requisitos críticos.

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 6) se a validação pré-envio falhar.
• Tipo do input: Este agente deve ser apto a receber múltiplos JSONs contendo dados de disponibilidade, dados clínicos do paciente e preferências normalizadas.
• 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 combinado de até 10.000 caracteres.

8.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o relatório sucinto para revisão humana.
• Exemplo de Estrutura de Output:

   { "relatorio_humano": { "patient_id":"string", "resumo_causa":"string", "requisitos_nao_atendidos":["string"], "opcoes_parciais":[{"room_id":"string","violacoes":["string"]}], "sugestoes_de_acao":["string"] } } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 3.000 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 documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 deve ser visível para o Agente Analítico de Aplicação de Decisão Humana (RF 9).

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

Ao concluir sua execução, esse agente aciona o Agente Analítico de Aplicação de Decisão Humana (RF 9).

Aplicar decisão humana aprovada (override) transformando-a em payload de reserva consistente e seguro.

9.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior (RF 8).
• Tipo do input: Este agente deve ser apto a receber um JSON contendo a decisão humana aprovada.
• 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.

9.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o payload de reserva e validação pré-envio.
• Exemplo de Estrutura de Output:

   {
    "booking_payload": { "patient_id":"string", "room_id":"string", "inicio":"ISO8601", "fim":"ISO8601", "motivo":"internacao|observacao|pos_operatorio|...", "observacoes":"Decisão humana: string" },
    "validacao_pre_envio": { "ok": true|false, "erros": ["string"] }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em 4.000 caracteres.

9.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

9.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.

9.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 ponto final da execução do fluxo.

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

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