1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados e demais requisitos funcionais para o Agente de IA de Gestão de Escalas de Enfermagem. Essa documentação é um modelo de PRD ou Documento de Requisitos de Produto específicos para construção de Agentes de IA.
O objetivo principal é otimizar a programação das escalas de enfermagem, considerando disponibilidade, carga horária e especializações dos profissionais, oferecendo soluções automatizadas para ajustes de última hora.
2. Contexto e Problema
Cenário Atual
A gestão de escalas de enfermagem enfrenta desafios significativos, incluindo:
- Dificuldade em otimizar a programação de escalas considerando disponibilidade, carga horária e especializações dos enfermeiros.
Atualmente, o processo é manual e sujeito a erros que podem afetar a eficiência operacional e a satisfação dos profissionais de saúde.
Problemas Identificados
- Complexidade na Consolidação de Dados: A análise manual de disponibilidade e carga horária é demorada e sujeita a erros.
- Falta de Integração de Preferências: As especializações e preferências dos enfermeiros não são consideradas adequadamente, resultando em escalas subótimas.
- Reatividade a Mudanças: Ajustes de última hora são frequentemente desorganizados e ineficazes, o que pode levar a problemas de cobertura e satisfação.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Otimizar o tempo de criação de escalas em pelo menos 70%.
- Melhorar a satisfação dos profissionais ao considerar suas preferências e especializações.
- Reduzir erros e conflitos nas escalas através de ajustes automatizados e em tempo real.
4. Visão Geral da Solução
O agente de IA para gestão de escalas de enfermagem processa dados de disponibilidade, carga horária e especializações dos enfermeiros para otimizar a programação das escalas, oferecendo ajustes automatizados de última hora. A seguir são detalhadas todas as regras de negócio e especificações funcionais necessárias para que esse agente atue como um assistente útil e autônomo na gestão de escalas de enfermagem.
A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a análise de disponibilidade e carga horária e termina com a geração de escalas ajustadas automaticamente.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo.
| Agentes | Função Principal |
|---|---|
Agente de Análise de Disponibilidade e Carga Horária (RF 1)
| Analisar dados de disponibilidade e carga horária dos enfermeiros. |
Agente de Consideração de Especializações e Preferências (RF 2)
| Considerar as especializações e preferências dos profissionais ao criar escalas. |
Agente de Ajustes Automatizados de Última Hora (RF 3)
| Oferecer soluções automatizadas para ajustes de última hora nas escalas. |
5. Protótipos
Para proporcionar uma visão clara e tangível da solução proposta, criamos protótipos interativos que demonstram tanto o fluxo de trabalho dos agentes quanto o resultado final que o cliente receberá. Explore os links abaixo para entender melhor a solução em ação.
6. Requisitos Funcionais
RF 1. Agente de Análise de Disponibilidade e Carga Horária
1.1 Tarefa do Agente
Analisar dados de disponibilidade e carga horária dos enfermeiros e gerar uma análise consolidada em JSON.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados estruturados contendo disponibilidade e carga horária dos enfermeiros.
# 2. Objetivo
Analisar os dados para identificar disponibilidade, carga horária acumulada e possíveis sobreposições ou lacunas.
# 3. Regras que você deve seguir para gerar sua resposta
- Identifique e registre a disponibilidade de cada enfermeiro em um formato padronizado.
- Calcule a carga horária acumulada de cada enfermeiro e verifique se está dentro dos limites regulamentares.
- Cruze dados de disponibilidade com carga horária para identificar possíveis sobreposições ou lacunas.
- Gere alertas para horários críticos que necessitam de ajustes imediatos.
# 4. Exemplo de Output que você deve produzir
{
"enfermeiro_id": "123",
"disponibilidade": "Seg-Sex: 08:00-16:00",
"carga_horaria_acumulada": "40 horas",
"alertas": ["Sobreposição na quarta-feira"]
} 1.3 Configurações do Agente
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 csv na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: Dados estruturados contendo disponibilidade e carga horária dos enfermeiros.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos:
.csv,.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 20.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo a análise consolidada sobre disponibilidade e carga horária.
-
Exemplo de Estrutura de Output:
{ "enfermeiro_id": "123", "disponibilidade": "Seg-Sex: 08:00-16:00", "carga_horaria_acumulada": "40 horas", "alertas": ["Sobreposição na quarta-feira"] } - Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.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 Consideração de Especializações e Preferências (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Consideração de Especializações e Preferências (RF 2).
RF 2. Agente de Consideração de Especializações e Preferências
2.1 Tarefa do Agente
Considerar as especializações e preferências dos profissionais ao criar escalas, ajustando-as conforme necessário.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo dados sobre especializações e preferências dos enfermeiros.
# 2. Objetivo
Ajustar as escalas de trabalho baseadas em especializações e preferências.
# 3. Regras que você deve seguir para gerar sua resposta
- Mapeie especializações de cada enfermeiro e associe-as às necessidades específicas das unidades de saúde.
- Incorpore preferências pessoais dos enfermeiros, como turnos preferenciais, ao processo de escalonamento.
- Balanceie as preferências com as necessidades operacionais para otimizar a satisfação e a eficiência.
- Sugira ajustes nas escalas se houver conflito entre preferências e necessidades críticas.
# 4. Exemplo de Output que você deve produzir
{
"enfermeiro_id": "123",
"especializacoes": ["Pediatria", "Emergência"],
"preferencias": ["Manhã", "Noite"],
"escalas_ajustadas": ["Segunda: Manhã", "Terça: Noite"]
} 2.3 Configurações do Agente
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: Dados sobre especializações e preferências dos enfermeiros.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos:
.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 10.000 caracteres.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo as escalas ajustadas baseadas em especializações e preferências.
-
Exemplo de Estrutura de Output:
{ "enfermeiro_id": "123", "especializacoes": ["Pediatria", "Emergência"], "preferencias": ["Manhã", "Noite"], "escalas_ajustadas": ["Segunda: Manhã", "Terça: Noite"] } - Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 1.500 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: Não utiliza.
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 (JSON das escalas ajustadas) deve ser visível para o Agente de Ajustes Automatizados de Última Hora (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Ajustes Automatizados de Última Hora (RF 3).
RF 3. Agente de Ajustes Automatizados de Última Hora
3.1 Tarefa do Agente
Oferecer soluções automatizadas para ajustes de última hora nas escalas, garantindo cobertura e eficiência.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais
Você está recebendo eventos ou alterações de última hora que impactam as escalas.
# 2. Objetivo
Atualizar as escalas com ajustes realizados automaticamente.
# 3. Regras que você deve seguir para gerar sua resposta
- Monitore continuamente a entrada de eventos que possam impactar as escalas, como faltas ou emergências.
- Aplique algoritmos de otimização para redistribuir a carga horária sem ultrapassar os limites legais.
- Notifique os enfermeiros afetados por ajustes de última hora de forma imediata.
- Registre todas as alterações realizadas para auditoria e revisão futura.
# 4. Exemplo de Output que você deve produzir
{
"evento": "Falta",
"enfermeiro_afetado": "123",
"ajustes_realizados": ["Substituição no turno de terça-feira"]
} 3.3 Configurações do Agente
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: Eventos ou alterações de última hora que impactam as escalas.
-
Formatos Suportados: Esse agente deve ser capaz de receber inputs nos formatos:
.json. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 5.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um arquivo no formato JSON contendo os ajustes realizados nas escalas.
-
Exemplo de Estrutura de Output:
{ "evento": "Falta", "enfermeiro_afetado": "123", "ajustes_realizados": ["Substituição no turno de terça-feira"] } - Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 800 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 (JSON de ajustes realizados) é o entregável final e não é passada para outros agentes internos.
3.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. Os ajustes realizados são o resultado que deve ser disponibilizado ao usuário.