Configurações de IA

A página Configurações de IA permite visualizar o status dos recursos de IA, monitorar o uso, gerenciar dados de treinamento e manter o histórico de conversas.

Acessando as Configurações de IA

A forma mais rápida é pelo assistente de chat de IA:

1. Abra o widget de chat de IA (o balão de chat roxo no canto inferior direito do Painel de administração).
2. Use o link Ver uso no painel do chat para abrir a página Configurações de IA. (Você também verá um link para Configurações de IA se atingir seu limite diário de solicitações.)

Você precisa ter uma conta de administrador com acesso à IA no seu plano para abrir esta página.

Status do Plano e Acesso

No topo da página, você verá o status atual do seu acesso à IA:

• IA Habilitada — Seu plano inclui recursos de IA e eles estão ativos.
• IA Não Incluída — Seu plano atual não inclui IA. Você verá opções de upgrade com preços e detalhes dos recursos.
• Recursos de IA Desabilitados pelo Administrador — O administrador da plataforma desabilitou temporariamente a IA em todo o sistema. Entre em contato com o administrador do sistema se acreditar que isso é um erro.

Fazendo Upgrade para Acesso à IA

Se o seu plano não incluir IA, a página de configurações exibe:

• O nome e o preço do plano de upgrade recomendado
• Uma lista dos recursos de IA incluídos (Assistente de Chat de IA, Geração de Conteúdo com IA, limite diário de solicitações)
• Um link direto para a página de Cobrança para fazer upgrade

Visão Geral de Uso

A seção de uso mostra como sua igreja está consumindo os recursos de IA:

Solicitações de Hoje

Uma barra de progresso visual (rotulada Solicitações de Hoje) mostra quantas das suas solicitações diárias foram usadas. A barra muda de cor conforme você se aproxima do limite:

• Roxo — Uso normal (abaixo de 70%)
• Âmbar — Aproximando do limite (70–90%)
• Vermelho — Próximo ou no limite (90–100%)

Abaixo da barra, você pode ver exatamente quantas solicitações restam para o dia.

Estatísticas de 30 Dias

Quatro cartões de resumo exibem:

• Total de Solicitações (30d) — Quantas solicitações de IA foram feitas nos últimos 30 dias
• Total de Tokens — Os tokens de entrada e saída consumidos combinados
• Custo Est. (30d) — O custo aproximado do seu uso de IA
• Conversas — Número total de conversas de IA armazenadas

Dados de Treinamento de IA

Dados de treinamento são as informações personalizadas que você fornece para ajudar a IA a dar respostas precisas e específicas da igreja. Isso é especialmente importante para o chat voltado aos membros, que depende desses dados para responder perguntas sobre sua igreja.

Adicionando Dados de Treinamento

1. Clique no botão Adicionar Contexto na seção Dados de Treinamento de IA.
2. Preencha o formulário:
   • Categoria — Selecione o tipo de informação (consulte as categorias abaixo)
   • Título — Um nome descritivo para esta entrada (ex.: «Horários de Culto de Domingo»)
   • Conteúdo — A informação real que a IA deve saber (até 5.000 caracteres)
   • Ativo — Marque esta caixa para ativar a entrada imediatamente
3. Clique em Salvar Contexto.

Categorias de Dados de Treinamento

Gerenciando Dados de Treinamento

Cada entrada de dados de treinamento mostra:

• O título e a categoria
• Selo de status Ativo/Inativo
• Uma prévia do conteúdo

Você pode:

• Alternar status ativo — Clique no ícone de olho para habilitar ou desabilitar uma entrada sem excluí-la. Entradas inativas não são usadas pela IA.
• Excluir — Clique no ícone de lixeira para remover permanentemente uma entrada (será solicitada confirmação).

Dica: Comece com o básico: horários de culto, localização e 5–10 perguntas frequentes. Você sempre pode adicionar mais dados de treinamento depois, conforme identificar lacunas nas respostas da IA.

Status dos Recursos

O painel Recursos no lado direito mostra quais capacidades de IA estão habilitadas no momento:

• Chat de Administração — O assistente de IA conversacional para administradores (o balão de chat roxo)
• Chat para Membros — O chat de IA voltado ao público para membros e visitantes
• Geração de Conteúdo — Os botões «Gerar» inline nos formulários de criação de conteúdo

Cada recurso mostra um selo «Habilitado» ou «Desabilitado». Eles são controlados no nível da plataforma e não podem ser alternados individualmente pelos administradores da igreja.

Detalhes do Seu Plano

O painel Plano mostra:

• O nome e o preço mensal do seu plano atual
• Se a IA está incluída no seu plano
• Seu limite diário de solicitações
• Sua alocação mensal de tokens
• Quantas solicitações restam para hoje

Limpando o Histórico de Conversas

Na parte inferior da coluna direita, você encontrará o botão Limpar Histórico Antigo em Manutenção. Isso exclui registros de conversas com mais de 30 dias do servidor para liberar armazenamento.

• Apenas conversas com mais de 30 dias são removidas
• Conversas recentes (nos últimos 30 dias) são preservadas
• Isso se aplica tanto a conversas de administração quanto de membros da sua igreja
• Será solicitada confirmação antes que a exclusão prossiga

Nota: Limpar o histórico no servidor não afeta o histórico de conversas armazenado no armazenamento local do seu navegador. Para limpar o histórico local, use a opção «Limpar Todo o Histórico» dentro do próprio widget de chat.

Dicas Rápidas

A página de configurações inclui um painel Dicas Rápidas com lembretes:

• Adicione horários de culto, crenças e FAQs para melhorar as respostas da IA
• Use o widget de chat (canto inferior direito) para fazer perguntas
• Procure botões «Gerar» nos formulários para criar conteúdo com IA
• Sempre revise o conteúdo gerado pela IA antes de publicar

Para operadores do TimelyChurch (auto-hospedagem / equipe da plataforma)

A maioria dos administradores de igreja não precisa desta seção. Estas notas são para o operador que implanta e configura o TimelyChurch.

Configuração do provedor

Os recursos de IA são servidos pelo xAI Grok. As configurações do provedor ficam em config/ai.php e são lidas das variáveis de ambiente:

Referência de preços

O cartão «Custo Est. (30d)» usa as taxas configuradas em config/ai.php:

• Tokens de entrada: US$ 5,00 por 1M de tokens
• Tokens de saída: US$ 15,00 por 1M de tokens

Isso reflete os preços padrão do grok-3 em 2026. Substitua com as variáveis de ambiente AI_PRICE_INPUT / AI_PRICE_OUTPUT (ou edite pricing.input_per_million / pricing.output_per_million) se as taxas da xAI mudarem.

Interruptor global da plataforma

Um Super Admin pode desabilitar recursos de IA para toda a plataforma — substituindo o acesso por plano de cada igreja — pela Configuração de Sistema ai_module_enabled (painel Super Admin → Configurações do Sistema). Quando desabilitado, as igrejas veem uma mensagem configurável de desabilitação (ai_disabled_message).

Onde o modelo conhece seus dados

O contexto específico de cada módulo é construído em app/Services/AI/GrokPromptBuilder.php. O assistente de chat obtém até as últimas 20 mensagens de uma conversa e depois reduz esse histórico ao orçamento AI_MAX_CONTEXT_TOKENS (padrão 4.000 tokens, estimado com heurística de chars/4, mensagens mais antigas removidas primeiro) antes de enviá-lo ao modelo. Após 24 horas de inatividade, uma nova conversa é iniciada em vez de continuar a antiga.