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

Construir parâmetros e payload canônico para coletar dados de ocupação dos leitos de observação no sistema de gestão hospitalar.

1.3.1 Especificação do Input

• Mecanismo de Acionamento: Este agente é o ponto de partida do fluxo e deve ser acionado pelo envio das configurações de coleta 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 na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um conjunto de configurações estruturadas em JSON.
• 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é 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os parâmetros de coleta e o payload canônico.
• Exemplo de Estrutura de Output:

   {
    "payload_api_ocupacao": {
      "endpoint": "https://api.hospital.com/ocupacao",
      "metodo": "GET",
      "headers": {"Authorization": "Bearer token"},
      "filtros": {
        "setores": ["Setor A", "Setor B"],
        "status_permitidos": ["Ocupado", "Livre"],
        "intervalo_diario_utc": ["2025-12-05T14:55:00Z", "2025-12-06T14:55:00Z"],
        "intervalo_semanal_utc": ["2025-11-29T14:55:00Z", "2025-12-06T14:55:00Z"]
      },
      "campos_solicitados": ["leito_id", "setor_id", "status_atual", "timestamp_evento"],
      "granularidade_min": 15
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 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 (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 chamada à API do Sistema HIS para obter dados brutos de ocupação de leitos de observação com base no payload preparado.

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 contendo o payload API preparado.
• 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é 2.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos de ocupação.
• Exemplo de Estrutura de Output:

   {
    "dados_brutos_ocupacao": {
      "registros": [
        {"leito_id": "L001", "setor_id": "Setor A", "timestamp_evento_utc": "2025-12-06T13:00:00Z", "status_canonico": "Ocupado"},
        {"leito_id": "L002", "setor_id": "Setor B", "timestamp_evento_utc": "2025-12-06T14:00:00Z", "status_canonico": "Livre"}
      ],
      "total_registros": 100,
      "periodo_coletado": {
        "diario": ["2025-12-05T14:55:00Z", "2025-12-06T14:55:00Z"],
        "semanal": ["2025-11-29T14:55:00Z", "2025-12-06T14:55:00Z"]
      }
    }
  } 

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

2.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: Não se aplica (uso de ferramenta)

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 deverá enviar o JSON recebido para a API externa e retornar os dados recebidos como resposta.

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 Consolidação de Dados (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 Consolidação de Dados (RF 3).

Normalizar, validar e consolidar os dados brutos em um dataset canônico e calcular indicadores básicos de ocupação.

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 contendo os dados brutos de ocupaçã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 até 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o dataset normalizado e os indicadores básicos de ocupação.
• Exemplo de Estrutura de Output:

   {
    "dataset_normalizado": {
      "eventos": [
        {"leito_id": "L001", "setor_id": "Setor A", "timestamp_evento_utc": "2025-12-06T13:00:00Z", "status_canonico": "Ocupado"}
      ],
      "series_15min": [
        {"intervalo_inicio_utc": "2025-12-06T13:00:00Z", "intervalo_fim_utc": "2025-12-06T13:15:00Z", "leitos_totais": 50, "ocupados": 30, "livres": 15, "indisponiveis": 5, "taxa_ocupacao": 0.75}
      ]
    },
    "indicadores_basicos": {
      "total_leitos": 50,
      "ocupados_atual": 30,
      "disponiveis_atual": 15,
      "indisponiveis_atual": 5,
      "taxa_ocupacao_atual": 0.75,
      "tempo_medio_estadia_h": 5.5,
      "tempo_medio_espera_min": 30,
      "taxa_rotatividade_diaria": 0.6,
      "registros_inconsistentes": {
        "sem_timestamp": 2,
        "timestamp_futuro": 1,
        "status_nao_mapeado": 3,
        "duplicidades": 1
      }
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 6.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: Utiliza lógica interna para calcular os indicadores de ocupação.
• 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 Análise de Padrões e Gargalos (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Análise de Padrões e Gargalos (RF 4).

Identificar padrões de uso, picos, períodos de subutilização e gargalos operacionais na alocação de leitos de observaçã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 como input um JSON contendo o dataset normalizado e os indicadores básicos de ocupaçã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 até 6.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo a análise de padrões, gargalos e insights acionáveis.
• Exemplo de Estrutura de Output:

   {
    "analise_padroes": {
      "diario": {},
      "semanal": {},
      "gargalos_por_setor": [
        {"setor_id": "Setor A", "motivo": "Superlotação", "evidencias": {"kpis": {}, "intervalos_criticos": []}, "severidade": "Alta"}
      ],
      "alertas": {
        "superlotacao": true,
        "subutilizacao": false,
        "espera_excessiva": false
      },
      "insights_acionaveis_priorizados": [
        {"descricao": "Redistribuir equipe para horários de pico.", "impacto_estimado": "Alto", "effort_baixo_medio_alto": "Baixo", "prioridade": "Alta"}
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 7.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: Utiliza lógica interna para identificar padrões e gargalos.
• 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 Geração de Relatório Diário (RF 5) e o Agente de Geração de Relatório Semanal (RF 6).

4.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 Diário (RF 5).

Produzir o relatório diário de ocupação de leitos de observação com KPIs do período, eventos críticos e recomendações imediatas.

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 contendo a análise de padrões diários e indicadores básicos de ocupaçã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 até 7.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o relatório diário de ocupação de leitos de observação.
• Exemplo de Estrutura de Output:

   {
    "relatorio_diario": {
      "periodo_utc": ["2025-12-05T14:55:00Z", "2025-12-06T14:55:00Z"],
      "kpis": {
        "taxa_ocupacao_media": 0.75,
        "pico_maximo": 0.95,
        "horas_superlotacao": 2,
        "horas_subutilizacao": 3,
        "tempo_medio_estadia_h": 5.5,
        "tempo_medio_espera_p50_p90_min": [30, 90],
        "rotatividade": 0.6
      },
      "destaques": [
        {"titulo": "Superlotação Crítica", "descricao": "Ocorreu superlotação por 2 horas consecutivas.", "evidencias": {}}
      ],
      "recomendacoes_imediatas_top3": [
        {"acao": "Redistribuir equipe", "justificativa": "Superlotação crítica identificada.", "impacto_estimado": "Alto", "effort": "Baixo"}
      ],
      "anexos": {
        "serie_ocupacao_15min": [],
        "tabela_setores": []
      }
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 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: Utiliza lógica interna para calcular os KPIs e recomendações.
• 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 Semanal (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 Semanal (RF 6).

Produzir o relatório semanal com tendências, comparação com a semana anterior e plano de ações 30/60/90 dias.

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 como input um JSON contendo a análise de padrões semanais e indicadores básicos de ocupaçã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 até 8.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o relatório semanal de ocupação de leitos de observação.
• Exemplo de Estrutura de Output:

   {
    "relatorio_semanal": {
      "periodo_utc": ["2025-11-29T14:55:00Z", "2025-12-06T14:55:00Z"],
      "visao_geral": {
        "taxa_ocupacao_media": 0.7,
        "horas_superlotacao_total": 10,
        "horas_subutilizacao_total": 15
      },
      "comparativo_semana_anterior": {
        "delta_taxa_pp": -0.05,
        "delta_horas_superlotacao": 2,
        "delta_espera_p50_p90": [5, 10]
      },
      "gargalos_por_setor_resumo": [
        {"setor_id": "Setor A", "impacto": "Alto", "effort": "Médio"}
      ],
      "plano_acao_30_60_90": {
        "30d": ["Ajustar critérios de reserva"],
        "60d": ["Implementar nova política de turnos"],
        "90d": ["Revisar infraestrutura de leitos"]
      },
      "riscos_e_dependencias": ["Dados insuficientes para comparação completa com semana anterior."],
      "anexos": {
        "tabela_diaria_semana": [],
        "heatmap_ocupacao_semana": []
      }
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 7.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: Utiliza lógica interna para calcular comparativos e planos de ação.
• 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.