1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados, ferramentas como chamadas a sistemas externos e demais requisitos funcionais para o Fluxo de Agentes "Análise de Capacidade de Acomodação", uma solução de automação projetada para avaliar a capacidade atual dos alojamentos e projetar necessidades futuras com base em tendências de internação. 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 é fornecer relatórios e previsões precisas que auxiliem no planejamento estratégico dos recursos de acomodação hospitalar.
2. Contexto e Problema
Cenário Atual
Os gestores hospitalares enfrentam desafios significativos para manter a visibilidade sobre a capacidade atual e futura dos alojamentos. A falta de precisão nas projeções pode resultar em alocações inadequadas de recursos, afetando a qualidade do atendimento e a eficiência operacional.
Problemas Identificados
- Falta de Visibilidade: Dificuldades em acessar dados atualizados sobre a capacidade dos alojamentos.
- Dificuldade de Projeção: Complexidade em prever necessidades futuras com base em tendências de internação.
3. Impactos Esperados
A implementação deste fluxo de automação visa alcançar os seguintes resultados:
- Melhorar a precisão das projeções de necessidades de acomodação futura.
- Aumentar a eficiência no uso dos recursos de acomodação hospitalar.
- Reduzir riscos de superlotação e subutilização de leitos.
4. Visão Geral da Solução
O agente de IA para análise de capacidade de acomodação avalia continuamente a capacidade atual dos alojamentos e projeta necessidades futuras com base em tendências de internação. 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 eficaz dos recursos de acomodação hospitalar.
A solução consiste em um fluxo de automação composto por vários agentes de IA. O processo inicia com a obtenção de dados de ocupação atual e termina com a geração de um relatório executivo com recomendações operacionais.
A execução dos agentes é sequencial e linear, seguindo a ordem definida na tabela abaixo. O fluxo inclui etapas condicionais que são executadas apenas se critérios específicos forem atendidos, conforme detalhado após a tabela.
| Agentes | Função Principal |
|---|---|
Agente de Execução de Consultas em Banco de Dados (Histórico de Internações) | Realizar conexão com o banco de dados institucional para obter séries históricas de internações e ocupação por alojamento. |
Agente de Execução de Chamada à API (Ocupação em Tempo Real dos Alojamentos) | Realizar chamada à API operacional para obter a ocupação atual e status dos leitos por alojamento. |
Agente de Avaliação de Capacidade Atual dos Alojamentos | Calcular e qualificar a capacidade operacional atual por alojamento e total da unidade com base na ocupação em tempo real. |
Agente de Análise de Tendências de Internação e Projeção de Necessidades | Projetar necessidade futura de leitos por alojamento e consolidado a partir de tendências de internação e padrões de ocupação. |
Agente de Relatório e Recomendações para Planejamento | Consolidar a capacidade atual e as projeções em um sumário executivo com recomendações operacionais. |
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 Execução de Consultas em Banco de Dados (Histórico de Internações)
1.1 Tarefa do Agente
Realizar conexão com o banco de dados institucional para obter séries históricas de internações e ocupação por alojamento.
1.2 Prompt ou Instruções do Agente
Este agente não precisa de instruções de LLM. Sua única função é executar a consulta ao banco com os parâmetros recebidos e retornar exatamente os registros correspondentes, sem agregações ou transformações.
1.3 Configurações do Agente
1.3.1 Especificação do Input
- Mecanismo de Acionamento: Este agente deve ser acionado pelo envio de parâmetros de consulta 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 é um conjunto de parâmetros de consulta para o banco de dados.
- 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é 10.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo os registros históricos de internações e ocupação por alojamento.
- Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 20.000 caracteres.
1.3.3 Parâmetros de Geração
- Modelo: Não se aplica
- Temperatura: Não se aplica
1.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: O agente deve se conectar ao banco de dados institucional para executar a consulta.
1.3.5 Memória
- Visibilidade das Instruções (Prompt): Não se aplica.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Análise de Tendências de Internação e Projeção de Necessidades.
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 em Tempo Real dos Alojamentos).
RF 2. Agente de Execução de Chamada à API (Ocupação em Tempo Real dos Alojamentos)
2.1 Tarefa do Agente
Realizar chamada à API operacional para obter a ocupação atual e status dos leitos por alojamento.
2.2 Prompt ou Instruções do Agente
Este agente não precisa de instruções de LLM. Sua única função é executar a chamada à API com o payload informado e retornar o JSON de resposta sem alterações.
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 do agente anterior.
- Tipo do input: O input é um conjunto de parâmetros de chamada à API.
- 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.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON contendo a ocupação atual e status dos leitos por alojamento.
- Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 10.000 caracteres.
2.3.3 Parâmetros de Geração
- Modelo: Não se aplica
- Temperatura: Não se aplica
2.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: O agente deve se conectar à API operacional para obter dados de ocupação em tempo real.
2.3.5 Memória
- Visibilidade das Instruções (Prompt): Não se aplica.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Avaliação de Capacidade Atual dos Alojamentos.
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Avaliação de Capacidade Atual dos Alojamentos.
RF 3. Agente de Avaliação de Capacidade Atual dos Alojamentos
3.1 Tarefa do Agente
Calcular e qualificar a capacidade operacional atual por alojamento e total da unidade com base na ocupação em tempo real.
3.2 Prompt ou Instruções do Agente
Este agente não precisa de instruções de LLM. Sua função é calcular e qualificar a capacidade operacional atual usando os dados de ocupação em tempo real.
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.
- Tipo do input: O input é um JSON com dados de ocupação em tempo real.
- 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é 10.000 caracteres.
3.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON com a capacidade operacional atual por alojamento e total da unidade.
- Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 15.000 caracteres.
3.3.3 Parâmetros de Geração
- Modelo: Não se aplica
- Temperatura: Não se aplica
3.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Utiliza lógica interna para calcular capacidade operacional.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
3.3.5 Memória
- Visibilidade das Instruções (Prompt): Não se aplica.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Análise de Tendências de Internação e Projeção de Necessidades.
3.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Análise de Tendências de Internação e Projeção de Necessidades.
RF 4. Agente de Análise de Tendências de Internação e Projeção de Necessidades
4.1 Tarefa do Agente
Projetar necessidade futura de leitos por alojamento e consolidado a partir de tendências de internação e padrões de ocupação.
4.2 Prompt ou Instruções do Agente
Este agente não precisa de instruções de LLM. Sua função é projetar a necessidade futura de leitos usando dados históricos e padrões de ocupação.
4.3 Configurações do Agente
4.3.1 Especificação do Input
- Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior.
- Tipo do input: O input é um JSON com dados históricos de internação e 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 texto com até 20.000 caracteres.
4.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON com projeções de necessidades de leitos por alojamento e consolidado.
- Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 25.000 caracteres.
4.3.3 Parâmetros de Geração
- Modelo: Não se aplica
- Temperatura: Não se aplica
4.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Utiliza lógica interna para projeção de necessidades.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
4.3.5 Memória
- Visibilidade das Instruções (Prompt): Não se aplica.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Relatório e Recomendações para Planejamento.
4.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Relatório e Recomendações para Planejamento.
RF 5. Agente de Relatório e Recomendações para Planejamento
5.1 Tarefa do Agente
Consolidar a capacidade atual e as projeções em um sumário executivo com recomendações operacionais.
5.2 Prompt ou Instruções do Agente
Este agente não precisa de instruções de LLM. Sua função é consolidar dados e gerar um sumário executivo com recomendações.
5.3 Configurações do Agente
5.3.1 Especificação do Input
- Mecanismo de Acionamento: Este agente deve ser acionado automaticamente após a conclusão do agente anterior.
- Tipo do input: O input é um JSON com dados de capacidade atual e projeções.
- 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é 30.000 caracteres.
5.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON com o sumário executivo e recomendações operacionais.
- Número de caracteres esperado: O JSON gerado deve ter um tamanho aproximado de 10.000 caracteres.
5.3.3 Parâmetros de Geração
- Modelo: Não se aplica
- Temperatura: Não se aplica
5.3.4 Ferramentas do Agente
- Documentos: Não consulta.
- Calculadora: Utiliza lógica interna para consolidação de dados.
- Busca Online: Não utiliza.
- Sistemas Externos: Não utiliza.
5.3.5 Memória
- Visibilidade das Instruções (Prompt): Não se aplica.
- Visibilidade da Resposta: A resposta gerada por este agente é o resultado final e não é passada para outros agentes internos.
5.3.6 Regras de Orquestração e Transição
A execução deste agente finaliza o fluxo. O sumário executivo gerado deve ser disponibilizado ao usuário.