Criando e Editando Prompts
Como criar um novo prompt
-
Abra a Definição de Agente
No app REDA AI, navegue até Gestão de agentes e clique na Definição de Agente à qual deseja adicionar um prompt.
-
Role até as listas relacionadas
Encontre a lista relacionada "Prompts personalizados" no registro da Definição de Agente.
-
Clique em Novo Prompt personalizado
Clique no botão "Novo" na lista relacionada Prompts personalizados para criar um novo prompt.
-
Selecione o Tipo de Prompt
Escolha o Tipo de Prompt no menu suspenso: Persona_Override, Custom_Instructions, Schema, Action ou Guardrail. (Obrigatório)
-
Escreva o conteúdo do prompt
Digite o texto real do prompt no campo Content. Seja claro e específico sobre o que deseja que a IA faça. (Obrigatório)
-
Defina a Ordem de classificação (Opcional)
Digite um número no campo Sort Order (padrão do pacote: 100). Isso controla a posição do prompt na sequência montada — entre todos os tipos de prompt, não apenas o seu. Números menores vêm primeiro.
-
Decida se ele começa ativo
Prompts novos ficam ativos por padrão — a caixa Is Active vem marcada e o prompt entra em vigor na próxima conversa do agente assim que você salvar. Desmarque-a se preferir criar o prompt desativado e habilitá-lo mais tarde.
-
Salve o prompt
Clique em Salvar. O prompt agora está vinculado ao seu agente e será usado se Is Active estiver marcado.
Campos de configuração do prompt
| Campo | Tipo | Obrigatório? | Observações |
|---|---|---|---|
| Prompt Name | Texto | Não | Não é enviado à IA, mas identifica o prompt na lista de exclusões do Edit Loadout na Pré-visualização de Execução — dê a cada prompt um nome distintivo. Exemplo: "Sales Tone Override". |
| Tipo de prompt | Lista de seleção | Sim | Um dos seguintes: Persona_Override, Custom_Instructions, Schema, Action, Guardrail. |
| Conteúdo | Área de texto longo | Não — mas um prompt sem ele não faz nada | O texto real do prompt enviado à IA. Seja claro e específico. Pode incluir variáveis de contexto como {USER_NAME}. |
| Is Active | Caixa de seleção | Não | Marcada por padrão — um prompt recém-criado fica ativo imediatamente. Desmarque para criá-lo desativado; você pode desativar e reativar a qualquer momento sem excluir. |
| Ordem de classificação | Número | Sim | Padrão do pacote: 100. Controla a posição do prompt entre todos os tipos de prompt. Números menores primeiro. Use valores espaçados (10, 20, 30) para reordenar com facilidade. |
| Canal | Lista de seleção múltipla | Não | Em quais canais o prompt carrega (Interno, Widget Externo, Comunidade, API). |
| Objetos de Contexto | Texto | Não | Nomes de API de objetos, opcional. Quando definido, o prompt só carrega em conversas no contexto de um desses objetos. |
| Estimativa de complexidade | Número | Não | Tamanho estimado em tokens aplicado contra o Prompt Complexity Budget do agente durante a montagem. Em branco conta como 200. |
| Resumo | Texto | Em prompts exclusivos | Uma linha dizendo o que o prompt cobre. Ela tem dois leitores: o administrador que escolhe prompts para atribuir a um agente e — numa atribuição Sob demanda — o próprio agente, decidindo se busca o prompt. Escreva para que serve o procedimento, não como ele funciona. |
| Prompt exclusivo | Caixa de seleção | Não | Desmarcada por padrão. Marque-a e o prompt deixa de ser correspondido por agente, canal e contexto; a partir daí ele só chega a um agente por meio de uma atribuição de Prompt exclusivo. |
Editando um prompt existente
- Abra a Definição de Agente — Vá até a Definição de Agente que contém o prompt.
- Encontre o prompt na lista relacionada — Localize o prompt na lista relacionada Prompts personalizados.
- Clique no nome do prompt — Clique no nome do prompt para abrir seu registro.
- Edite os campos — Modifique o Content, o Prompt Type, o Sort Order ou o Is Active conforme necessário.
- Salve as alterações — Clique em Salvar. As alterações entram em vigor imediatamente para novas interações com a IA.
- Teste o agente — Abra o chat do agente e verifique se as alterações tiveram o efeito desejado.
Clonando prompts entre agentes
Se você quiser usar prompts semelhantes em vários agentes, pode clonar um prompt:
- Abra o registro do Prompt personalizado que deseja clonar.
- Clique no botão "Clone" do Salesforce (ou selecione Clone no menu suspenso).
- Altere o campo Agent para o agente de destino.
- Clique em Salvar para criar o prompt clonado no agente de destino.
Alternativamente, você pode copiar o texto do Content, criar um novo prompt no agente de destino e colar o conteúdo. Isso gera um prompt novo, sem histórico vinculado.
Testando alterações no prompt
Depois de criar ou editar um prompt, teste-o sempre:
- Ative o prompt (se ainda não estiver ativo) — Certifique-se de que Is Active esteja marcado.
- Abra o Chat do agente — Implante o agente em um sandbox ou use o recurso de pré-visualização.
- Envie mensagens de teste — Envie mensagens que devem acionar o comportamento do prompt.
- Observe os resultados — O agente segue as instruções do prompt? As respostas estão formatadas corretamente?
- Itere — Se o comportamento não for o esperado, edite o prompt e teste novamente.
- Implante quando estiver pronto — Depois de satisfeito, implante o agente em produção.
Desativando e reativando prompts
Em vez de excluir um prompt, desative-o:
- Abra o registro do Prompt personalizado
- Desmarque a caixa de seleção Is Active
- Clique em Salvar
O prompt agora está desativado e não será enviado à IA, mas o registro permanece no seu banco de dados. Você pode reativá-lo a qualquer momento marcando a caixa novamente. Isso é útil para:
- Teste A/B — Teste duas versões de um prompt desativando uma, testando a outra e depois alternando.
- Comportamento sazonal — Desative os prompts fora da temporada relevante e reative-os quando necessário.
- Alterações experimentais — Crie um novo prompt, desative o antigo, teste e depois confirme ou reverta.
Boas práticas para criar prompts
Cada prompt deve ter UM propósito claro. Não combine vários comportamentos em um único prompt. É melhor ter 3 prompts focados do que 1 mega-prompt.
Seja específico, não vago — Em vez de "Seja prestativo", diga "Se o usuário perguntar sobre preços, responda com um link para a página de preços e ofereça-se para agendar uma demonstração."
Nomeie seus prompts com clareza — Use nomes descritivos como "Response Format - Bullet Points" ou "Guardrail - No Personal Data" para que os administradores possam encontrá-los e gerenciá-los facilmente.
Use a Ordem de classificação estrategicamente — Se determinadas instruções devem ter prioridade, atribua a elas números de Sort Order menores para que sejam montadas primeiro.
Evite redundância — Não repita a mesma instrução em vários prompts. Consolide em um único prompt e faça referência a ele em comentários, se necessário.
Inclua variáveis de contexto — Use {USER_FIRST_NAME}, {TODAY_DATE}, etc. para personalização. Isso torna as interações mais personalizadas.
Tipos de prompt comuns e exemplos
| Tipo de prompt | Caso de uso | Trecho de conteúdo de exemplo |
|---|---|---|
| Schema | Descrever objetos e campos do Salesforce | "Opportunity.StageName has values: Prospecting, Qualification, Decision Makers, Closed Won, Closed Lost" |
| Custom Instructions | Regras de comportamento | "Always format lists with bullet points. Keep responses under 150 words. Use friendly tone." |
| Ação | Como realizar ações específicas | "When creating a task, set the priority to 'High' for urgent items. Use the subject format: 'Follow-up: [customer name]'" |
| Guardrail | Restrições e regras de segurança | "Never discuss employee salary information. If asked, respond: 'That's a question for HR. I can help with other topics.'" |
Solução de problemas com prompts
Verifique se Is Active está marcado. Se estiver ativo, confirme se o Agent correto está definido no prompt. Limpe o cache do seu navegador e atualize o widget de chat.
O agente está ignorando o prompt — A IA pode ignorar instruções se elas entrarem em conflito com a persona ou com outros prompts. Use prompts do tipo Guardrail para regras rígidas. Evite linguagem vaga — seja explícito sobre o que você quer.
Uso excessivo de tokens — Prompts longos consomem tokens. Considere dividir prompts grandes em vários prompts focados e use prompts do tipo Schema em vez de consultar ferramentas.
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. As alterações nos prompts entram em vigor imediatamente. As novas conversas usarão o prompt atualizado. As conversas existentes continuam com a versão com a qual começaram (a menos que a sessão seja reiniciada). Teste as alterações com cuidado para evitar interromper agentes ativos.
O campo Persona na Definição de Agente é o prompt de sistema base. Os Prompts personalizados do tipo Persona_Override o refinam ou substituem. Use o campo Persona para a identidade principal e os prompts Persona_Override para ajustes.
Sim, a IA entende markdown. Você pode usar *, -, # para listas e formatação nos prompts. A IA interpretará e seguirá as convenções de markdown.
Cada prompt consome tokens. Mantenha os prompts individuais com menos de 10.000 caracteres. Se seus prompts estiverem ficando muito longos, divida-os em vários prompts focados e use a Ordem de classificação para controlar a ordem de montagem.
Próximos passos
Conheça as boas práticas de prompt para otimizar seus prompts, ou explore as variáveis de contexto para personalização.