Conteúdo com IA

Tipo

Referência

Para

Analista

Na tela

DataViz › Alertas › Criar alerta › Conteúdo › Análise com IA

O bloco Análise com IA põe no alerta um texto escrito por um agente de IA. Na hora do envio, o agente consulta as Aplicações escolhidas, segue o briefing e devolve a análise em texto, que entra na mensagem na posição do bloco. O bloco aparece para quem pode usar IA: a função Usar IA não pode estar bloqueada para a pessoa, e o Tenant precisa ter IA disponível.

Cada destinatário recebe uma análise própria. O agente roda uma vez por pessoa, com o acesso a dados dela: quem tem restrição de linha recebe uma análise feita só sobre as linhas que pode ver (veja acesso a dados). Por isso o consumo de créditos cresce com o número de destinatários; o custo está em créditos de IA.

Campos

Campo	O que é
Skill	Uma rotina de análise salva em Agentes de IA, com Aplicações e passos prontos. O padrão é Sem skill; Nova skill abre a criação
Aplicações (máx 3)	De onde o agente pode consultar. Com skill escolhida, fica oculto: Definido pela skill
O que olhar	O briefing, de 50 a 4.000 caracteres. Com skill, vira Ajuste para este alerta (opcional), sem mínimo
Relatórios de exemplo (opcional, máx 5)	Consultas prontas que o agente usa como ponto de partida
Avançado › Memória (entregas passadas)	Quantas análises anteriores o agente relê antes de escrever. De 1 a 10; padrão 3 (salvar 0 grava 3)

O resultado sai sempre em texto. O bloco não tem escolha de modelo nem de formato de saída.

Briefing

Escreva em O que olhar o que a análise deve responder, para quem e com que corte. Um briefing que funciona diz o período, a comparação e o que fazer com o que achar:

Compare as vendas de ontem com a média das últimas 4 semanas para o
mesmo dia da semana, por filial. Liste só as filiais que caíram mais
de 15%, com o valor de ontem e a média. Termine com uma frase sobre
o total da rede.

Gerar com IA propõe três briefings a partir das Aplicações escolhidas (Anomalias, Resumo periódico e Tracking de KPI); Usar este copia o escolhido para o campo. Sem Aplicação no bloco, o botão fica desligado, e por isso ele não funciona com skill escolhida.

Com skill e o campo de ajuste vazio, o agente executa os passos da skill e entrega o resultado unificado.

Relatórios de exemplo

Um relatório de exemplo é uma consulta montada por você: Aplicação, Campos, Filtros e Ordenação. Criar do zero abre o editor; Selecionar bookmark… e Importar, que aparecem quando as Aplicações escolhidas têm visões salvas, copiam uma delas. Como os exemplos dependem das Aplicações do bloco, também não se montam com skill escolhida. A cópia fica desligada da visão original: mudar a visão depois não muda o exemplo.

Cada exemplo tem Nome do relatório e Contexto do exemplo (opcional), onde você diz para que ele serve. Sem nome ou sem nenhum campo, o alerta não salva. Exemplo de uma Aplicação que quem salva não acessa é descartado sem aviso.

Memória

Com memória, o agente lê as últimas entregas enviadas àquele destinatário antes de escrever e consegue dizer "pela terceira semana seguida" ou evitar repetir o que já disse. A memória é por pessoa: cada destinatário tem o seu histórico. Cada entrega anterior entra cortada em 800 caracteres, e só a do primeiro bloco de IA do alerta. Hoje não dá para desligar a memória: salvar 0 grava 3.

Roteiro fixo

Para um alerta que precisa sair igual todo dia, com as mesmas tabelas e os mesmos números, monte o roteiro em vez de deixar o agente escolher o caminho:

1. Crie um relatório de exemplo para cada tabela que a análise deve trazer, já com os filtros de período (Ontem, Mês Atual).
2. No Contexto do exemplo, diga o que aquele relatório representa ("vendas de ontem por filial, já filtradas").
3. No briefing, mande rodar os exemplos como estão e diga o que escrever a partir deles.

Rode os relatórios de exemplo sem alterar filtros. Com o primeiro,
liste as 5 filiais com maior queda. Com o segundo, diga quantos
pedidos ficaram parados e o valor somado.

Totais pedidos assim saem de consulta agregada. Lista longa de linhas pode chegar cortada ao agente, então peça a soma, a contagem ou o ranking direto no relatório, em vez de pedir que o agente some uma lista.

Salvar como skill, num bloco Sem skill, cria uma skill com as Aplicações do bloco e liga o bloco a ela. O briefing e os relatórios de exemplo ficam no alerta, então o roteiro não vai junto para a skill. O alerta precisa estar salvo e sem alterações pendentes; senão, aparece Salve o alerta antes de salvar este bloco como skill.

Testar

Testar agora roda o agente com o seu acesso e mostra o texto na tela, sem enviar. O teste tem limite de 150 segundos; no envio de verdade, o limite é de 500 segundos por destinatário. Estourar o tempo faz a entrega daquele destinatário falhar.

Limites

Limite	Valor
Destinatários	Até 50, contando os membros dos grupos. Acima disso, o alerta não salva, e Forçar Envio recusa com Alertas com conteúdo de IA são limitados a 50 destinatários (este tem N). Reduza a lista para enviar. Se um grupo crescer depois e passar de 50 ativos, o envio agendado é bloqueado e o histórico registra Alerta de IA excede o limite de 50 destinatários (atual: N). Execução bloqueada.
Aplicações	3
Relatórios de exemplo	5
Briefing	50 a 4.000 caracteres; com skill, até 4.000
Memória	1 a 10 entregas

Quando o Tenant atinge o limite mensal de créditos de IA, o bloco chega com O uso de IA neste ambiente atingiu o limite mensal, por isso esta análise não foi gerada. Fale com o administrador para verificar os limites. Os outros blocos saem.

Se a skill usada pelo bloco for excluída, a análise não é gerada e o bloco chega com a mensagem O agente de IA deste alerta foi excluído, por isso esta análise não foi gerada. Edite o alerta para escolher outro agente. Os outros blocos do alerta saem normalmente.

Relacionado

• Conteúdo do alerta
• Agentes de IA e skills
• Créditos de IA