Agente de IA para Gestão de Recursos em Tempo Real

Construir, a partir das configurações recebidas, os payloads prontos para as chamadas às APIs de ocupação de leitos e disponibilidade de profissionais.

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 configurações 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 são as configurações para chamadas às APIs, incluindo hospital_id, unidades, periodo_referencia e endpoints.
• 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é 10.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os payloads prontos para as chamadas às APIs de leitos e profissionais. Cada payload deve incluir URL, método, headers e query_or_body com as chaves exigidas.
• Exemplo de Estrutura de Output:

   {
    "payload_leitos": {"url": "string", "metodo": "GET|POST", "headers": {"Authorization": "string", "Content-Type": "string"}, "query_or_body": {"hospital_id": "string", "unidades": ["string"], "periodo": {"fim_iso": "YYYY-MM-DDTHH:MM:SSZ", "inicio_iso": "YYYY-MM-DDTHH:MM:SSZ"}}},
    "payload_profissionais": {"url": "string", "metodo": "GET|POST", "headers": {"Authorization": "string", "Content-Type": "string"}, "query_or_body": {"hospital_id": "string", "unidades": ["string"], "periodo": {"fim_iso": "YYYY-MM-DDTHH:MM:SSZ", "inicio_iso": "YYYY-MM-DDTHH:MM:SSZ"}}} 
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado 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: Utiliza lógica interna para cálculo de datas e horários.
• 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 - Ocupação de Leitos (RF 2) e o Agente de Execução de Chamada à API - Disponibilidade de Profissionais (RF 4).

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 - Ocupação de Leitos (RF 2).

Realizar chamada à API do sistema hospitalar para obter dados brutos de ocupação de leitos.

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 para a chamada à API de ocupação de leitos.
• 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é 5.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 de leitos, conforme o formato exigido pelo sistema hospitalar.
• Exemplo de Estrutura de Output:

   {
    "dados_leitos_raw": [ {"unidade": "string", "leito_id": "string", "status": "OCUPADO|LIVRE|RESERVADO|MANUTENCAO", "tipo": "UTI|ENF|APOIO", "ultima_atualizacao": "ISO"} ],
    "meta": {"retorno_em": "ISO", "fonte": "SIS-Leitos"} 
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.000 caracteres.

2.3.3 Parâmetros de Geração

• Modelo: 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 payload recebido para a API externa e retornar os dados brutos 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 Cálculo de Indicadores 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 Cálculo de Indicadores de Leitos (RF 3).

Transformar os dados brutos de leitos em métricas operacionais padronizadas e detectar condições de alerta.

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 de leitos.
• 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é 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as métricas operacionais de leitos e os sinais de alerta identificados.
• Exemplo de Estrutura de Output:

   {
    "leitos": {"resumo_geral": {"total": 0, "ocupados": 0, "disponiveis": 0, "reservados": 0, "manutencao": 0, "taxa_ocupacao": 0.0}, "por_unidade": [ {"unidade": "string", "total": 0, "ocupados": 0, "disponiveis": 0, "reservados": 0, "manutencao": 0, "taxa_ocupacao": 0.0} ] },
    "sinais": {"alerta_taxa_ocupacao_acima_90": true|false, "unidades_criticas": ["string"]},
    "timestamp_calculo": "ISO" 
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 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: Utiliza lógica interna para cálculo de métricas e alertas.
• Busca Online: Não utiliza.
• Sistemas Externos: Não se conecta a sistemas externos.

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 Consolidação Operacional (RF 6).

3.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 Profissionais (RF 4).

Realizar chamada à API do sistema de RH/escala para obter dados brutos de disponibilidade de profissionais.

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 1).
• Tipo do input: Este agente deve ser apto a receber como input um JSON contendo o payload para a chamada à API de disponibilidade de profissionais.
• 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é 5.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo os dados brutos de disponibilidade de profissionais, conforme o formato exigido pelo sistema de RH.
• Exemplo de Estrutura de Output:

   {
    "dados_profissionais_raw": [ {"profissional_id": "string", "categoria": "MEDICO|ENFERMEIRO|TECNICO|FISIOTERAPEUTA|OUTROS", "unidade": "string", "status": "DISPONIVEL|EM_ATENDIMENTO|AFASTADO|EM_PAUSA", "inicio_turno": "ISO", "fim_turno": "ISO"} ],
    "meta": {"retorno_em": "ISO", "fonte": "SIS-RH"} 
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: Não se aplica (uso de ferramenta)

4.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 payload recebido para a API externa e retornar os dados brutos como resposta.

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 Normalização e Cálculo de Indicadores de Profissionais (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Normalização e Cálculo de Indicadores de Profissionais (RF 5).

Transformar os dados brutos de profissionais em métricas operacionais padronizadas e detectar condições de alerta.

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 os dados brutos de disponibilidade de profissionais.
• 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é 5.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as métricas operacionais de profissionais e os sinais de alerta identificados.
• Exemplo de Estrutura de Output:

   {
    "profissionais": {"resumo_geral": {"total_em_turno": 0, "disponiveis": 0, "em_atendimento": 0, "afastados": 0, "em_pausa": 0, "taxa_disponibilidade": 0.0}, "por_unidade": [ {"unidade": "string", "total_em_turno": 0, "disponiveis": 0, "em_atendimento": 0, "taxa_disponibilidade": 0.0, "mix": {"MEDICO": 0, "ENFERMEIRO": 0, "TECNICO": 0, "FISIOTERAPEUTA": 0, "OUTROS": 0}} ] },
    "sinais": {"alerta_disponibilidade_abaixo_20": true|false, "unidades_criticas": ["string"]},
    "timestamp_calculo": "ISO" 
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.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 cálculo de métricas e alertas.
• 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 Consolidação Operacional (RF 6).

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

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

Unificar os indicadores de leitos e profissionais em um quadro único padronizado por unidade e geral.

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 3).
• Tipo do input: Este agente deve ser apto a receber como input dois artefatos: métricas operacionais de leitos e métricas operacionais de profissionais.
• 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 combinado de até 10.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o quadro unificado de indicadores operacionais e os riscos gerais identificados.
• Exemplo de Estrutura de Output:

   {
    "situacao_operacional": {"geral": {"taxa_ocupacao": 0.0, "taxa_disponibilidade": 0.0, "risco": "BAIXO|MEDIO|ALTO"}, "por_unidade": [ {"unidade": "string", "taxa_ocupacao": 0.0, "taxa_disponibilidade": 0.0, "ratio_paciente_por_enfermeiro": 0.0, "classificacao": "OK|ATENCAO|CRITICO"} ] },
    "sinais_globais": {"congestao": true|false, "escassez_profissionais": true|false},
    "timestamp_consolidacao": "ISO" 
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 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: Utiliza lógica interna para cálculo de métricas e alertas.
• 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 Otimização de Alocação de Recursos (RF 7).

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

Ao concluir sua execução, esse agente aciona o Agente de Otimização de Alocação de Recursos (RF 7).

Gerar recomendações práticas de realocação de profissionais e gestão de leitos para maximizar a eficiência do atendimento.

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 como input um JSON contendo o quadro unificado de indicadores operacionais e restrições operacionais.
• 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é 10.000 caracteres.

7.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo as recomendações práticas de alocação de recursos e a priorização de ações.
• Exemplo de Estrutura de Output:

   {
    "recomendacoes": [ {"tipo": "REALOCACAO_PROFISSIONAIS|TRANSFERENCIA_PACIENTES|ABERTURA_FECHAMENTO_LEITOS|AJUSTE_ESCALA", "descricao": "string", "unidade_origem": "string|null", "unidade_destino": "string|null", "quantidade": 0, "justificativa": "string", "impacto_esperado": {"delta_taxa_ocupacao": 0.0, "delta_taxa_disponibilidade": 0.0, "melhora_ratio": 0.0} } ],
    "priorizacao": [ {"id_recomendacao": 0, "prioridade": "ALTA|MEDIA|BAIXA"} ],
    "flags": {"nenhuma_acao_necessaria": true|false} 
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 5.000 caracteres.

7.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

7.3.4 Ferramentas do Agente

• Documentos: O conteúdo do documento "Políticas de Gestão Hospitalar" é inserido integralmente na janela de contexto, ao final do prompt principal, para garantir que o agente tenha acesso às informações mais atualizadas sobre políticas e restrições durante a geração da resposta.
• Calculadora: Utiliza lógica interna para cálculo de impacto esperado.
• Busca Online: Não utiliza.
• Sistemas Externos: O output pode ser encaminhado ao sistema de gestão hospitalar para registro/execução das recomendações conforme políticas locais.

7.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções deste agente podem ser acessadas posteriormente para fins de auditoria.
• Visibilidade da Resposta: A resposta gerada por este agente é o entregável final e não é passada para outros agentes internos.

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

A execução deste agente finaliza o fluxo. As recomendações geradas são o resultado que deve ser disponibilizado ao usuário.