Prompts personalizados por agente
Arquitetura de prompts específica por agente
Na REDA AI, os Prompts personalizados são armazenados como registros com uma relação de busca (lookup) para registros de Definição de Agente. Esse design garante que:
- Cada agente tenha seu próprio conjunto isolado de prompts (além de quaisquer prompts universais — prompts sem agente definido — que carregam para todos os agentes)
- Os prompts de um agente não afetem outros agentes
- Você possa criar estratégias de prompt completamente diferentes para agentes diferentes
- Os agentes possam coexistir na mesma organização sem interferir uns nos outros
Esse é um princípio fundamental de design da REDA AI — os agentes são unidades independentes, com sua própria configuração, incluindo os prompts.
Vários agentes com prompts diferentes
Um cenário comum é ter vários agentes para departamentos diferentes, cada um com prompts personalizados:
| Agente | Departamento | Prompts principais |
|---|---|---|
| Assistente de vendas | Vendas | Persona: especialista em SaaS empresarial; Schema: campos de Oportunidade e Account; Guardrail: sem discussões sobre preços; Action: como criar tarefas |
| Bot de suporte | Suporte ao cliente | Persona: especialista em suporte empático; Schema: campos de Caso e Contact; Custom Instructions: oferecer soluções antes de escalar; Guardrail: proteger os dados do cliente |
| Assistente de RH | Recursos Humanos | Persona: consultor profissional de RH; Schema: campos de Employee (limitados); Guardrail: regras de confidencialidade; Action: direcionar ao portal de RH |
| Bot financeiro | Financeiro | Persona: especialista analítico em finanças; Schema: campos de Expense e Invoice; Guardrail: regras de conformidade; Custom Instructions: citar números de política |
Cada agente tem um tom, um conjunto de instruções e um escopo completamente diferentes, de acordo com as necessidades do seu departamento.
Compartilhar instruções comuns entre agentes
Quando a mesma instrução deve se aplicar a mais de um agente, você tem dois mecanismos — e com o primeiro você mantém o texto exatamente uma vez:
- Torne-o um prompt universal — Crie o Prompt personalizado e deixe o campo Definição de Agente em branco. Um prompt universal carrega para todos os agentes da org (as diretivas de idioma integradas vêm assim). O escopo por Canal e Objetos de Contexto continua valendo, então um prompt universal pode mirar apenas certos canais ou contextos de registro.
- Exclua as exceções — Se um ou dois agentes não devem usar um prompt universal, exclua-o apenas nesses agentes com o Edit Loadout na Pré-visualização de Execução do Agente; o prompt continua universal para os demais.
- Duplique por agente quando o compartilhamento for parcial — Se apenas alguns agentes específicos precisam da instrução (e a maioria não deve tê-la), clone o prompt por agente e mantenha as cópias sincronizadas você mesmo.
Prefira o prompt universal sempre que a instrução for genuinamente da organização inteira: um único registro para editar, sem cópias para divergir.
Prompts exclusivos: um prompt, vários agentes, de propósito
Normalmente um prompt encontra seus agentes sozinho — pelo campo Definição de Agente, pelo Canal e pelos Objetos de contexto. Isso é o certo para a maioria dos prompts e o errado para um caso: um procedimento de que vários agentes específicos precisam e que nenhum outro deveria pegar.
Marque Prompt exclusivo no Prompt personalizado e as regras habituais deixam de se aplicar por completo. A partir daí ele fica invisível para todos os agentes até que um registro de Prompt exclusivo o atribua a um — e cada atribuição decide por conta própria como o prompt carrega. Deixe a caixa desmarcada e o prompt se comporta exatamente como sempre.
| Modo de carregamento | Quando o prompt é incluído |
|---|---|
| Sempre (padrão) | Em todo turno — e é a resposta para turnos que não têm nenhum contexto de registro. |
| No contexto | Apenas quando o turno acontece sobre um objeto correspondente e, se houver, um tipo de registro correspondente. |
| Sob demanda | Não é carregado. O prompt fica listado no catálogo consultável do agente, para que ele possa pedi-lo pelo nome quando a situação exigir — a opção mais econômica, já que o texto não custa nada até ser realmente necessário. |
“No contexto” precisa de algo com que corresponder. Salvar uma atribuição como No contexto quando o prompt não tem Objetos de contexto é bloqueado: “On Context needs the prompt to say which objects it applies to. Set Context Objects on the prompt (for example Account, or Account[Customer]), or change Load Mode to Always.”
Mais duas coisas sobre o registro de atribuição. Está ativo permite suspender uma atribuição sem excluí-la — uma atribuição inativa é ignorada por completo. E a atribuição é mestre-detalhe com o agente, mas apenas um lookup para o prompt, com exclusão restrita: remover um agente limpa as próprias atribuições, enquanto um prompt do qual outros agentes ainda dependem não pode ser excluído por baixo deles.
Padrão de organização: agente base + clones especializados
Uma boa prática é criar um agente "base" com um conjunto de prompts bem configurado e, depois, cloná-lo para casos de uso especializados:
-
Criar o agente base de vendas
Crie um agente com Display Name "Sales Agent - Base Template", com prompts padrão para tarefas de vendas.
-
Clonar para cada região
Clone o agente para criar "Sales Agent - North America", "Sales Agent - EMEA", "Sales Agent - APAC".
-
Personalizar cada clone
Para cada clone regional, personalize a Persona e os prompts com linguagem, regras ou foco específicos da região.
-
Implantar cada um de forma independente
Cada agente regional agora é independente e pode ser implantado em ambientes ou páginas diferentes do Salesforce.
Essa abordagem escala bem — você mantém uma arquitetura base consistente e ainda permite a personalização.
Prompts para toda a organização: deixe o agente em branco
A REDA AI tem suporte a prompts no nível da organização: um Prompt personalizado cujo campo Definição de Agente está em branco é universal e carrega automaticamente para todos os agentes — as diretivas de idioma integradas vêm exatamente assim. Prompts vinculados a um agente ficam isolados naquele agente; os universais são o caminho deliberado para regras da organização inteira.
Dois controles mantêm os prompts universais seguros: eles respeitam o escopo por Canal e Objetos de Contexto como qualquer outro prompt, e qualquer agente individual pode ser excluído de um deles com o Edit Loadout na Pré-visualização de Execução do Agente.
Tons diferentes para departamentos diferentes
Um caso de uso comum é ter tons diferentes para agentes que atendem departamentos distintos:
"Você é um assistente entusiasmado de Executivo de Contas de Vendas. Seu tom é animado, encorajador e ambicioso. Você ajuda os representantes de vendas a fechar negócios, avançar oportunidades e construir relacionamentos com clientes. Você comemora as vitórias e ajuda os representantes a manterem o foco no seu pipeline."
"Você é um especialista empático em Suporte ao Cliente. Seu tom é profissional, paciente e focado em soluções. Você ajuda os representantes de suporte a resolver problemas dos clientes rapidamente, reduzir a frustração e encantar os clientes. Você prioriza entender as necessidades do cliente antes de recomendar soluções."
"Você é um consultor profissional de Recursos Humanos. Seu tom é respeitoso, confidencial e atento às políticas da empresa. Você ajuda as equipes de RH a gerenciar solicitações de funcionários, garantir a conformidade com as políticas da empresa e manter a confidencialidade. Você sempre encaminha assuntos sensíveis ao diretor de RH."
O tom e a abordagem de cada agente são bem distintos, moldados pelos seus prompts.
Contexto específico de domínio e prompts de Schema
Agentes diferentes trabalham com objetos diferentes do Salesforce. Personalize os prompts de Schema para o domínio de cada agente:
"Objetos principais: Oportunidade (com StageName, Amount, ExpectedRevenue, CloseDate), Account (Industry, AnnualRevenue, NumberOfEmployees), Contact (Title, Department, Email, Phone). Relacionamentos: contas têm vários contatos e oportunidades; contatos pertencem a contas."
"Objetos principais: Caso (com Status, Priority, Origin, Category), Contact (Email, Phone, Account, SupportTier), Account (CurrentServiceLevel). Relacionamentos: casos pertencem a contatos e contas; os casos de suporte seguem fluxos de resolução."
Os prompts de Schema de cada agente descrevem apenas os objetos e campos relevantes para o trabalho daquele agente.
Guardrails: restrições específicas por departamento
Os prompts de Guardrail costumam variar por departamento:
"Não assuma compromissos sobre prazos de entrega sem verificar com a equipe de produto. Não discuta detalhes de recursos da concorrência. Sempre encaminhe objeções de preço para a gerência."
"Mantenha todas as informações pessoais dos funcionários confidenciais. Nunca discuta salário ou remuneração publicamente. Encaminhe questões disciplinares ao diretor de RH. Proteja a privacidade dos candidatos conforme os requisitos legais."
Cada departamento tem requisitos de conformidade e política diferentes, refletidos em seus guardrails.
Testar prompts específicos de agente
Ao testar prompts, certifique-se de estar testando o agente correto:
- Implante o agente específico cujos prompts você está testando
- Não presuma que um prompt no Agente A funcionará da mesma forma no Agente B
- Teste o comportamento específico de cada departamento com cenários realistas para aquele departamento
- Verifique se os guardrails específicos de cada departamento são eficazes
Configurar instruções reutilizáveis
Prompts exclusivos permitem atribuir instruções reutilizáveis a agentes selecionados. Revise Prompt exclusivo e Resumo no Prompt personalizado e Definição de agente, Prompt personalizado, Ativo e Modo de carregamento na atribuição. Sob demanda exige a ferramenta de prompts de contexto na configuração do agente. Escopos com tipos de registro entre colchetes usam regras compartilhadas, inclusive nas prévias. A ordenação de prompts e ferramentas é determinística e a prévia aceita um ID real de registro. Instruções de idioma seguem a mensagem em API/canais externos; marcadores de usuário só se aplicam nos contextos previstos. Preserve prompts próprios ao mesclar padrões atuais.
Perguntas frequentes
Sim: deixe o campo Definição de Agente do prompt em branco e ele se torna universal, carregando automaticamente para todos os agentes da org. Para compartilhar apenas com alguns agentes, clone o registro por agente (alterando a busca de Agente), ou torne-o universal e exclua-o com o Edit Loadout nos agentes que não devem usá-lo.
Você não consegue excluir o agente enquanto os prompts dele existirem: o Salesforce bloqueia a exclusão até que os Prompts personalizados relacionados (e os Campos de Contexto e Chips de Sugestão) sejam removidos primeiro. Desativar o agente é a prática recomendada: tudo fica intacto para reativação posterior.
Embora a REDA AI não tenha Personas compartilhadas no nível do banco de dados, você pode criar prompts de Persona quase idênticos em agentes diferentes. Use linguagem e tom consistentes para criar uma experiência unificada entre agentes relacionados.
Use convenções de nomenclatura no campo Prompt Name para indicar a qual agente ou departamento o prompt pertence. Por exemplo, "Vendas - Schema: campos de Oportunidade" ou "Suporte - Guardrail: privacidade do cliente". Isso facilita encontrar e gerenciar os prompts.
Próximos passos
Saiba mais sobre variáveis de contexto para personalizar prompts entre diferentes agentes, ou explore as boas práticas de prompts para otimizar o desempenho de cada agente.