Agente de IA para Monitoramento de Satisfação com Benefícios

Definir, a partir do briefing e das políticas do programa de benefícios, os parâmetros de coleta (fontes, período, filtros e campos) e gerar os payloads prontos para execução de chamadas às APIs de cada fonte de feedback.

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 diretrizes de coleta 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 diretrizes de coleta, incluindo fontes, janelas de tempo e segmentos de usuários.
• 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.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um objeto JSON com a lista de fontes e respectivos payloads prontos para chamada (por fonte: endpoint/rota, método, headers, parâmetros de paginação, período_inicio, período_fim, filtros por benefício/segmento, campos desejados) e instruções de retomada em caso de paginação.
• Exemplo de Estrutura de Output:

   {
    "fontes": [
      {
        "endpoint": "https://api.exemplo.com/feedback",
        "método": "GET",
        "headers": {
          "Autorização": "Bearer token"
        },
        "parâmetros": {
          "período_inicio": "2025-12-01",
          "período_fim": "2025-12-14",
          "filtros": {
            "benefício": "saúde",
            "segmento": "premium"
          }
        }
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 3.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 Execução de Chamada à API (RF 2).

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 (RF 2).

Realizar chamadas às APIs das fontes definidas, recuperar os feedbacks brutos e devolver os dados agregados mantendo a estrutura por fonte.

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 uma lista de fontes com payloads prontos para 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é 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser dados brutos de feedback por fonte em JSON (para cada fonte: lista de registros, controles de paginação aplicados, período efetivamente recuperado, contadores por status).
• Exemplo de Estrutura de Output:

   {
    "fontes": [
      {
        "nome": "API Exemplo",
        "dados": [
          {
            "id_feedback": "12345",
            "texto_feedback": "Muito satisfeito com o benefício.",
            "data_criacao": "2025-12-10"
          }
        ],
        "paginacao": {
          "pagina_atual": 1,
          "total_paginas": 5
        }
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter 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 subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Normalização e Análise de Sentimentos (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 Análise de Sentimentos (RF 3).

Normalizar os feedbacks brutos, padronizar campos e calcular métricas de satisfação por item de feedback (sentimento, polaridade, intensidade, categorias de tema e sinal de utilidade).

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 feedbacks brutos consolidados por fonte.
• 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.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um dataset normalizado em JSON, onde cada feedback contém: id, canal_padrao, beneficio_relacionado, texto_normalizado, idioma, sentimento_label ∈ {negativo, neutro, positivo}, sentimento_score ∈ [-1,1], intensidade_irritacao ∈ [0,1], categorias_tema (lista padronizada), possui_acao_imediata (bool), nps_padronizado (0–10 ou null), csat_padronizado (1–5 ou null), spam_ou_teste (bool), qualidade_texto ∈ {baixa, média, alta}.
• Exemplo de Estrutura de Output:

   {
    "feedbacks": [
      {
        "id": "12345",
        "canal_padrao": "email",
        "beneficio_relacionado": "saúde",
        "texto_normalizado": "Muito satisfeito com o benefício.",
        "idioma": "pt-BR",
        "sentimento_label": "positivo",
        "sentimento_score": 0.8,
        "intensidade_irritacao": 0,
        "categorias_tema": ["cobertura"],
        "possui_acao_imediata": false,
        "nps_padronizado": 9,
        "csat_padronizado": null,
        "spam_ou_teste": false,
        "qualidade_texto": "alta"
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 7.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 subsequente.
• Visibilidade da Resposta: A resposta gerada por este agente deve ser visível para o Agente de Tendências e Sinais de Risco (RF 4).

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

Ao concluir sua execução, esse agente aciona o Agente de Tendências e Sinais de Risco (RF 4).

Consolidar o dataset normalizado em métricas agregadas por período, benefício e segmento; detectar tendências, variações significativas e alertas operacionais.

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 um dataset normalizado com sentimentos, notas padronizadas, categorias e metadados.
• 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 indicadores: volume_total, %negativo/%neutro/%positivo, NPS_médio, CSAT_médio, top_categorias (por impacto), variação_semanal e variação_mensal por benefício, canais com piora, lista de alertas com severidade ∈ {alto, médio, baixo} e recomendações de investigação.
• Exemplo de Estrutura de Output:

   {
    "indicadores": {
      "volume_total": 500,
      "%negativo": 20,
      "%neutro": 50,
      "%positivo": 30,
      "NPS_médio": 60,
      "CSAT_médio": 4.5,
      "top_categorias": ["cobertura", "usabilidade_app"],
      "variação_semanal": {
        "cobertura": {
          "valor_atual": 25,
          "valor_base": 20,
          "delta_relativo": 0.25
        }
      },
      "alertas": [
        {
          "beneficio": "saúde",
          "métrica_afetada": "%negativo",
          "janela": "semanal",
          "valor_atual": 25,
          "valor_base": 20,
          "delta_relativo": 0.25,
          "severidade": "médio",
          "motivo_regra": "aumento de %negativo >= 5 p.p."
        }
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 6.000 caracteres.

4.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: 0.6

4.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.

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 Propostas de Ajustes de Benefícios (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Propostas de Ajustes de Benefícios (RF 5).

Converter os insights de sentimentos e tendências em propostas concretas de ajuste de benefícios, com racional, impacto esperado e priorização.

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 indicadores agregados, alertas e lista de temas priorizados.
• 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é 8.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser uma lista priorizada de propostas em JSON: para cada proposta -> beneficio_alvo, problema_diagnosticado, ação_proposta, dependencias, esforço_estimado ∈ {baixo, médio, alto}, impacto_esperado ∈ {baixo, médio, alto}, prazo_sugerido (curto/médio/longo), risco, métricas_de_sucesso (KPI e meta), prioridade_final ∈ {P1, P2, P3}.
• Exemplo de Estrutura de Output:

   {
    "propostas": [
      {
        "beneficio_alvo": "saúde",
        "problema_diagnosticado": "Alta %negativo na cobertura",
        "ação_proposta": "Ampliar rede na região XYZ",
        "dependencias": ["supply"],
        "esforço_estimado": "médio",
        "impacto_esperado": "alto",
        "prazo_sugerido": "curto",
        "risco": "baixo",
        "métricas_de_sucesso": "Reduzir %negativo em 5 p.p. em 8 semanas",
        "prioridade_final": "P1"
      }
    ]
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 4.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: Não utiliza.
• 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 Relatórios Automatizados para Gestores (RF 6).

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

Ao concluir sua execução, esse agente aciona o Agente de Relatórios Automatizados para Gestores (RF 6).

Gerar relatório executivo e operacional com os principais indicadores de satisfação, tendências, alertas e propostas, prontos para envio a gestores de benefícios.

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 indicadores consolidados, alertas gerados e propostas priorizadas.
• 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.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um pacote de relatório em JSON com seções: resumo_executivo, destaques_da_semana, indicadores_chave (por benefício), alertas_críticos, propostas_priorizadas, anexo_detalhado (tabelas e séries por canal/benefício), além de versões em: texto_resumido, bullets_para_apresentação e notas_de_envio.
• Exemplo de Estrutura de Output:

   {
    "relatório": {
      "resumo_executivo": "A satisfação geral dos usuários aumentou 10% na última semana.",
      "destaques_da_semana": "A cobertura de saúde teve uma melhoria significativa.",
      "indicadores_chave": [
        {
          "benefício": "saúde",
          "NPS": 70,
          "CSAT": 4.8
        }
      ],
      "alertas_críticos": [
        {
          "chamada": "Aumentar a capacidade da rede na região XYZ em 48h."
        }
      ]
    }
  } 

• Número de caracteres esperado: O JSON gerado deve ter um tamanho estimado em torno de 8.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: Não utiliza.
• 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 é 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.