1. Propósito e Escopo
Este documento define todos os prompts, configurações de memória, transição entre estados, consulta a documentos e demais requisitos funcionais para o Agente de IA para Análise de Desempenho de Estabelecimentos Credenciados. 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 é criar um agente de IA que analisa o desempenho de estabelecimentos credenciados com base em indicadores de qualidade e satisfação, gerando relatórios detalhados para suporte à decisão.
2. Contexto e Problema
A avaliação contínua do desempenho dos estabelecimentos credenciados é uma necessidade crítica para garantir a qualidade dos serviços prestados. No entanto, a falta de relatórios detalhados dificulta a tomada de decisão, impactando negativamente a capacidade de implementar melhorias eficazes.
Atualmente, as organizações enfrentam desafios significativos na coleta e análise de dados de desempenho, o que resulta em decisões baseadas em informações incompletas ou imprecisas.
- Necessidade de avaliação contínua do desempenho dos estabelecimentos credenciados.
- Falta de relatórios detalhados para suporte à decisão.
3. Impactos Esperados
A implementação deste agente de IA visa alcançar os seguintes resultados:
- Melhorar a qualidade dos relatórios de desempenho fornecendo informações detalhadas e acionáveis.
- Aumentar a precisão das avaliações de desempenho através da análise contínua e automatizada dos indicadores de qualidade e satisfação.
- Facilitar a tomada de decisão ao fornecer insights baseados em dados para gestores e líderes.
- Propor melhorias baseadas nos dados analisados para otimizar os serviços prestados.
4. Visão Geral da Solução
O agente de IA para análise de desempenho de estabelecimentos credenciados processa dados de indicadores de qualidade e satisfação, gera relatórios detalhados e sugere melhorias baseadas nos dados analisados. 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 melhoria contínua dos estabelecimentos credenciados.
A solução consiste em um fluxo de automação composto por 3 agentes de IA. O processo inicia com a preparação e validação dos dados de indicadores e termina com a geração de relatórios para suporte à decisão.
| Agentes | Função Principal |
|---|---|
Agente de Preparação e Validação de Dados de Indicadores (RF 1)
| Validar consistência, tratar ausências e padronizar escalas dos indicadores de qualidade e satisfação. |
Agente de Análise e Benchmarking de Desempenho (RF 2)
| Calcular scores de desempenho por pilares e total, ranquear estabelecimentos e gerar insights de melhoria. |
Agente de Geração de Relatórios para Suporte à Decisão (RF 3)
| Produzir relatórios executivos e operacionais claros e acionáveis sobre o desempenho dos estabelecimentos. |
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 Preparação e Validação de Dados de Indicadores
1.1 Tarefa do Agente
Validar consistência, tratar ausências e padronizar escalas dos indicadores de qualidade e satisfação dos estabelecimentos credenciados, produzindo um dataset pronto para análise comparativa.
1.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo dados de indicadores de qualidade e satisfação de estabelecimentos credenciados. Este conjunto de dados inclui informações brutas que precisam ser preparadas para análise. # 2. Objetivo Validar a consistência, tratar ausências e padronizar as escalas dos indicadores, gerando um dataset normalizado e pronto para análise comparativa. # 3. Regras que você deve seguir para gerar sua resposta - Para cada indicador, identificar unidade e direção no dicionário de métricas; se ausente, inferir pela descrição do nome e registrar 'fonte_inferencia'. - Padronizar escalas para 0-100 conforme especificado nas regras. - Aplicar direção: se menor_melhor, inverter valor_normalizado_0_100 = 100 - valor_normalizado_0_100. - Tratamento de faltantes e outliers conforme especificado nas regras. - Garantir que todos os registros finais tenham valor_normalizado_0_100 em [0,100] e duas casas decimais. - Produzir mapa de estabelecimentos válidos e resumo da qualidade dos dados. - Não descartar linhas; utilizar flags para controle de qualidade.
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 de indicadores via API. Na fase de testes, os dados serão enviados diretamente por upload de um arquivo csv na interface da Prototipe AI, para acelerar o processo de validação.
- Tipo do input: O input inicial para o fluxo é um conjunto de dados estruturados contendo indicadores brutos de qualidade e satisfação.
-
Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos:
.csv. - Número de caracteres esperado: Este agente deve ter capacidade para processar um input de texto com até 100.000 caracteres.
1.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON estruturado contendo o dataset normalizado, dicionário de métricas resolvido, mapa de estabelecimentos válidos e resumo da qualidade dos dados.
-
Exemplo de Estrutura de Output:
{ "dataset_normalizado": [...], "dicionario_metricas_resolvido": [...], "mapa_estabelecimentos_validos": [...], "resumo_qualidade_dados": {...} } - Número de caracteres esperado: O JSON gerado deve ser conciso e informativo, com um tamanho estimado em torno de 5.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.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Análise e Benchmarking de Desempenho (RF 2).
1.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Análise e Benchmarking de Desempenho (RF 2).
RF 2. Agente de Análise e Benchmarking de Desempenho
2.1 Tarefa do Agente
Calcular scores de desempenho por pilares e total, ranquear estabelecimentos, identificar benchmarks e gerar insights acionáveis de melhoria com base nos indicadores normalizados.
2.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo um dataset normalizado e um dicionário de métricas resolvido. Esses dados foram preparados para análise de desempenho e benchmarking. # 2. Objetivo Calcular scores de desempenho, ranquear estabelecimentos e gerar insights de melhoria com base nos indicadores normalizados. # 3. Regras que você deve seguir para gerar sua resposta - Construir score por pilar como média simples dos indicadores com flag_dado_insuficiente=false e flag_outlier=false. - Score total = soma ponderada dos scores dos pilares; normalizar para 0-100. - Ranking geral e por categoria: ordenar por score_total. - Calcular percentis e variação temporal, se aplicável. - Identificar benchmarks por categoria e geral. - Gerar drivers de melhoria e alertas conforme especificado nas regras.
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 (RF 1).
- Tipo do input: Este agente deve ser apto a receber como input um JSON estruturado contendo o dataset normalizado e o dicionário de métricas resolvido.
-
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.
2.3.2 Especificação do Output
- Formato de output: O output deve ser um JSON estruturado contendo a tabela de resultados por estabelecimento, benchmarks, drivers de melhoria e resumo de insights globais.
-
Exemplo de Estrutura de Output:
{ "tabela_resultados_por_estabelecimento": [...], "benchmarks": [...], "drivers_de_melhoria": [...], "resumo_insights_globais": {...} } - Número de caracteres esperado: O JSON gerado deve ser claro e direto, com um tamanho estimado em torno de 5.000 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 documentos externos.
- Calculadora: Não utiliza.
- Busca Online: Não utiliza.
- Sistemas Externos: Não se conecta a sistemas externos.
2.3.5 Memória
- Visibilidade das Instruções (Prompt): As instruções deste agente não devem ser visíveis para nenhum agente.
- Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Geração de Relatórios para Suporte à Decisão (RF 3).
2.3.6 Regras de Orquestração e Transição
Ao concluir sua execução, esse agente aciona o Agente de Geração de Relatórios para Suporte à Decisão (RF 3).
RF 3. Agente de Geração de Relatórios para Suporte à Decisão
3.1 Tarefa do Agente
Produzir relatórios executivos e operacionais claros e acionáveis sobre o desempenho dos estabelecimentos, com recomendações e plano de ação priorizado.
3.2 Prompt ou Instruções do Agente
# 1. Contexto e explicações sobre inputs iniciais Você está recebendo uma tabela de resultados por estabelecimento, benchmarks, drivers de melhoria e resumo de insights globais. # 2. Objetivo Produzir relatórios executivos e operacionais claros e acionáveis sobre o desempenho dos estabelecimentos, com recomendações e plano de ação priorizado. # 3. Regras que você deve seguir para gerar sua resposta - Estruturar o sumário executivo e relatórios operacionais conforme especificado nas regras. - Incluir recomendações prioritárias e plano de ação com impacto estimado em p.p. - Evidenciar benchmarks e sinalizar dados insuficientes.
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: Este agente deve ser apto a receber como input um JSON estruturado contendo a tabela de resultados por estabelecimento, benchmarks, drivers de melhoria e resumo de insights globais.
-
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 pacote de textos estruturados contendo sumário executivo, relatórios operacionais por estabelecimento, plano de ação priorizado e anexos textuais.
-
Exemplo de Estrutura de Output:
{ "sumario_executivo": "...", "relatorio_operacional_por_estabelecimento": "...", "plano_de_acao_priorizado": "...", "anexos_textuais": "..." } - Número de caracteres esperado: O pacote gerado deve ser claro e direto, com um tamanho estimado em torno de 8.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: Não utiliza.
- 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.
- Visibilidade da Resposta: A resposta gerada por este agente é 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. O pacote gerado é o resultado que deve ser disponibilizado ao usuário.