Você está aqui:
Usar variáveis de contexto em conversas de mensagens
Personalize as conversas do agente em canais de mensagens com variáveis de contexto. As variáveis de contexto permitem que seu agente use campos de registro de Sessão do Messaging como entradas de ação.
Edições obrigatórias
| Disponível em: Lightning Experience |
| Disponível em: Edições Enterprise, Performance, Unlimited e Developer. As licenças complementares necessárias variam de acordo com o tipo de agente. |
Para aprender sobre o suporte de canal para outros tipos de agente, consulte a documentação para esse tipo. |
| Permissões de usuário necessárias | |
|---|---|
| Para criar e gerenciar agentes de serviço: | Gerenciar agentes de serviço do Agentforce E Gerenciar agentes de IA OU Personalizar aplicativo |
| Para criar e gerenciar agentes de funcionários: | Gerenciar agentes de IA e Gerenciar agentes de funcionários do Agentforce OU Personalizar aplicativo |
Antes de começar, conecte seu agente a um canal de mensagens.
As variáveis de contexto permitem mapear campos de objeto de Sessão do Messaging para canais de mensagens. Por exemplo, para evitar que seu agente precise pedir informações comuns de modo conversacional, você pode configurar seu agente para fazer referência a qualquer campo de objeto Sessão do Messaging, incluindo aqueles preenchidos por meio de um formulário pré-chat. Esses dados podem até ser usados como entrada para ações. Não recomendamos usar variáveis de contexto para autenticação.
Antes de atualizar variáveis de contexto, desative seu agente.
-
Escolha campos de variável.
- Na página Configuração de agentes do Agentforce, clique no nome do agente para abrir a página Detalhes.
- Clique em Abrir no Builder e selecione a guia Contexto.
- Na seção Variáveis de sessão, selecione uma variável.
-
Para adicionar campos de variável ao seu agente, clique em Atualizar campos incluídos. Selecione os campos que deseja que o agente use e salve suas alterações.
Por padrão, os agentes incluem uma variável de Sessão do Messaging mapeada para um registro de MessagingSession. Os agentes podem usar as informações armazenadas no ID da sessão do Messaging, no ID do usuário do Messaging e em outros campos incluídos. Eles também podem atualizar automaticamente o registro de Sessão do Messaging conforme conversam com os clientes.
Você pode criar campos de variável de contexto personalizados que aparecem na variável de contexto de Sessão do Messaging do seu agente. Para criar campos de variável personalizados, adicione campos personalizados ao objeto Sessão do Messaging.
-
Adicione valores de campo ao registro de Sessão do Messaging usando um formulário pré-chat, seu fluxo do Omni-Channel de entrada ou a API pré-chat.
- Para usar o formulário Pré-chat, criar e personalizar um formulário pré-chat do Chat aprimorado. Você pode adicionar campos padrão e personalizados ao formulário pré-chat. Em seguida, mapeie os valores pré-chat para o seu canal de mensagens e atualize o fluxo do Omni-Channel de entrada.
- Para usar seu fluxo do Omni-Channel de entrada, personalize seu fluxo do Omni-Channel de entrada para que ele passe informações de sessões de mensagens anteriores para seu agente. Consulte Entradas pré-chat persistentes em sessões do Messaging.
- Para usar a API pré-chat, envie dados do usuário que não estejam visíveis no formulário pré-chat, conhecidos como campos pré-chat ocultos, para seu agente. Consulte API de pré-chat oculto Web Chat aprimorado, API de pré-chat oculto iOS e API de pré-chat oculto Android.
- Para usar um campo de variável de contexto durante as conversas do agente, adicione o nome da API do campo às instruções e use os campos em entradas de ação.
Não é possível testar casos de uso de variável de contexto no Agentforce Builder porque usar variáveis requer um registro de Sessão do Messaging. Para testar variáveis de contexto, crie uma sessão de mensagens como uma experiência de canal.
