Compartilhar via

Entrega para o bot do Salesforce Einstein

Este documento fornece instruções passo a passo sobre como criar e conectar um Einstein bot a um Copilot Studio agente. Essa integração permite que você use os recursos de ambas as plataformas para aprimorar sua experiência agente.

Pré-requisitos

Antes de começar, verifique se você atendeu aos seguintes pré-requisitos no local:

  • Uma conta ativa do Salesforce com Bots do Einstein habilitados.
  • Uma conta do Copilot Studio.
  • Acesso de administrador ou desenvolvedor ao Salesforce e ao Microsoft Power Platform.

Etapa 1: Recupere Direct Line segredo para seu agente

  1. Recupere seu Direct LinesSecret.

Etapa 2: definir as configurações do site remoto do Salesforce

  1. Entre com sua conta do Salesforce.

  2. No Salesforce, navegue até Configuração.

  3. Na caixa Localização Rápida, digite Configurações do Site Remoto e selecione Configurações do Site Remoto.

  4. Adicione um novo site remoto e preencha Nome do Site Remoto como Copilot Studio e URL do Site Remoto como https://directline.botframework.com

  5. Selecione Salvar.

Observação

Para outras regiões, use a URL apropriada para a URL da DirectLine API

Etapa 3: criar Classes do Apex para conectar-se à DirectLine API

  1. Entre com sua conta do Salesforce.

  2. No Salesforce, navegue até Configuração.

  3. Na caixa Localização Rápida, digite Classes do Apex.

  4. Crie três novas classes com os detalhes a seguir:

DL_GetConversation

  • Entradas: Nenhuma
  • Saídas: conversationId (Cadeia de caracteres), responseCode (Inteiro), errorMessage (Cadeia de caracteres)
  • InvocableMethod getConversationID: use seu Segredo do DirectLine para fazer uma chamada HTTP para o ponto de extremidade do DirectLine que está iniciando uma conversa.

DL_PostActivity

  • Entradas: conversationId (Cadeia de caracteres), userMessage (Cadeia de caracteres)
  • Saídas: responseCode (Inteiro), errorMessage (Cadeia de caracteres), watermark (Cadeia de caracteres)
  • InvocableMethod postActivity: execute uma chamada HTTP para a DirectLine API de pós-atividade usando o conversationId na URL e userMessage.

DL_GetActivity

  • Entradas: conversationId (Cadeia de caracteres), watermark (Cadeia de caracteres)
  • Saídas: message (Cadeia de caracteres), watermark (Cadeia de caracteres), responseCode (Inteiro), errorMessage (Cadeia de caracteres)
  • InvocableMethod getActivity: execute uma chamada HTTP para a getActivity DirectLine API usando conversationId e watermark para recuperar e analisar o objeto de atividade para a mensagem ser enviada de volta ao usuário.

Etapa 4: configurar o bot do Einstein

  1. Entre com sua conta do Salesforce.

  2. No Salesforce, navegue até Configuração.

  3. Na caixa Localização Rápida , digite Einstein e Select Einstein Bots.

  4. Crie um novo bot do Einstein seguindo as etapas da documentação do Salesforce Einstein.

Etapa 5: conectar o Bot do Einstein ao PVA com classes Apex

No bot do Einstein, para que o bot entre em contato com cada enunciado fora dos tópicos do Einstein, você pode adicionar referências às classes do Apex criadas anteriormente:

  1. Na tópico Bem-vindo, adicione uma ação de classe do Apex referenciando a classe DL_GetConversation e atribua as variáveis de resposta adequadamente.

  2. No tópico Confuso, adicione uma ação de classe do Apex mencionando a classe DL_PostActivity, informando o conversationId e a última entrada do usuário. Certifique-se de definir as variáveis de resposta para outras variáveis.

  3. Crie uma condição para verificar o Código de Resposta da ação DL_PostActivity do Apex, se o código for 200 ou 204 você pode continuar, caso contrário exibirá a Mensagem de Erro.

  4. Adicione outra ação de classe do Apex ao DL_GetActivity, definindo o conversationId de GetConversation e o watermark de PostActivity e atribuindo as variáveis de resposta.

Observação

Você pode querer criar GetActivity como um tópico separado. Talvez seja necessário fazer um loop no DL_GetActivity para obter a resposta real, se demorar mais para ser buscada.

  1. Crie uma condição para verificar o código de resposta e se a mensagem de retorno está definida; em caso afirmativo, vá para um nó de mensagem para gerar a resposta.

  2. A última etapa do fluxo deve permanecer como “Aguardar a Entrada do Cliente”.

Etapa 6: Lidar com a Entrega do Agente

Ao acessar um agente do Einstein, o agente é usado apenas em um modelo de solicitação/resposta: com base na consulta do usuário, um agente busca o KB mais apropriado e resume a resposta.

Como você pode continuar a configurar seus bot do Einstein, você pode implementar quaisquer outros gatilhos tópico ou gatilhos de escalonamento no Einstein. Essa configuração extra permite que seus usuários escalonem para as filas de agente humano do Salesforce apropriadas.

Para obter mais informações, consulte a documentação do Salesforce Rotear Conversas de um Bot Avançado.