Compartilhar via

Conector do Microsoft Graph de Conhecimento do Salesforce

  • Artigo

O conector do Salesforce Knowledge Graph permite que a sua organização indexe artigos do Salesforce Knowledge. Depois de configurar o conector, os utilizadores finais podem procurar Artigos de conhecimento do Salesforce no Microsoft Copilot e em qualquer cliente do Microsoft Search.

Esta documentação destina-se a administradores do Microsoft 365 ou a qualquer pessoa que configure, execute e monitorize um conector do Salesforce Knowledge Graph.

Observação

O conector do Gráfico de Conhecimento do Salesforce está em pré-visualização. Se quiser ter acesso antecipado para experimentar, inscreva-se com este formulário.

Recursos

  • Artigos de Conhecimento do Salesforce de Índice.
  • Permitir que os utilizadores da empresa façam perguntas em linguagem natural com o Copilot e recebam respostas com base em artigos no Salesforce. Exemplos:
    • Quais são os passos para processar um reembolso?
    • Qual é o procedimento de escalamento para casos de alta prioridade?
    • Quais são as atualizações mais recentes da nossa política de garantia do produto?
  • Utilize a Pesquisa Semântica no Copilot para permitir que os utilizadores encontrem conteúdos relevantes com base em palavras-chave, preferências pessoais e ligações sociais.

Limitações

  • O conector não suporta ACLs (listas de controlo de acesso). Todos os dados indexados através do conector de Conhecimento do Salesforce estão visíveis para todos os utilizadores do Microsoft 365 no seu inquilino, acessíveis através do Microsoft Search ou copilot.

Pré-requisitos

Para ligar à instância do Salesforce, precisa do URL da instância do Salesforce, do ID de cliente e do segredo do cliente para a autenticação OAuth 2.0. Os passos seguintes explicam como o utilizador ou o administrador do Salesforce podem obter estas informações a partir da sua conta do Salesforce:

  • Inicie sessão na instância do Salesforce e aceda a Configuração

  • Navegue para Aplicações -> Gestor de Aplicações.

  • Selecione Nova aplicação ligada.

  • Conclua a secção API da seguinte forma:

    • Selecione a caixa de verificação Ativar definições de Oauth.
    • Especifique o URL de Chamada de Retorno como: Para M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback, para M365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback
    • Selecione estes âmbitos OAuth necessários.
      • Aceda e faça a gestão dos seus dados (API).
      • Efetue pedidos em seu nome em qualquer altura (refresh_token, offline_access).
    • Selecione a caixa de verificação Exigir segredo para o fluxo do servidor Web.
    • Guarde a aplicação.

      Captura de ecrã que mostra a secção API na instância do Salesforce depois de o administrador ter introduzido todas as configurações necessárias listadas acima.

  • Copie a chave de consumidor e o segredo do consumidor. Estas informações são utilizadas como o ID de cliente e o segredo do cliente quando configura as definições de ligação para o conector Do Microsoft Graph de Conhecimento do Salesforce no portal de administração do Microsoft 365.

    Captura de ecrã que mostra os resultados devolvidos pela secção API na instância do Salesforce depois de o administrador ter submetido todas as configurações necessárias. A Chave de Consumidor está na parte superior da coluna esquerda e o Segredo do Consumidor está na parte superior da coluna direita.

  • Antes de fechar a instância do Salesforce, siga estes passos para garantir que os tokens de atualização não expiram:

    • Aceda a Aplicações –> Gestor de Aplicações.
    • Localize a aplicação que criou e selecione o menu pendente à direita. Selecione Gerenciar.
    • Selecione editar políticas.
    • Para a política de token de atualização, selecione O token de atualização é válido até ser revogado.

    Captura de ecrã que mostra a opção Atualizar Política de Token com o nome

Agora, pode utilizar o Centro de Administração Microsoft 365 para concluir o resto do processo de configuração do conector do Salesforce Knowledge Graph.

Introdução

1. Nome a apresentar

Um nome a apresentar é utilizado para identificar cada citação em Copilot, ajudando os utilizadores a reconhecer facilmente o ficheiro ou item associado. O nome a apresentar também significa conteúdo fidedigno. O nome a apresentar também é utilizado como um filtro de origem de conteúdo. Está presente um valor predefinido para este campo, mas pode personalizá-lo para um nome que os utilizadores na sua organização reconhecem.

2. URL de Conhecimento do Salesforce

Utilize o URL da Instância de Conhecimento do Salesforce da sua organização. Este URL é o endereço Web específico utilizado para aceder e interagir com os serviços de API do Salesforce Knowledge para obtenção de dados, que normalmente se assemelha a https://[COMPANY_NAME].my.salesforce.com

3. Tipo de Autenticação

Para o conector de gráficos de conhecimento do Salesforce, utilize o OAuth 2.0 para autenticação.

Para autenticar, introduza o ID de Cliente e o Segredo do Cliente. O ID de Cliente é um identificador exclusivo atribuído à sua aplicação para fazer pedidos à API de Conhecimento do Salesforce. O Segredo do Cliente é uma chave confidencial utilizada juntamente com o ID de Cliente para autenticar de forma segura a sua aplicação com a API de Conhecimento do Salesforce.

4. Implementar para público-alvo limitado

Implemente esta ligação numa base de utilizadores limitada se pretender validá-la no Copilot e noutras superfícies de Pesquisa antes de expandir a implementação para uma audiência mais ampla. Para saber mais sobre a implementação limitada, veja Implementação faseada.

Neste momento, está pronto para criar a ligação para o Salesforce Knowledge. Pode clicar no botão "Criar" para publicar as suas publicações de ligação e índice a partir da sua conta de Conhecimento do Salesforce.

Configuração Personalizada

A configuração personalizada destina-se a administradores que pretendam editar os valores predefinidos das definições. Depois de clicar na opção "Configuração Personalizada", verá outros três separadores: Utilizadores, Conteúdo e Sincronização.

Usuários

Atualmente, os artigos da instância de Conhecimento do Salesforce da sua organização estão indexados. Todos os dados indexados através do conector de Conhecimento do Salesforce estão visíveis para todos os utilizadores do Microsoft 365 no seu inquilino, acessíveis através do Microsoft Search ou copilot.

Conteúdo

Gerir propriedades

Aqui, pode adicionar ou remover propriedades disponíveis da sua origem de dados de Conhecimento do Salesforce, atribuir um esquema à propriedade (definir se uma propriedade é pesquisável, queryable, recuperável ou refinável), alterar a etiqueta semântica e adicionar um alias à propriedade. As propriedades selecionadas por predefinição estão listadas abaixo:

Propriedade Source Etiqueta Semântica Descrição Esquema
ID do Artigo Consultar, Obter
Número de Artigo O número exclusivo atribuído automaticamente ao artigo quando é criado. Consultar, Obter
Tipo de Artigo O tipo ou categoria do artigo de conhecimento (por exemplo, FAQ, Artigo de Suporte, Procedimentos). Obter
CondensedBody Inclui o conteúdo completo ou main corpo do artigo Obter, Procurar
CreatedById Consultar, Obter, Procurar
CreatedByName createdBy O utilizador que criou inicialmente o artigo. Consultar, Obter, Procurar
CreatedDate createdDateTime Carimbo de data/hora de quando o artigo foi criado inicialmente. Consultar, Obter
IconUrl iconUrl Obter
Idioma O idioma no qual o artigo é escrito. Obter
LastModifiedById Consultar, Obter, Procurar
LastModifiedByName lastModifiedBy O utilizador que atualizou o artigo pela última vez. Consultar, Obter, Procurar
LastModifiedDate lastModifiedDateTime Carimbo de data/hora da atualização mais recente do artigo. Consultar, Obter
LastPublishedDate A data em que o artigo foi publicado pela última vez. Consultar, Obter
LastPublishedVersionId Consultar, Obter
Resumo Uma breve descrição geral ou resumo do conteúdo do artigo. Pesquisar
Título title A main título ou título do artigo. Consultar, Obter, Procurar
Url url Ligação para o artigo em Conhecimentos do Salesforce. Obter
UrlName Um nome exclusivo amigável para URL gerado para o artigo. Consultar, Obter

Sincronização

O intervalo de atualização determina a frequência com que os dados são sincronizados entre a origem de dados e o índice do conector do Graph. Existem dois tipos de intervalos de atualização: pesquisa completa e pesquisa incremental. Para obter mais informações, veja Definições de atualização.

Solução de problemas

Depois de publicar a ligação, pode rever a status no separador Origens de Dados no centro de administração. Para saber como fazer atualizações e eliminações, consulte Gerir o conector.

Se tiver problemas ou quiser fornecer comentários, contacte o Microsoft Graph | Suporte.