Referência de configurações da plataforma
Todas as configurações, grupo a grupo
Esta é a lista completa como aparece em REDA AI Admin → Configuration na versão atual: 34 configurações em seis grupos, na ordem da tela, com o valor padrão e a descrição do próprio produto. As seções temáticas seguintes aprofundam as que precisam.
System & Notifications
| Configuração | Padrão | O que controla |
|---|---|---|
| REDA AI Enabled | — | Chave mestra. Ao desativar, todos os recursos da REDA AI param para todos os usuários da organização. |
| Email Reply Tracking | Off | Rastreia as respostas aos e-mails enviados a partir de conversas da REDA AI. |
| Notification Sender Email | — | O endereço “De” dos e-mails de notificação de incidentes. Precisa ser um endereço verificado para toda a organização. |
External Channels
| Configuração | Padrão | O que controla |
|---|---|---|
| External Bot API | — | Habilita o endpoint REST para integrações com chatbots externos (WhatsApp, SMS, etc.). |
| External Bot Daily Credit Cap | 500 | Créditos máximos por dia para as chamadas à API do bot externo. 0 significa sem limite. |
| Community Portal Chat | — | Habilita o widget de chat com IA nos portais do Experience Cloud (comunidade). |
| Community Bot Daily Credit Cap | 2000 | Créditos máximos por dia para o chat do portal da comunidade. 0 significa sem limite. |
AI Response Limits
| Configuração | Padrão | O que controla |
|---|---|---|
| Tokens máx. de saída | 4000 | Comprimento máximo da resposta para o chat padrão e a pré-extração de arquivos. É um teto, não uma meta. |
| Agent Builder Max Tokens | 12000 | Tokens máximos para “Build Agent with AI”. Divididos 60/40 entre duas chamadas de IA (etapa 1 = 7200, etapa 2 = 4800). Aumente para 16000 em agentes muito complexos. |
| Prompt Optimizer Max Tokens | 4096 | Tokens máximos para a otimização de prompts e campos de contexto. |
| Tool Builder Max Tokens | 4096 | Tokens máximos para gerar e otimizar ferramentas. Ferramentas Apex complexas podem exigir 6000 ou mais. |
| Debugger Max Tokens | 3000 | Tokens máximos para a depuração de conversas e a análise de incidentes. |
| Conflict Detector Max Tokens | 1024 | Tokens máximos para a análise de conflitos entre prompts. |
| Prompt Generator Max Tokens | 2048 | Tokens máximos para o conteúdo de prompts gerado por IA. |
| Tool Iteration Max Tokens | 1000 | Tokens por rodada intermediária do laço de ferramentas (apenas chamadas de ferramenta, não prosa completa). |
| Greeting Max Tokens | 800 | Tokens para respostas curtas de saudação (“Oi”, “Olá”). |
| Deep Reasoning Max Tokens Cap | — | Limite superior dos tokens de saída totais de um agente (resposta mais raciocínio estendido) quando o Deep Reasoning está ativo. |
| Max API Retries | 3 | Novas tentativas em chamadas limitadas por taxa (429) ou sobrecarregadas (529). Não afeta trabalhos agendados. |
| Buscas na web máx. | 5 | Buscas na web por turno de conversa. Cada busca consome créditos adicionais. Aplica-se apenas aos agentes com busca na web habilitada. |
Query & Data Limits
| Configuração | Padrão | O que controla |
|---|---|---|
| Max Query Rows | 200 | LIMIT anexado automaticamente às consultas SOQL geradas pelas ferramentas. |
| Max Display Rows | 50 | Linhas exibidas inline antes de resumir com “mostrando X de Y”. |
| Max Query Result Length | 15000 | Caracteres máximos por resultado de ferramenta enviado ao modelo. Valores maiores trazem mais dados e consomem mais tokens. |
| Dias de retenção de arquivos | 180 | Dias de retenção dos registros de conversa arquivados antes da exclusão. |
| Incident Deduplication Window | 0 (disabled, logs all incidents) | Minutos durante os quais incidentes duplicados são suprimidos (mesma classe, método e erro). 0 desativa e registra todos. |
Conversation Optimization
| Configuração | Padrão | O que controla |
|---|---|---|
| Orçamento de tokens do histórico | — | Orçamento estimado de tokens para o histórico da conversa. As mensagens completas mais recentes são mantidas até esgotá-lo. |
| Greeting Char Threshold | 20 | Uma entrada menor que isso é tratada como saudação e usa um orçamento de tokens reduzido. |
File Processing & Streaming
| Configuração | Padrão | O que controla |
|---|---|---|
| Max File Size (MB) | 5 MB | Tamanho máximo de arquivo enviado, em megabytes. Arquivos acima disso são rejeitados. |
| Allowed File Extensions | pdf,csv,png,jpg,jpeg,txt,json | Extensões permitidas para upload, separadas por vírgulas. |
| Max CSV Characters | 50000 | Número máximo de caracteres do conteúdo de um CSV. CSVs acima disso retornam erro. |
| File Processing Credit Multiplier | 2 (e | Multiplica o orçamento máximo de tokens de saída no processamento de arquivos (por exemplo, 2000 tokens × 2 = 4000). |
| File Distribution Threshold (KB) | 1300 KB | Arquivos binários maiores que este limiar recebem uma URL pública temporária para a IA. |
| Distribution Link Expiry (Minutes) | 30 | Minutos até os links temporários de arquivo expirarem sozinhos. Eles também são excluídos após cada chamada de API. |
| Email File Processing | Off | Processa os anexos recebidos pelo serviço de e-mail. Exige um agente de processamento de e-mail. |
| Admin Tools Always Stream | On | As ferramentas de administração (Agent Builder, Tool Builder, Prompt Builder) usam chamadas em streaming para evitar timeouts. |
Agent Definition → Max Tool Iterations, padrão 6: cinco rodadas de ferramenta mais uma resposta de texto forçada). O registro de toda a organização está obsoleto e não é mais lido, então alterá-lo não tem efeito. Defina o teto por agente.
Chaves mestras
Essas chaves ativam e desativam capacidades inteiras. Use 1 para ativado e 0 para desativado.
| Configuração | Padrão | Finalidade |
|---|---|---|
| Is Enabled | 1 |
Chave mestra de desligamento da REDA AI. Quando desativada, todas as interações de IA são bloqueadas. |
| External Bot Enabled | 1 |
Chave mestra da funcionalidade de chatbot externo. Quando desativada, todas as solicitações de API REST vindas de widgets de chatbot externos são rejeitadas. Ative depois de configurar um Salesforce Site e um perfil de Usuário Convidado. |
| Community Bot Enabled | 1 |
Chave mestra do chatbot do portal da comunidade. Quando desativada, todas as solicitações de API REST vindas de widgets da comunidade são rejeitadas. |
| Email File Processing Enabled | 0 |
Controle de segurança que determina se os anexos de mensagens recebidas pelo Serviço de E-mail são processados. Quando desativado, o handler ignora os anexos — mas um e-mail roteado ainda chega ao seu agente como uma conversa; essa configuração não bloqueia o canal. Desativado por padrão. |
| Email Tracking Enabled | 0 |
Ativa o rastreamento de respostas de e-mail para ações agendadas. Quando ativado, um trigger de EmailMessage monitora as respostas recebidas a e-mails de saída rastreados e dispara as ações agendadas associadas. Requer o Enhanced Email ativado na organização. |
| Admin Tools Always Stream | 1 |
Quando ativado, as ferramentas de administração (Construtor de Agentes, Construtor de Ferramentas, Construtor de Prompts) sempre usam a API de streaming, independentemente das configurações do agente. Evita timeouts durante operações complexas assistidas por IA. |
Chaves de licença
Essas configurações armazenam valores de licença criptografados que a plataforma usa para autorizar as chamadas de IA. Elas são preenchidas pelo fluxo de ativação de licença na guia Admin; os administradores nunca editam os valores diretamente. Consulte Ativação da sua licença.
Para alterar qual licença está em vigor, execute o fluxo Ativar Licença na guia Admin. A plataforma cuida da atualização segura dessas configurações para você.
Processamento de arquivos
Controla quais arquivos os agentes podem ler, o tamanho máximo permitido e como arquivos grandes são entregues ao modelo. Consulte Processamento de Documentos para conhecer o pipeline completo.
| Configuração | Padrão | Finalidade |
|---|---|---|
| Allowed File Extensions | pdf,csv,png,jpg,jpeg,txt,json |
Lista de extensões de arquivo permitidas para upload, separadas por vírgula. Arquivos com extensões fora desta lista são rejeitados. |
| Max File Size MB | 5 |
Tamanho máximo permitido para uploads, em megabytes. Arquivos que excedem esse limite são rejeitados antes do processamento. |
| Max CSV Characters | 50000 |
Número máximo de caracteres permitido em um arquivo CSV. Arquivos que excedem esse limite retornam um erro (sem truncamento). Defina como 0 para não ter limite. |
| File Distribution Threshold KB | 1300 |
Tamanho de arquivo (KB) acima do qual arquivos binários (PDF, PNG, JPG) recebem uma URL pública temporária para o modelo, em vez de serem incorporados diretamente. Arquivos de texto são sempre incorporados diretamente, independentemente desse limite. |
| Distribution Expiry Minutes | 30 |
Minutos até que um link temporário de distribuição de arquivo expire. Funciona como uma rede de segurança — os links também são excluídos após a chamada de API do modelo e pelo job de limpeza que roda a cada hora. |
| File Processing Credit Multiplier | (padrão da plataforma) | Controla o quanto a plataforma expande de forma agressiva o orçamento de saída em turnos com arquivos, para que o agente possa produzir resultados de extração mais completos. Reduza esse valor em agentes que precisam de saídas estruturadas curtas a partir de muitos arquivos pequenos; aumente-o em agentes que produzem extrações estruturadas longas. |
Limites de créditos
Os limites diários evitam custos descontrolados vindos de canais voltados ao público externo. Eles são independentes dos créditos mensais da licença. Consulte Como funcionam os créditos.
| Configuração | Padrão | Finalidade |
|---|---|---|
| External Daily Credit Cap | 500 |
Total máximo de créditos que todas as sessões de chatbot externo combinadas podem consumir por dia, em todos os agentes. Defina como 0 para não ter limite (não recomendado). |
| Community Daily Credit Cap | 2000 |
Máximo de créditos que todas as sessões de chatbot do portal da comunidade combinadas podem consumir por dia-calendário. Deixe em branco ou como 0 para não ter limite. Independente do Limite Diário de Créditos Externo. |
Histórico de conversas e contexto
Controla quanto do histórico da conversa o modelo vê em cada turno. A REDA AI mantém as mensagens completas mais recentes cujo tamanho combinado cabe em um orçamento de tokens — ela nunca trunca uma mensagem individual (o truncamento corromperia chamadas/resultados de ferramentas). Um orçamento menor economiza créditos; um orçamento maior dá mais memória ao agente.
| Configuração | Padrão | Finalidade |
|---|---|---|
| Orçamento de tokens do histórico | 30000 |
Orçamento de tokens para o histórico de conversa por solicitação. A REDA AI inclui as mensagens completas mais recentes que cabem nesse orçamento e descarta inteiramente as mais antigas — nunca cortando uma mensagem no meio do conteúdo. Mínimo de 4.000. |
| Profundidade máx. de continuação | 3 |
Nos canais Widget Externo e Comunidade, depois que uma ação é executada automaticamente, o agente realiza automaticamente um turno de acompanhamento para relatar o resultado real. Esta configuração limita quantos desses turnos de continuação automática podem ocorrer por solicitação. |
Execução do agente
Controla o orçamento de saída do modelo por turno e o formato do loop agêntico.
| Configuração | Padrão | Finalidade |
|---|---|---|
| Tokens máx. de saída | 2000 |
Máximo de tokens de saída para as respostas da REDA AI. Valores mais altos permitem respostas mais longas (por exemplo, planos de ação complexos), mas custam mais créditos. Intervalo: 1000–4096. |
| Máximo de iterações de ferramentas | 6 |
Número máximo de iterações no loop agêntico de ferramentas (N−1 turnos de ferramenta + 1 resposta em texto forçada). Intervalo: 3–10. Valores mais altos permitem solicitações multietapas mais complexas, mas consomem mais créditos. |
| Tool Iteration Max Tokens | — | Orçamento de saída por iteração dentro do loop agêntico de ferramentas. Reduz a saída durante os turnos intermediários de chamada de ferramentas para controlar o custo. |
| Greeting Char Threshold | 20 |
Limite de comprimento de caracteres abaixo do qual uma mensagem de início de conversa é tratada como saudação. Intervalo: 5–100. Saudações recebem o orçamento menor de Máximo de Tokens de Saudação. |
| Greeting Max Tokens | 800 |
Máximo de tokens de saída para mensagens de saudação em início de conversa (entrada curta). Intervalo: 400–2000. |
Consulta e exibição
Limites do que o agente lê do Salesforce por solicitação, e quanto disso o usuário vê.
| Configuração | Padrão | Finalidade |
|---|---|---|
| Max Query Rows | 200 |
Limite do número de linhas que o agente recupera por consulta SOQL. Aplicado automaticamente quando a consulta não tem cláusula LIMIT; consultas agregadas sem agrupamento estão isentas. |
| Max Query Result Length | 15000 |
Comprimento máximo (em caracteres) de um resultado de consulta serializado retornado ao agente. Payloads maiores são truncados para manter o contexto do modelo administrável. |
| Max Display Rows | 50 |
Número máximo de linhas exibidas em resultados de consulta formatados. Contagens de linhas maiores retornam apenas totais, com uma nota explicando o limite. |
Pesquisa na Web
| Configuração | Padrão | Finalidade |
|---|---|---|
| Buscas na web máx. | 5 |
Número máximo de pesquisas na web que a IA pode realizar por turno de conversa. Controla o orçamento de pesquisa na web do lado do servidor do modelo. |
Funcionalidades de IA para administradores — Orçamentos de tokens de saída
Cada funcionalidade administrativa assistida por IA tem seu próprio orçamento de resposta. Orçamentos maiores produzem saídas mais completas a um custo em créditos mais alto.
| Configuração | Padrão | Usado por |
|---|---|---|
| Agent Builder Max Output Tokens | 12000 |
Criar agente com IA — analisador amplo que abrange várias superfícies, por isso tem o maior orçamento. |
| Tool Builder Max Output Tokens | 4096 |
O Gerador de IA do Construtor de Ferramentas ao produzir definições de ferramentas do tipo Template SOQL, Mapeamento de Arquivos ou Classe Apex. |
| Prompt Generator Max Output Tokens | 2048 |
O Gerador de Prompts de IA ao produzir novos prompts de agente a partir de descrições de intenção do usuário. |
| Optimizer Max Output Tokens | 4096 |
Otimizador de prompts e Otimizador de campos de contexto. |
| Debugger Max Output Tokens | 3000 |
Depurador de Conversas e Depuração com IA em incidentes. |
| Conflict Detector Max Output Tokens | 1024 |
A análise de IA do Detector de Conflitos de Prompts. Detecta conflitos entre prompts de agentes, ferramentas e campos de contexto. |
Rede e novas tentativas
| Configuração | Padrão | Finalidade |
|---|---|---|
| Número máximo de tentativas | 3 |
Número máximo de tentativas de nova chamada HTTP para respostas da API do modelo limitadas por taxa (HTTP 429) ou sobrecarregadas (HTTP 529). Não afeta as novas tentativas de execução de Ações Agendadas. |
Notificações
| Configuração | Padrão | Finalidade |
|---|---|---|
| Notification From Email | (em branco) | Endereço de e-mail usado como remetente dos e-mails de notificação de incidentes. Também precisa estar configurado como um endereço de e-mail de toda a organização na Configuração (Setup). Deixe em branco para desativar as notificações por e-mail — as notificações no aplicativo continuam funcionando. |
| Billing Contact Email | (em branco) | Endereço de e-mail para alertas de limite de créditos e resumos mensais de uso. Deixe em branco para desativar as notificações por e-mail. |
Tratamento de incidentes
| Configuração | Padrão | Finalidade |
|---|---|---|
| Incident Deduplication Minutes | 0 |
Minutos durante os quais incidentes duplicados com a mesma classe, método e tipo de erro são suprimidos. Defina como 0 (padrão) para desativar a deduplicação e registrar todos os incidentes. Intervalo: 0–60. |
Arquivamento e retenção
| Configuração | Padrão | Finalidade |
|---|---|---|
| Dias de retenção de arquivos | 180 |
Dias durante os quais Conversas, Mensagens e Transações de Crédito são retidas antes do arquivamento. Defina como 0 para desativar o arquivamento. |
Integração com a base de conhecimento
| Configuração | Finalidade |
|---|---|
| KB JWT Secret | Segredo compartilhado HMAC-SHA256 usado para autenticação JWT da Base de Conhecimento. Clientes que fazem integração com a Base de Conhecimento hospedada da REDA AI configuram este valor para corresponder à variável de ambiente equivalente no host da base de conhecimento. |
Onde editar as configurações
Abra a guia Admin da REDA AI e selecione Configurações da plataforma. Cada configuração é um registro de Metadados Personalizados (Custom Metadata) no pacote. As edições feitas pela interface do Admin são implantadas por meio da API padrão de Metadados do Salesforce; espere um pequeno atraso entre salvar e a alteração entrar em vigor.
As configurações também podem ser editadas diretamente em Configuração (Setup) › Tipos de Metadados Personalizados › REDA AI Setup › Gerenciar Registros, mas a guia Admin as apresenta com rótulos amigáveis, validação e agrupamento que a lista bruta de registros não oferece.
Checklist de atualização para administradores
- Confirme o pacote: Configuração → Pacotes instalados → REDA AI deve mostrar 1.16000. Teste em sandbox adequado antes da produção.
- Preserve configuração: faça backup dos metadados de ferramentas, prompts próprios, layouts, permissões e ações pendentes.
- Mescle ferramentas: Configuração → Tipos de metadados personalizados → Definições de ferramentas REDA AI → Gerenciar registros. Confira Descrição/Esquema de entrada de send_email e Descrição de schedule_action. Descrições, esquemas e canais controlados pelo assinante exigem mesclagem intencional, sem substituir registros personalizados inteiros. Para bases antigas, revise também create_task, create_event e get_record. Requires Confirmation empacotado é controlado pelo desenvolvedor.
- Mescle prompts: Seed Default Data pode sobrescrever todos os prompts padrão compartilhados. Preserve alterações próprias; não o execute às cegas para uma única instrução.
- Revise campos: use a tabela. Conjuntos empacotados podem atualizar; confira atribuições, perfis e conjuntos próprios/clonados. Adicione campos aos layouts personalizados por Configuração → Gerenciador de objetos → objeto → Layouts de página e conceda apenas a segurança de campos necessária.
- Revise listas: em Campos e relacionamentos, confira Definição de agente → Nível de processamento: valor API exato
Economy. Se Tipo de solicitação já existia em Solicitação assíncrona de IA, confiraContinuationeBulk Turn. Adicione valores ausentes, preserve a grafia API e habilite os tipos de registro aplicáveis. Listas restritas podem rejeitar valores ausentes; um campo recém-instalado inclui seus valores empacotados. - Revise agendamentos: nos controles do agendador do REDA AI Admin, confira processador, proprietário e pendências. Ativar pode executar trabalho existente; a atualização não decide isso por você.
Checklist completo de campos e verificação
Perguntas frequentes
Para toda a organização. Todos os usuários de REDA AI na sua organização veem os mesmos valores de configuração. As substituições por agente acontecem no registro de Definição de Agente, não em Configurações da plataforma.
Na próxima conversa do agente. As edições são implantadas por meio da API padrão de Metadados do Salesforce; as conversas em andamento terminam com os valores com os quais começaram.
Não — essas configurações contêm valores criptografados gerenciados pela plataforma. Para renovar ou substituir uma licença, use o fluxo Ativar Licença na guia Admin. A plataforma cuida da atualização segura para você.
Padrões conservadores mantêm o consumo de créditos previsível no primeiro dia. Depois de observar o uso real na visualização de Análise de conversas, aumente os valores que melhoram a qualidade do agente e reduza os que não melhoram.
Para a maioria dos agentes, Orçamento de Tokens de Histórico e Máximo de Tokens de Saída têm o maior impacto direto. Agentes que processam muitos arquivos também são sensíveis ao Multiplicador de Créditos de Processamento de Arquivos. Consulte Otimização do uso de créditos.
A plataforma limita o valor ao intervalo suportado em tempo de execução. Valores fora do intervalo não geram erro, mas também não entram em vigor — o valor válido mais próximo é usado.
Algumas configurações aceitam 0 ou em branco como “desativado” (Dias de Retenção para Arquivamento, E-mail de Origem das Notificações, Limite Diário de Créditos Externo, Minutos de Deduplicação de Incidentes). A descrição de cada configuração acima indica se 0/em branco é um valor de desativação válido.
Próximos passos
Leia Configurações da plataforma para o passo a passo do painel de administração, ou Otimização do uso de créditos para saber quais configurações ajustar para reduzir custos.