Criar e embasar modelos de prompt

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:

• Descrever o que é embasamento.
  
• Usar o Criador de prompts para criar um modelo de prompt de email de vendas.
  
• Adicionar recursos a um modelo de prompt.
  
• Usar uma classe do Apex para oferecer dados a um modelo de prompt.
  

O porquê e o como

No módulo Criador de prompts: início rápido, Linda Rosenberg, uma administradora do Salesforce, buscou reduzir a carga manual da sua equipe de vendas com a automatização de tarefas por meio de modelos de prompt. Neste módulo, vamos nos aprofundar para ver por que e como ela fez isso.

Criar um modelo de prompt de email de vendas

Para criar um modelo de prompt de email de vendas no Criador de prompts, você precisa do complemento Einstein para vendas, Einstein para plataforma ou Einstein para serviço.

Linda precisa criar um modelo que sua equipe de vendas possa usar para gerar emails. Ela quer reduzir o tempo que a equipe gasta na criação de convites de eventos de produtos para clientes.

Para isso, Linda navega até o Prompt Builder na Configuração do Salesforce. Quando ela navega até o Prompt Builder, a primeira página que vê é a página Explore (Explorar) do Prompt Builder. Lá você encontra:

• Orientações que te ajudam a saber mais sobre os recursos do Criador de prompts.
  
• Acesso a instruções passo a passo e exemplos de modelo de prompt.
  
• Uma listagem de todos os modelos de prompt existentes com tipo, categoria e status.
  
• Funcionalidades para editar e excluir modelos de prompt existentes.
  

Na página Explore (Explorar), Linda também pode criar um modelo de prompt. Ela clica no botão New Prompt Template (Novo modelo de prompt).

Linda começa a preencher os campos na tela de configuração do tipo de modelo.

Quando você configura um modelo de prompt, é importante ter uma meta clara. Nesse caso, Linda precisa pensar sobre quem são os clientes da sua empresa e o que sua equipe de vendas quer que eles vejam no email.

Linda sabe que seu email pode ser enviado a qualquer contato da Cloud Kicks. Logo, Contato é o objeto de destinatário. Ela conclui a configuração do tipo de modelo selecionando:

1. Prompt Template Type (Tipo de modelo de prompt): Sales Email (Email de vendas)
   
2. Prompt Template Name (Nome do modelo de prompt): Invite Customer to Local Product Event (Convidar cliente para um evento de produto local)
3. API Name (Nome da API): Invite_Customer_to_Local_Product_Event
4. Template Description (Descrição do modelo): Email customer to invite to local product event. (Enviar email a clientes a fim de convidá-los para um evento de produto local.)
5. Recipient (Destinatário): Contact (Contato)
   
6. Related Object (Objeto relacionado): Account (Conta)
   

Embasar seu modelo

Você aprendeu que especificar os modelos torna-os mais eficazes. Outra maneira de falar "especificar" é dizer que o modelo está embasado.

Depois de Linda definir seu tipo de modelo, ela começa a fazer o rascunho e o embasamento do prompt no Workspace do modelo.

Linda inclui o nome do cliente, o nome do remetente, seus cargos e detalhes sobre o evento.

O prompt parece ótimo. No entanto, seu primeiro rascunho foi codificado com apenas um único destinatário e remetente. Isso não seria um problema se o prompt fosse usado apenas uma vez. Mas o conceito de um modelo de prompt é ele poder ser usado para todos os remetentes e destinatários. Ela precisa de uma maneira de colocar os dados de CRM da sua empresa no modelo e embasá-lo automaticamente.

Linda gosta de saber que pode usar campos de mesclagem, o Apex e o Flow como recursos para permitir que o Prompt Builder acesse dados do Salesforce com segurança.

Adicionar campos de mesclagem a um modelo de prompt

Linda revê seu prompt e procura áreas em que pode usar campos de mesclagem para transformar seu prompt codificado para uso único em reutilizável para todos os remetentes e destinatários.

Em Prompt Template Workspace (Workspace do modelo de prompt), Linda usa a lista de opções Resource (Recurso) para escolher o tipo de recurso a ser usado. Ela vê que existem várias opções de modelos de prompt de email de vendas. Current Organization (Organização atual), Sender (Remetente) e Recipient (Destinatário) estão disponíveis para uso no modelo de prompt.

Na lista de opções Resources (Recursos), Linda escolhe Sender (Remetente) e Recipient (Destinatário) e depois escolhe informações específicas, como cargo, nome, empresa e outros para embasar seu modelo de prompt. Ela salva o trabalho.

Neste módulo, você verá a sintaxe {!$Resource} nos modelos de prompt. Essa sintaxe especial ajuda você a copiar e a colar facilmente o texto deste módulo no Workspace de modelo de prompt. Ela faz com que todos os seus recursos fiquem onde e como você esperava no modelo.

Ao concluir, ela nota que há uma parte do seu prompt que precisa de um ajuste antes de poder mostrar a resposta correta: “Floating on Clouds: Toronto Kickoff” em 18 de setembro.

Na Cloud Kicks, "Floating on Clouds" é um evento nacional que recebe clientes locais sediados na cidade. Linda quer ter certeza de que o modelo de prompt de email de vendas é o mais personalizado possível e gera emails que convidam os clientes para eventos locais.

Linda sabe que usar apenas campos de mesclagem nessa parte não é suficiente. Ela precisa incorporar lógica ao modelo de prompt. Existem várias formas de se conseguir isso no Prompt Builder, incluindo com o uso do Apex ou de fluxos de prompt acionados pelo modelo. Primeiro, vamos explorar como usar o Apex em modelos de prompt.

Adicionar Apex a um modelo de prompt

Se você quer usar dados de uma consulta SOQL ou de uma API externa no prompt, pense em usar o Apex. O Apex também é eficaz quando você quer gerar JSON bem formatado ou fazer filtragem de dados programática.

Nesse caso, Linda quer criar uma classe do Apex que encontre eventos próximos de determinado contato e retorne o nome, assunto, local e hora de início dos eventos. Usando o Developer Console, ela cria uma classe chamada ContactEventsPrompt com um método anotado como InvocableMethod. O InvocableMethod precisa aceitar List<Request> (Solicitação de lista) onde as entradas definidas na classe Request (Solicitação) correspondem às entradas no prompt. Além disso, o InvocableMethod precisa receber o rótulo CapabilityType que corresponde ao tipo de modelo.

Se você está interessado em saber mais sobre como adicionar classes do Apex a modelos de prompt ou para ver exemplos de código, confira a Documentação do Salesforce.

Depois que sua classe é criada, Linda volta ao Workspace de modelo de prompt no Prompt Builder e nota que o Apex agora aparece como recurso. Ela adiciona a classe do Apex clicando em Resource (Recurso) e selecionando Apex.

Ótimo! Agora, em vez de referenciar um único evento, Linda pode usar sua classe do Apex para retornar um evento próximo do contato especificado.

Recursos

• Documentação do Salesforce: Fundamentar com campos de mesclagem do Apex
  
• Documentação do Salesforce: Configurar emails de vendas
  
• Trailhead: Noções básicas de prompt