Agente de IA para Relatórios de Ocupação e Turnover de Leitos

Construir parâmetros padronizados para recuperar dados de ocupação e eventos de turnover de leitos a partir dos sistemas internos.

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 configuração via API. Na fase de testes, os dados serão enviados pelo agente diretamente por upload de um arquivo JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um arquivo JSON contendo parâmetros de configuração.
• Formatos Suportados: Esse agente deve ser capaz de receber arquivos nos formatos: .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os parâmetros de consulta padronizados e validados.
• Exemplo de Estrutura de Output:

   {
    "payload_api_ocupacao": {"endpoint": "/leitos/ocupacao", "query": {"desde": "2025-12-17T09:06:00-03:00", "ate": "2025-12-17T09:21:00-03:00", "hospital_id": "H001", "unidades": ["UTI Adulto","Enfermaria"], "status": ["OCUPADO","LIVRE","EM_LIMPEZA"], "limite": 1000, "offset": 0 }},
    "payload_api_turnover": {"endpoint": "/leitos/eventos", "query": {"desde": "2025-12-17T09:06:00-03:00", "ate": "2025-12-17T09:21:00-03:00", "tipos_evento": ["ADMISSAO","ALTA","LIMPEZA_INICIO","LIMPEZA_FIM","PRONTO_PARA_OCUPACAO"], "hospital_id": "H001", "limite": 1000, "offset": 0 }},
    "timezone_padrao": "America/Sao_Paulo"
  } 

• Número de caracteres esperado: O JSON gerado deve ser conciso e informativo, 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: 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 (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 (RF 2).

Realizar chamadas às APIs internas para obter dados de ocupação de leitos e eventos de turnover na janela definida.

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: Este agente deve ser apto a receber como input um JSON contendo os parâmetros de consulta padronizados.
• 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é 1.500 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo dados crus de ocupação e eventos de turnover.
• Exemplo de Estrutura de Output:

   {
    "raw_ocupacao": [ {"leito_id": "L-101", "unidade": "UTI Adulto", "status": "OCUPADO", "paciente_id": "P123", "timestamp": "2025-12-17T09:19:42-03:00" }, ... ],
    "raw_eventos": [ {"evento_id": "E-9001", "leito_id": "L-101", "tipo": "ALTA", "timestamp": "2025-12-17T09:10:00-03:00" }, ... ]
  } 

• Número de caracteres esperado: O JSON gerado deve conter dados relevantes, com um tamanho estimado em torno de 3.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: Não aplicável (uso de ferramenta)
• Temperatura: Não aplicável

2.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: Este agente realiza chamadas a sistemas externos para obter dados de ocupação e turnover.

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 Normalização e Qualidade de Dados de Leitos (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Normalização e Qualidade de Dados de Leitos (RF 3).

Padronizar, higienizar e validar dados crus de ocupação e eventos para uso analítico consistente.

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: Este agente deve ser apto a receber como input um JSON contendo dados crus de ocupação e eventos de turnover.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo dados normalizados de ocupação e eventos, além de um relatório de qualidade.
• Exemplo de Estrutura de Output:

   {
    "ocupacao_norm": [ {"leito_id":"L-101","unidade":"UTI Adulto","status":"OCUPADO","paciente_id":"P123","ts":"2025-12-17T09:19:42-03:00"}, ... ],
    "eventos_norm": [ {"evento_id":"E-9001","leito_id":"L-101","tipo":"ALTA","ts":"2025-12-17T09:10:00-03:00"}, ... ],
    "relatorio_qualidade": {"registros_invalidos": 2, "motivos": {"status_desconhecido":1, "timestamp_invalido":1}, "duplicatas_removidas": 5}
  } 

• Número de caracteres esperado: O JSON gerado deve ser detalhado, com um tamanho estimado em torno de 4.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 Cálculo de Indicadores de Ocupação e Turnover (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Cálculo de Indicadores de Ocupação e Turnover (RF 4).

Calcular métricas operacionais de capacidade e giro de leitos por unidade e gerais.

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: Este agente deve ser apto a receber como input um JSON contendo dados normalizados de ocupação e eventos.
• 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é 4.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as métricas operacionais calculadas para ocupação e turnover de leitos.
• Exemplo de Estrutura de Output:

   {
    "kpis": {"timestamp_referencia": "2025-12-17T09:21:00-03:00", "geral": {"ocupacao": 0.78, "leitos_ocupados": 117, "leitos_disponiveis": 33, "turnover_h": 0.19, "alocacao_sobra": 0.22, "alos_h": 72.5, "t_limpeza_med_min": 32}, "por_unidade": [{"unidade":"UTI Adulto","ocupacao":0.9,"leitos_ocupados":27,"leitos_disponiveis":3,"turnover_h":0.12,"alos_h":96.0,"t_limpeza_med_min":40},{"unidade":"Enfermaria","ocupacao":0.75,"leitos_ocupados":90,"leitos_disponiveis":30,"turnover_h":0.22,"alos_h":60.5,"t_limpeza_med_min":28}] }, "derivacoes": {"taxa_bloqueio": 0.03, "leitos_bloqueados": 5} }
  } 

• Número de caracteres esperado: O JSON gerado deve ser abrangente, com um tamanho estimado em torno de 3.500 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: Utiliza lógica interna para cálculos de métricas.
• 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 Detecção de Anomalias e Gargalos (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Detecção de Anomalias e Gargalos (RF 5).

Identificar desvios operacionais relevantes e sugerir ações imediatas.

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: Este agente deve ser apto a receber como input um JSON contendo métricas operacionais de ocupação e turnover.
• 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.500 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo alertas operacionais e ações sugeridas.
• Exemplo de Estrutura de Output:

   {
    "alertas": [ {"unidade": "UTI Adulto", "tipo": "ocupacao_alta", "valor": 0.92, "limiar": 0.9, "severidade": "alta", "acao_sugerida": "Priorizar altas clinicamente elegíveis e coordenar limpeza imediata"}, ... ]
  } 

• Número de caracteres esperado: O JSON gerado deve ser conciso e direto, com um tamanho estimado em torno 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 gerada por este agente deve ser visível para o Agente de Geração de Relatório Operacional de Leitos (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatório Operacional de Leitos (RF 6).

Produzir relatório de ocupação e turnover em formato legível e com seções padronizadas para gestão de capacidade.

6.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 5).
• Tipo do input: Este agente deve ser apto a receber como input um JSON contendo métricas operacionais e alertas.
• 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 texto estruturado contendo o relatório de ocupação e turnover.
• Exemplo de Estrutura de Output:

  Texto estruturado com: cabeçalho (hospital, data/hora referência, janela), resumo executivo (KPIs gerais), seções por unidade (ocupação, disponíveis, turnover, ALOS, limpeza), alertas e ações sugeridas, apêndice de qualidade de dados (se aplicável).

• Número de caracteres esperado: O texto gerado deve ser detalhado e abrangente, com um tamanho estimado em torno de 6.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.
• Calculadora: Utiliza lógica interna para formatação e cálculos simples.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

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

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

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