Ir para o conteúdo

Chamada contextual por IA

Como ligar a chamada escrita por IA para cada página do seu site, quanto ela custa, como editar ou excluir uma chamada e o que precisa existir para o visitante vê-la.

Atualizado em

A chamada é o balão que convida o visitante a conversar. Normalmente você escreve o texto dela na regra, e ele vale para todas as páginas que aquela regra alcança. Com a chamada contextual por IA, o texto passa a ser escrito para a página em que o gatilho disparou, a partir do conteúdo que já está indexado dela.

Na prática: um post do blog sobre enriquecimento de dados recebe uma chamada sobre enriquecimento; a página de planos recebe uma sobre escolher o plano. Você não precisa criar uma regra por URL.

O recurso fica em Gatilhos (/gatilhos), no cartão Chamada contextual por IA. Quem pode mexer é quem tem permissão de configurar o agente (agent:manage).

O que precisa existir para o visitante ver a chamada

São três coisas, e a falta de qualquer uma faz o visitante não ser abordado:

  1. O site indexado. A IA escreve a partir do conteúdo rastreado em Conhecimento — as fontes do agente. Sem fonte indexada não há do que escrever.
  2. Um gatilho ativo, que decida quando o agente pode abordar sozinho.
  3. Uma regra cujo campo De onde vem a chamada esteja em Gerada por IA para a página.

O gatilho sozinho não aborda: sem uma regra que case com a página, o visitante não recebe nada — nem chamada escrita à mão, nem gerada. Isso está explicado em detalhe em Gatilhos e regras de exibição.

Quanto custa

O que acontece Quando
Uma geração de IA por página Só na página que ainda não tem chamada, ou cujo conteúdo mudou desde a última vez
Nenhuma geração Reindexar ou pedir de novo uma página que não mudou não custa nada
Nenhum custo por visita O widget só lê o texto já pronto — a IA não é chamada quando alguém acessa o site
No máximo 200 páginas por rodada Sobrando páginas, a rodada seguinte é pedida automaticamente alguns minutos depois, até acabar; até lá elas usam a chamada geral do site

O limite de 200 pega as páginas mais rasas do rastreamento, que costumam ser as mais visitadas. Ele vale sobre o que falta gerar: as páginas já escritas saem da conta, então um site grande vai sendo coberto a cada reindexação.

A chamada que você editou na tabela nunca é regerada — ela fica marcada como escrita por você e o rastreamento não encosta nela.

Desligar o recurso não apaga as chamadas já geradas: elas continuam guardadas e voltam a valer assim que você religar, sem custar uma nova geração.

Ligar e gerar

  1. Em Gatilhos, encontre o cartão Chamada contextual por IA.
  2. Clique em Ativar.
  3. Clique em Gerar agora para pedir a geração sem esperar a próxima reindexação.

As chamadas não aparecem na hora — elas são escritas em segundo plano e vão surgindo na tabela conforme ficam prontas. Atualize a página depois de alguns minutos.

Se aparecer o aviso "O processamento em segundo plano está indisponível agora", nada foi perdido: espere alguns minutos e clique em Gerar agora de novo. Pedir duas vezes é seguro, nos dados e na conta: a chamada de cada página é regravada em vez de duplicada, e a página que não mudou não é gerada de novo.

Cliques repetidos em poucos minutos viram um pedido só. Se aparecer "Muitos pedidos de geração em pouco tempo", o pedido anterior já está a caminho — espere e recarregue a página.

A tabela de chamadas

Cada linha é uma página. As colunas são:

  • Página — o caminho da página no seu site. A linha Todo o site é a chamada geral: ela vale nas páginas que ainda não têm chamada própria (página nova, fora do lote de 200, ou indexação ainda em andamento).
  • Título — o título da página, como o rastreador o encontrou.
  • Chamada — o texto que o visitante vê, com no máximo 160 caracteres.
  • Escrita por — IA quando o texto foi gerado, Você quando alguém o editou aqui.

A tabela mostra no máximo 100 linhas. Quando o site tem mais do que isso, a contagem acima dela diz o total e um aviso informa quantas estão sendo exibidas — as demais existem e funcionam normalmente, só não cabem na tela.

Cobertura por fonte

Acima da tabela de chamadas há uma segunda tabela, Cobertura por fonte, com uma linha para cada site indexado em Conhecimento. Ela responde a pergunta que a contagem de chamadas sozinha não responde: de quantas páginas estamos falando, e o que aconteceu com as que não aparecem na tabela.

Coluna O que significa
Fonte O endereço que você cadastrou em Conhecimento
Páginas Quantas páginas distintas aquela fonte tem
Com chamada Quantas delas já têm uma chamada escrita para elas
Ficaram de fora Quantas não têm, e por quê

Páginas, não endereços

O rastreador visita endereços; a chamada é escrita para páginas. Os endereços https://seusite.com.br/precos, https://seusite.com.br/precos?product=b2b e https://seusite.com.br/precos/ são a mesma página para quem visita — e, por isso, recebem a mesma chamada. Quando isso acontece, a coluna Páginas mostra a observação "+3 endereços das mesmas páginas": são endereços a mais, não páginas sem chamada.

É o mesmo motivo pelo qual uma fonte pode aparecer em Conhecimento com 100 páginas rastreadas e aqui com 97: três daqueles endereços eram variações da mesma página.

Os motivos de uma página ficar de fora

  • "13 ainda sem chamada — clique em Gerar agora." A geração ainda não chegou nelas (o limite é de 200 páginas por rodada) ou falhou naquela página. Pedir de novo é seguro e só custa as que faltam: as páginas que já têm chamada não são geradas outra vez. Com o recurso desligado a frase muda para "Ative a chamada contextual para gerar as que faltam", porque o botão Gerar agora só existe com o recurso ligado.
  • "1 é curta demais para ter chamada própria: ela usa a chamada geral do site." Páginas com pouquíssimo texto — um redirecionamento, uma página só com um link — não dão material para uma frase específica. Em vez de gastar uma geração para produzir um texto genérico, elas usam a chamada geral do site, que é exatamente isso e já está pronta. O visitante continua sendo abordado.
  • "Nenhuma página indexada nesta fonte ainda." A fonte está Pronto em Conhecimento, mas nenhuma página dela foi indexada. Reindexe a fonte por lá.
  • "Não foi possível contar as páginas desta fonte agora." A contagem falhou nesta abertura da tela — as chamadas já geradas continuam valendo. Recarregue em instantes.
  • "Nenhuma." Todas as páginas daquela fonte têm chamada.

A tabela só aparece com a chamada contextual ligada: com ela desligada não há o que contar, e a tela não gasta tempo buscando.

Editar uma chamada

Clique em Editar na linha, ajuste o texto e clique em Salvar. A coluna Escrita por passa a mostrar Você.

Isso é mais do que um rótulo: uma chamada editada por você não é substituída pela IA na próxima reindexação. É assim que uma correção sua sobrevive. Se quiser que a IA volte a escrever aquela página, exclua a chamada e peça Gerar agora.

Excluir uma chamada

Clique em Excluir e confirme. A página volta a usar a chamada geral do site — ou, se não houver uma, o texto escrito na própria regra. A próxima geração pode criar outra chamada para aquela página: excluir quer dizer "esta ficou ruim", não "nunca mais".

Escolher a origem da chamada na regra

No editor de regras (em Gatilhos, ao criar ou editar uma regra) há o campo De onde vem a chamada:

  • Escrever eu mesmo — o texto da regra vale sempre. É o comportamento de todas as regras criadas antes deste recurso existir.
  • Gerada por IA para a página — vale, nesta ordem: a chamada da página visitada, depois a chamada geral do site, e só então o texto escrito na regra.

Por isso vale a pena manter o texto escrito à mão mesmo escolhendo a IA: ele é a rede de segurança. Enquanto a indexação termina, é ele que aborda o visitante em vez de deixá-lo sem chamada.

Se o recurso estiver desligado no site, a regra avisa e usa o texto escrito à mão.

Perguntas frequentes

A IA é chamada a cada visita? Não. A geração acontece uma vez por página, em segundo plano. Durante a visita o widget apenas lê o texto já guardado — é por isso que o recurso não fica mais caro quando o site recebe mais tráfego.

Mudei o conteúdo de uma página. A chamada muda sozinha? Na próxima reindexação daquela fonte, sim — desde que a chamada não tenha sido editada por você. Para antecipar, clique em Gerar agora.

Tenho um teste A/B de chamada ativo. Quem ganha? A variante do experimento. Ela substitui o texto de uma regra que já casou, seja esse texto escrito à mão ou gerado pela IA. O experimento não cria abordagem onde nenhuma regra casou.

Liguei o recurso e a tabela continua vazia. Confira se existe alguma fonte com status Pronto em Conhecimento — as fontes do agente. Sem conteúdo indexado não há do que escrever a chamada.

A fonte tem 100 páginas e só algumas têm chamada. As outras falharam? Olhe a tabela Cobertura por fonte: ela diz quantas páginas a fonte tem de verdade e o motivo de cada grupo que ficou de fora. Endereço repetido não é falha; página curta usa a chamada geral do site de propósito; o resto é só clicar em Gerar agora — a geração retoma de onde parou e não cobra de novo pelas páginas que já têm chamada.

Veja também

Precisa de ajuda?

Fale com o suporte da Data Stone pelo canal combinado com a sua conta. Tenha à mão o nome do site, o endereço da página cuja chamada está errada e o nome da regra que deveria alcançá-la.