Boas práticas

Seguir estas boas práticas ajudará você a aproveitar ao máximo o REDA AI, proteger os dados da sua organização de produção e garantir uma implantação tranquila para os seus usuários.

1. Sempre teste primeiro em um sandbox

Nunca configure nem implante o REDA AI diretamente na sua organização de produção. Os sandboxes do Salesforce foram criados exatamente para esse fim — eles oferecem um ambiente seguro para testar todas as alterações de configuração antes que elas afetem usuários reais e dados reais.

O que testar no sandbox antes de entrar em produção:

• A persona e o comportamento do agente (ele responde como esperado?)
• A configuração dos campos de contexto (o agente está vendo os dados corretos do registro?)
• O comportamento das ferramentas e ações (as ações exibem o prompt de confirmação correto?)
• As atribuições de conjuntos de permissões (os usuários certos conseguem ver o agente?)
• O consumo de créditos (quantos créditos uma conversa típica consome?)

Antes de ativar qualquer agente, abra sua Pré-visualização de Execução do Agente — ela mostra exatamente o que o agente carregará na próxima conversa (prompts, ferramentas, chips de sugestão e eventuais conflitos de configuração), para que você detecte erros antes dos seus usuários.

2. Comece com um único agente bem configurado

É tentador criar vários agentes de uma vez. No entanto, acertar a configuração de um único agente — com prompts claros, campos de contexto bem escolhidos e ferramentas testadas — ensina o que funciona e economiza um tempo considerável ao criar os agentes seguintes.

O recurso Criar agente com IA do REDA AI pode acelerar esse processo. Depois que o agente estiver em funcionamento, você pode usá-lo para obter sugestões orientadas por IA que melhoram os prompts, os campos de contexto e os chips de sugestão do agente — tudo em uma única etapa. Consulte Criar agente com IA.

3. Escreva prompts claros e específicos

A qualidade das respostas do seu agente depende muito da qualidade dos seus prompts. Instruções vagas produzem respostas vagas. Siga estas diretrizes:

• Seja específico sobre o papel do agente — "Você é um especialista em locação que ajuda a equipe com dúvidas sobre contratos de locação, cálculos de aluguel e comunicação com locatários" é muito melhor do que "Você é um assistente útil".
• Defina o que o agente deve e não deve fazer — Use prompts de Guardrail para declarar explicitamente os temas que o agente deve recusar.
• Mantenha os prompts concisos — Prompts excessivamente longos podem diluir o foco. Cada registro de prompt deve ter um propósito único e claro.
• Teste de forma iterativa — Depois de cada alteração no prompt, teste as respostas do agente antes de salvar como versão final.

Para orientações detalhadas sobre redação, consulte Boas Práticas de Prompts.

4. Configure os campos de contexto com critério

Os campos de contexto permitem que o agente leia dados do registro atual para dar respostas relevantes. Incluir campos demais desperdiça créditos; incluir de menos faz com que o agente precise buscar informações que já deveria conhecer.

• Inclua apenas os campos mais relevantes para as perguntas que os usuários costumam fazer sobre aquele tipo de registro.
• Use o Otimizador de Campos de Contexto para obter recomendações orientadas por IA sobre quais campos incluir.
• Revise e reduza os campos de contexto quando o consumo de créditos estiver acima do esperado.

5. Monitore o consumo de créditos regularmente

Defina um lembrete no calendário para verificar o consumo de créditos na guia Administrador pelo menos uma vez por mês. Identificar padrões de consumo inesperados logo no início — por exemplo, um agente processando conversas incomumente longas — permite otimizar antes que os créditos se esgotem.

O REDA AI fornece um histórico de créditos mês a mês, mostrando os créditos alocados, consumidos, transferidos e de recarga de cada período. Use-o para identificar tendências e planejar recargas, se necessário. Consulte Otimização do Uso de Créditos.

6. Configure alertas de registro de incidentes

O REDA AI registra erros automaticamente como registros de Registro de Incidentes de IA. Revisar esses registros periodicamente — ou configurar notificações do Salesforce Flow para novos incidentes — ajuda você a identificar e resolver problemas antes que afetem muitos usuários. Consulte Registros de Incidentes de IA.

Faça o alerta ser específico em vez de indiscriminado. A gravidade de um incidente é um destes três valores exatos — WARNING, ERROR e CRITICAL —, então um Flow acionado por registro e filtrado por Severity = 'CRITICAL' avisa você das falhas que exigem uma pessoa, sem incomodar ninguém pelas transitórias. Um fluxo constante de registros WARNING é normal em qualquer sistema conectado.

7. Documente a configuração do seu agente

Mantenha um registro simples (até mesmo um documento compartilhado) do que cada agente foi projetado para fazer, quais prompts estão ativos e quais ferramentas estão atribuídas. Isso facilita muito a solução de problemas, a integração de novos administradores e a revisão da configuração durante as atualizações.

Perguntas frequentes