Ativação e Desativação de Agentes
Entendendo o Active Status do Agente
Cada Definição de Agente tem uma caixa de seleção Active Status que controla se o agente está disponível para responder às mensagens dos usuários. Essa configuração é fundamental para a gestão de agentes:
- Active Status marcado — O agente está ativo e responde às mensagens dos usuários imediatamente.
- Active Status desmarcado — O agente está fora do ar. Os usuários não conseguem interagir com ele; em vez disso, veem uma mensagem de "indisponível".
O status ativo se aplica globalmente — se um agente está inativo, ele fica indisponível em todos os canais de implantação (Interno, Widget Externo, Comunidade, API).
O que acontece quando um agente está inativo?
| Cenário | Comportamento |
|---|---|
| Usuário abre o widget de chat | A janela de chat aparece, mas uma mensagem de "indisponível" é exibida no lugar do campo de digitação. O usuário não consegue enviar mensagens. |
| Usuário tenta enviar uma mensagem via API | A chamada de API retorna um status de erro indicando que o agente não está ativo. |
| Um Fluxo aciona o agente | O Fluxo recebe uma resposta de erro. O agente não processa a solicitação. |
| Conversas em andamento | Todo o histórico de conversas é preservado. Reativar o agente não exclui nenhum dado. |
Por que desativar um agente?
Há vários motivos válidos para desativar temporariamente um agente:
- Manutenção — Pausar o agente enquanto você atualiza prompts, ferramentas ou configurações.
- Testes — Testar alterações no sandbox antes de colocar o agente de volta no ar.
- Limites do plano — Seu plano da REDA AI pode limitar o número de agentes ativos. Desative agentes não utilizados para se manter dentro do limite.
- Uso sazonal — Desativar agentes necessários apenas em certas épocas do ano (por exemplo, um agente de recrutamento na temporada de contratações).
- Atualizações de versão — Desativar a versão antiga de um agente enquanto uma nova versão é implantada.
- Solução de problemas — Se um agente estiver se comportando de forma inadequada, desative-o temporariamente enquanto investiga.
Limites de agentes ativos por plano
Sua licença da REDA AI determina quantos agentes podem estar ativos simultaneamente. O plano gratuito permite 1 agente ativo; os planos pagos carregam seu próprio limite na chave de licença emitida pela REDA. Verifique os detalhes do seu plano na guia Admin para ver seu limite.
Se você tentar ativar um agente além do seu limite, o salvamento é bloqueado com a mensagem "Não é possível ativar este agente. Seu plano permite um máximo de X agentes ativos. Desative um agente existente primeiro ou atualize seu plano." Desative outro agente ou escreva para a equipe da REDA em sales@reda.one para ampliar seu limite.
Como ativar um agente
-
Abra o registro da Definição de Agente
No app REDA AI, vá para Gestão de Agentes e clique no agente que deseja ativar.
-
Localize o campo Active Status
Role para baixo no registro da Definição de Agente até encontrar a caixa de seleção "Is Active".
-
Marque a caixa de seleção
Clique na caixa de seleção para marcá-la.
-
Clique em Salvar
Salve o registro. O agente agora está ativo e responderá às mensagens dos usuários.
-
Verifique a ativação
Abra o widget de chat em uma página onde o agente está implantado e confirme que você consegue interagir com ele.
Como desativar um agente
-
Abra o registro da Definição de Agente
No app REDA AI, vá para Gestão de Agentes e clique no agente que deseja desativar.
-
Localize o campo Active Status
Role para baixo até encontrar a caixa de seleção "Is Active".
-
Desmarque a caixa de seleção
Clique na caixa de seleção para desmarcá-la.
-
Clique em Salvar
Salve o registro. O agente agora está fora do ar.
-
Verifique a desativação
Abra o widget de chat onde o agente estava implantado. Você deve ver a mensagem de "indisponível" no lugar do campo de digitação do chat.
Boas práticas
Sempre desative os agentes em vez de excluí-los. O Salesforce se recusará a excluir uma Definição de Agente enquanto ela tiver Prompts personalizados, Campos de Contexto ou Chips de Sugestão associados — a exclusão falha com um erro — e as conversas nunca são excluídas junto com um agente: elas permanecem na sua org, desvinculadas dele. A desativação é o caminho limpo: mantém toda a configuração intacta e reversível.
Monitore os limites de agentes ativos — Acompanhe quantos agentes estão ativos em relação ao limite do seu plano. Configure uma revisão periódica (trimestral) para desativar agentes que não estão mais em uso e liberar vagas para novos agentes.
Documente o motivo de um agente estar inativo — Se você desativar um agente, registre o motivo e quando ele poderá ser reativado — em um campo personalizado que a sua equipe adicione ou na documentação da própria equipe (a Definição de Agente não tem um campo de descrição integrado). Isso ajuda futuros administradores a entender o status do agente.
Teste antes da ativação completa — Ao ativar um agente recém-configurado pela primeira vez, teste-o em um ambiente sandbox primeiro. Depois de confirmar que está tudo certo, ative-o em produção.
Preservação de dados durante a desativação
Desativar um agente não exclui nenhum dado:
- Histórico de conversas — Todas as conversas anteriores são preservadas nos registros de conversa do agente.
- Configuração — Prompts, ferramentas, campos de contexto e configurações permanecem inalterados.
- Registros relacionados — Todos os registros relacionados (Prompts personalizados, Campos de Contexto etc.) permanecem intactos.
Ao reativar o agente, ele começa do zero com a configuração atual, mas todos os dados históricos continuam disponíveis para fins de relatório e auditoria.
Trilha de auditoria de ativação e desativação
A REDA AI entrega o objeto Definição de Agente com o rastreamento de histórico de campos já habilitado, então você não precisa ativar nada. Is Active é um dos 28 campos rastreados, ao lado dos que mudam o comportamento ou o alcance de um agente — Persona, Channel, Deep Reasoning, Execution Context, Allowed Origins, Economy Tier Consent, os limites de taxa e a External API Key. Abra o registro de Definição de Agente e veja sua lista relacionada de histórico para saber quem alterou uma configuração e quando.
Repare que isto é histórico do registro, não a Trilha de auditoria de configuração — esta última registra mudanças de configuração e metadados, não edições nos registros de Definição de Agente. O histórico de campos é o que responde “quem desativou este agente?”.
Ativação/desativação em massa
Se você precisar ativar ou desativar vários agentes de uma só vez:
- Use o Data Loader para exportar todos os registros de Definição de Agente.
- Modifique a coluna Active Status (true ou false) no arquivo CSV.
- Use o Data Loader para atualizar os registros com o novo status ativo.
Perguntas frequentes
Sim, sem dúvida. Desativar um agente apenas desliga seu Active Status. Você pode reativá-lo a qualquer momento marcando a caixa de seleção novamente. Toda a configuração e o histórico de conversas são preservados.
As conversas em andamento continuam funcionando até a sessão expirar (normalmente 30 minutos). Novas mensagens de novos usuários receberão a mensagem de "indisponível". A boa prática é avisar os usuários de que um agente será desativado durante uma janela de manutenção.
Não. Se você tentar ativar um agente já estando no limite, o Salesforce exibirá um erro. É preciso desativar outro agente primeiro ou fazer upgrade do plano para um nível superior.
Sim. Se um Fluxo ou sistema externo estiver chamando o agente via API, a chamada falhará com um erro indicando que o agente não está ativo. É preciso reativar o agente ou atualizar a integração para usar um agente diferente.
Próximos passos
Saiba como otimizar a configuração de agentes com Criar agente com IA, ou explore a gestão de prompts para ajustar as respostas do seu agente.