Agente de IA para Planejamento de Campanhas de Retenção

Calcular métricas de risco de churn por cliente e consolidar segmentos acionáveis para retenção.

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 um arquivo CSV ou JSON contendo dados dos clientes via API. Na fase de testes, o fluxo será iniciado pelo envio manual dos dados, que serão enviados diretamente por upload na interface da Prototipe AI, para acelerar o processo de validação.
• Tipo do input: O input inicial consiste em dados estruturados de clientes, incluindo informações como data da última compra, frequência de compras e valor gasto.
• Formatos Suportados: Esse agente deve ser capaz de receber dados nos formatos: .csv, .json.
• Número de caracteres esperado: Este agente deve ter capacidade para processar um input de até 100.000 caracteres.

1.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo JSON contendo as métricas de risco de churn por cliente e segmentos acionáveis para retenção.
• Exemplo de Estrutura de Output:

   {
    "data_base": "YYYY-MM-DD",
    "metrica_referencia": {
      "janela_recencia_dias": 180,
      "faixas_risco": {
        "alto": ">=70",
        "medio": "40-69",
        "baixo": "<40"
      }
    },
    "resumo_por_segmento": [
      {
        "segmento": "alto",
        "qtd_clientes": 0,
        "percentual_base": 0.0,
        "principais_drivers": ["recencia_alta", "queda_valor"]
      }
    ],
    "clientes": [
      {
        "cliente_id": "string",
        "recencia_dias": 0,
        "frequencia_12m": 0,
        "valor_12m": 0.0,
        "interacoes_suporte_90d": 0,
        "nps_90d": null,
        "score_churn_0_100": 0,
        "segmento_risco": "alto|medio|baixo",
        "top3_drivers": ["string"],
        "canal_preferido": "opcional"
      }
    ]
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado 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: Utiliza lógica interna para cálculo de métricas de risco de churn.
• 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 Definição de Parâmetros de Busca de Tendências de Mercado (RF 2).

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

Ao concluir sua execução, esse agente aciona o Agente de Definição de Parâmetros de Busca de Tendências de Mercado (RF 2).

Transformar os segmentos e drivers de churn em consultas e parâmetros de busca estruturados para coleta de tendências de mercado.

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 contendo segmentos de clientes e seus principais drivers de churn.
• 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 até 10.000 caracteres.

2.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo JSON contendo consultas e parâmetros de busca estruturados para coleta de tendências de mercado.
• Exemplo de Estrutura de Output:

   {
    "consultas": [
      {
        "query": "string",
        "idioma": "pt|en",
        "regiao": "string",
        "janela_tempo_meses": 6,
        "tipo_fonte": "noticia|relatorio|blog|forum",
        "operadores": ["site:", "intitle:", "filetype:"]
      }
    ],
    "fontes_preferenciais": ["sites/domínios"],
    "palavras_chave_base": ["string"],
    "sinais_interesse": ["queda_buscas", "novos_concorrentes", "sensibilidade_preco"],
    "criterios_filtragem": {
      "recencia_dias_max": 90,
      "autoridade_min": "media"
    }
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 2.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 Busca Online (RF 3).

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

Ao concluir sua execução, esse agente aciona o Agente de Busca Online (RF 3).

Realizar buscas online de tendências com base nos parâmetros fornecidos e retornar resultados brutos.

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 parâmetros de busca estruturados.
• 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 até 5.000 caracteres.

3.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo JSON contendo resultados brutos das buscas online realizadas.
• Exemplo de Estrutura de Output:

   {
    "resultados": [
      {
        "titulo": "string",
        "url": "string",
        "resumo": "string",
        "data_publicacao": "YYYY-MM-DD",
        "fonte": "string"
      }
    ],
    "total_encontrados": 0
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 4.000 caracteres.

3.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: Não se aplica (uso de ferramenta)

3.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Utiliza ferramenta interna para realizar buscas online.
• 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 Analista de Tendências de Mercado (RF 4).

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

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

Converter resultados de busca em sinais de mercado aplicáveis à retenção, com relevância e ação sugerida.

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 dois artefatos como input: resultados brutos de buscas online e segmentos de clientes.
• 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 até 15.000 caracteres.

4.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo JSON contendo sinais de mercado aplicáveis à retenção, com relevância e ação sugerida.
• Exemplo de Estrutura de Output:

   {
    "tendencias": [
      {
        "tag": "ex.: sensibilidade_preco",
        "descricao": "string",
        "evidencias": [
          {
            "url": "string",
            "fonte": "string"
          }
        ],
        "relevancia_0_100": 0,
        "urgencia_0_100": 0,
        "alavancas_recomendadas": ["desconto_progressivo", "aumento_valor_percebido"]
      }
    ],
    "mapa_tendencia_por_segmento": [
      {
        "segmento": "alto|medio|baixo",
        "tendencias_chave": ["tag1", "tag2"]
      }
    ]
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 3.500 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 Planejamento de Campanhas Personalizadas (RF 5).

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

Ao concluir sua execução, esse agente aciona o Agente de Planejamento de Campanhas Personalizadas (RF 5).

Desenhar plano tático de campanhas de retenção por segmento, integrando drivers de churn e tendências de mercado.

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 segmentos de clientes e sinais de mercado aplicáveis à retençã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 até 20.000 caracteres.

5.3.2 Especificação do Output

• Formato de output: O output deve ser um arquivo JSON contendo o plano tático de campanhas de retenção por segmento.
• Exemplo de Estrutura de Output:

   {
    "plano_campanhas": [
      {
        "segmento": "alto|medio|baixo",
        "objetivo": "reduzir churn em X%",
        "proposta_valor": "string",
        "taticas": [
          {
            "alavanca": "string",
            "oferta": "string",
            "mensagem_base": "string",
            "canal": ["email","sms","whatsapp","in_app"],
            "gatilho": "ex.: 30 dias sem compra",
            "cadencia": "ex.: D0, D3, D7",
            "freq_cap": "máx. 2/semana",
            "criterios_eligibilidade": ["ativo", ">=1 compra"],
            "grupo_controle": "5%"
          }
        ],
        "kpis": ["taxa_cancelamento", "retenção_30d", "CTR", "conversão"],
        "prioridade": 1,
        "estimativa_impacto": {
          "uplift_esperado_%": 0.0,
          "alcance_estimado": 0
        }
      }
    ],
    "diretrizes_compliance": ["respeitar opt-out", "LGPD: finalidade e minimização de dados"],
    "roadmap_execucao": [
      {
        "semana": 1,
        "acoes": ["validação criativa", "configuração público"]
      }
    ]
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 6.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 Execução de Chamada à API (RF 6).

5.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 6).

Enviar o plano de campanhas para a plataforma de automação de marketing especificada, quando solicitado.

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 contendo o plano de campanhas de retençã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 até 8.000 caracteres.

6.3.2 Especificação do Output

• Formato de output: O output deve ser um JSON contendo o status da execução da chamada à API.
• Exemplo de Estrutura de Output:

   {
    "status": "sucesso|falha",
    "protocolo": "string",
    "mensagem": "string"
  }

• Número de caracteres esperado: O JSON gerado terá um tamanho aproximado de 500 caracteres.

6.3.3 Parâmetros de Geração

• Modelo: GPT-5
• Temperatura: Não se aplica (uso de ferramenta)

6.3.4 Ferramentas do Agente

• Documentos: Não consulta documentos externos.
• Calculadora: Não utiliza.
• Busca Online: Não utiliza.
• Sistemas Externos: O agente deverá enviar o JSON recebido para a API externa especificada e retornar o status recebido como resposta.

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 status da execução da chamada à API é o resultado que deve ser disponibilizado ao usuário.