Agente de IA para Monitoramento de Satisfação do Beneficiário

Receber feedbacks brutos de beneficiários e produzir um conjunto normalizado, deduplicado, anonimizado e pronto para análise sobre autorizações e reembolsos.

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 feedbacks dos beneficiários 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 arquivo JSON na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial para o fluxo é um arquivo JSON contendo feedbacks brutos de beneficiários.
• 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é 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo feedbacks normalizados, prontos para análise subsequente.
• Exemplo de Estrutura de Output:

   {
    "feedbacks_normalizados": [
      {
        "id_original": "123",
        "id_normalizado": "abc-123",
        "data": "2025-12-14",
        "canal": "email",
        "tipo_processo": "autorizacao",
        "texto_limpo": "Texto do feedback normalizado.",
        "idioma_detectado": "pt",
        "pii_mascarada": true,
        "tokens": 50,
        "qualidade": "ok"
      }
    ],
    "descartados": [],
    "estatisticas": {
      "total_entrada": 100,
      "total_valido": 95,
      "total_descartado": 5,
      "periodo_processado": {
        "inicio": "2025-12-01",
        "fim": "2025-12-14"
      }
    }
  } 

• Número de caracteres esperado: O JSON final deve ter um tamanho estimado em torno de 10.000 caracteres, variando conforme o número de feedbacks processados.

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 calcular estatísticas de processamento.
• 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 Classificação Temática, Etapa do Processo e Sentimento (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Classificação Temática, Etapa do Processo e Sentimento (RF 2).

Estruturar os feedbacks em temas, mapear a etapa do processo de autorizações/reembolsos, e qualificar sentimento, emoção e severidade.

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: Este agente deve ser apto a receber como input um JSON contendo feedbacks normalizados, gerado pelo agente anterior.
• 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 contendo feedbacks classificados por tema, etapa do processo e qualificações de sentimento e severidade.
• Exemplo de Estrutura de Output:

   {
    "feedbacks_classificados": [
      {
        "id_normalizado": "abc-123",
        "tipo_processo": "autorizacao",
        "etapa_processo": "analise",
        "tema_principal": "prazos_SLA",
        "sentimento_score": -0.8,
        "polaridade": "negativo",
        "emocao_predominante": "frustracao",
        "severidade": 4,
        "urgencia": "alta",
        "justificativa_classificacao": "O feedback menciona atrasos frequentes e falta de comunicação clara.",
        "citacoes_relevantes": ["atrasos frequentes", "falta de comunicação clara"]
      }
    ],
    "taxonomia_utilizada": {
      "temas": [
        {
          "tema": "prazos_SLA",
          "subtemas": []
        }
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 12.000 caracteres, variando conforme o número de feedbacks classificados.

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 classificado) deve ser visível para o Agente de Detecção de Tendências e Problemas Recorrentes (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Detecção de Tendências e Problemas Recorrentes (RF 3).

Identificar temas e etapas com maior concentração de feedbacks negativos e tendências de crescimento, calculando métricas de recorrência e impacto potencial.

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 feedbacks classificados por tema, etapa do processo e qualificações de sentimento e severidade, gerado pelo agente anterior.
• 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é 12.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo tendências identificadas, resumo de problemas recorrentes e métricas de impacto potencial.
• Exemplo de Estrutura de Output:

   {
    "tendencias": [
      {
        "tema_principal": "prazos_SLA",
        "tipo_processo": "autorizacao",
        "etapa_processo": "analise",
        "total_itens": 30,
        "suporte_percentual": 10.0,
        "sentimento_medio": -0.7,
        "severidade_media": 3.5,
        "tendencia": "em_alta",
        "exemplos": [
          {
            "id_normalizado": "abc-123",
            "trecho": "atrasos frequentes"
          }
        ],
        "criterio_disparo": "suporte_percentual >= 5%"
      }
    ],
    "sumario": {
      "total_itens": 100,
      "top_temas": [
        {
          "tema_principal": "prazos_SLA",
          "suporte_percentual": 10.0
        }
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 8.000 caracteres, variando conforme o número de tendências identificadas.

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: Utiliza lógica interna para calcular métricas de recorrência e impacto.
• 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 tendências) deve ser visível para o Agente de Priorização e Hipóteses de Causa (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Priorização e Hipóteses de Causa (RF 4).

Ordenar problemas por impacto e esforço estimado e formular hipóteses de causa raiz relacionadas aos processos de autorizações e reembolsos.

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 tendências identificadas e métricas de impacto potencial, gerado pelo agente anterior.
• 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.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo problemas priorizados, hipóteses de causa e critérios de impacto e esforço.
• Exemplo de Estrutura de Output:

   {
    "backlog_priorizado": [
      {
        "id_item": "abc-123",
        "tema_principal": "prazos_SLA",
        "tipo_processo": "autorizacao",
        "etapa_processo": "analise",
        "impacto_score": 0.75,
        "esforco_class": "medio",
        "prioridade": "P1",
        "hipoteses_causa": ["Comunicação inadequada sobre prazos", "Falta de integração entre sistemas"],
        "riscos": ["Risco de penalidade regulatória"],
        "observacoes": "Necessidade de revisão urgente do processo."
      }
    ],
    "criterios": {
      "formula_impacto": "(normaliza(severidade_media)*0.5) + (normaliza(suporte_percentual)*0.3) + (normaliza(|sentimento_medio|)*0.2)",
      "definicao_esforco": "Baixo: texto/comunicação; Médio: regra operacional; Alto: mudança sistêmica."
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 12.000 caracteres, variando conforme o número de problemas priorizados.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para calcular impacto e esforço.
• 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 (JSON priorizado) deve ser visível para o Agente de Recomendações de Melhoria e Experimentos (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Recomendações de Melhoria e Experimentos (RF 5).

Gerar recomendações acionáveis (processo, comunicação, sistema) e um plano de experimento/implementação com metas e guardrails.

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 problemas priorizados e hipóteses de causa, gerado pelo agente anterior.
• 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é 12.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo recomendações de melhoria, planos de experimento e metas definidas.
• Exemplo de Estrutura de Output:

   {
    "recomendacoes": [
      {
        "id_item": "abc-123",
        "acao": "Revisar comunicação sobre prazos de autorização.",
        "categoria": "comunicacao",
        "owner_area": "Atendimento ao Cliente",
        "passos_implementacao": ["Revisar texto padrão de e-mails", "Atualizar FAQs no portal"],
        "estimativa_prazo": "curto",
        "custo_estimado": "baixo",
        "kpis_impactados": [
          {
            "kpi": "SLA_autorizacao",
            "direcao": "down",
            "meta": 7,
            "baseline": 10
          }
        ],
        "experimento": {
          "tipo": "A/B",
          "duracao_semanas": 4,
          "populacao_alvo": "Beneficiários que solicitaram autorizações nos últimos 3 meses",
          "criterios_sucesso": [
            {
              "kpi": "SLA_autorizacao",
              "alvo": 7
            }
          ],
          "guardrails": [
            {
              "kpi": "taxa_negativas",
              "limite_minimo_ou_maximo": 5
            }
          ]
        },
        "mensagem_chave_ao_beneficiario": "Estamos melhorando nossos prazos de autorização para servir você melhor."
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 15.000 caracteres, variando conforme o número de recomendações geradas.

5.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

5.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para definir metas e guardrails.
• 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 (JSON de recomendações) deve ser visível para o Agente de Geração de Relatório Executivo (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 Executivo (RF 6).

Consolidar resultados em um entregável executivo claro, com sumário, principais tendências, backlog priorizado e plano de ação.

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 combinando saídas dos agentes anteriores, incluindo recomendações de melhoria e planos de experimento.
• 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é 15.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo um relatório executivo consolidado, com sumário, principais tendências, backlog priorizado e plano de ação.
• Exemplo de Estrutura de Output:

   {
    "resumo_executivo": {
      "top_3_tendencias": [
        {
          "tema": "prazos_SLA",
          "suporte_percentual": 10.0,
          "severidade_media": 3.5,
          "recomendacao_resumo": "Revisar comunicação sobre prazos."
        }
      ],
      "ganhos_rapidos": [
        {
          "acao": "Revisar texto padrão de e-mails",
          "kpi_principal": "SLA_autorizacao",
          "meta": 7
        }
      ]
    },
    "secoes": {
      "metodologia": "Análise de feedbacks de 2025-12-01 a 2025-12-14, critérios de tendência baseados em suporte_percentual >= 5%.",
      "panorama_geral": {
        "totais": {
          "feedbacks_analisados": 100,
          "taxa_descarte": 5.0
        },
        "distribuicao_por_tema": [
          {
            "tema": "prazos_SLA",
            "suporte_percentual": 10.0
          }
        ]
      },
      "detalhes_tendencias": [],
      "backlog_priorizado": [],
      "plano_acao": []
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 20.000 caracteres, variando conforme o número de seções e detalhes incluídos.

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

6.3.4 Ferramentas do Agente

• Documentos: Não consulta.
• Calculadora: Utiliza lógica interna para consolidar resultados e calcular métricas finais.
• Busca Online: Não utiliza.
• Sistemas Externos: Não utiliza.

6.3.5 Memória

• Visibilidade das Instruções (Prompt): As instruções não são visíveis para agentes subsequentes.
• Visibilidade da Resposta: A resposta (relatório executivo) é 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.