Connettore Microsoft Graph salesforce Knowledge
Il connettore Salesforce Knowledge Graph consente all'organizzazione di indicizzare gli articoli di Salesforce Knowledge. Dopo aver configurato il connettore, gli utenti finali possono cercare articoli della Knowledge Base da Salesforce in Microsoft Copilot e da qualsiasi client di Microsoft Search.
Questa documentazione è destinata agli amministratori di Microsoft 365 o a tutti gli utenti che configurano, eseguono e monitorano un connettore Salesforce Knowledge Graph.
Nota
Il connettore Salesforce Knowledge Graph è disponibile in anteprima. Se si vuole ottenere l'accesso anticipato per provarlo, iscriversi usando questo modulo.
Funzionalità
- Articoli della Knowledge Base di Index Salesforce.
- Consentire agli utenti all'interno dell'azienda di porre domande in linguaggio naturale usando Copilot e ricevere risposte basate su articoli in Salesforce. Esempi:
- Quali sono i passaggi per l'elaborazione di un rimborso?
- Qual è la procedura di escalation per i casi con priorità elevata?
- Quali sono gli aggiornamenti più recenti ai criteri di garanzia dei prodotti?
- Usare la ricerca semantica in Copilot per consentire agli utenti di trovare contenuti pertinenti in base a parole chiave, preferenze personali e connessioni di social networking.
Limitazioni
- Il connettore non supporta gli elenchi di controllo di accesso (elenchi di controllo di accesso). Tutti i dati indicizzati tramite il connettore Salesforce Knowledge sono visibili a tutti gli utenti di Microsoft 365 nel tenant, accessibili tramite Microsoft Search o Copilot.
Prerequisiti
Per connettersi all'istanza di Salesforce, sono necessari l'URL dell'istanza di Salesforce, l'ID client e il segreto client per l'autenticazione OAuth 2.0. I passaggi seguenti illustrano come l'utente o l'amministratore di Salesforce può ottenere queste informazioni dall'account Salesforce:
Accedere all'istanza di Salesforce e passare al programma di installazione
Passare ad App -> Gestione app.
Selezionare Nuova app connessa.
Completare la sezione API come indicato di seguito:
- Selezionare la casella di controllo Abilita impostazioni Oauth.
- Specificare l'URL di callback come: Per M365 Enterprise:
https://gcs.office.com/v1.0/admin/oauth/callback, per M365 Government:https://gcsgcc.office.com/v1.0/admin/oauth/callback - Selezionare questi ambiti OAuth necessari.
- Accedere ai dati (API) e gestirli.
- Eseguire richieste per conto dell'utente in qualsiasi momento (refresh_token, offline_access).
- Selezionare la casella di controllo Richiedi segreto per il flusso del server Web.
- Salvare l'app.
Copiare la chiave consumer e il segreto del consumer. Queste informazioni vengono usate come ID client e segreto client quando si configurano le impostazioni di connessione per il connettore Salesforce Knowledge Microsoft Graph nel portale di amministrazione di Microsoft 365.
Prima di chiudere l'istanza di Salesforce, seguire questa procedura per assicurarsi che i token di aggiornamento non scadano:
- Passare ad App -> Gestione app.
- Trovare l'app creata e selezionare l'elenco a discesa a destra. Selezionare Gestisci.
- Selezionare Modifica criteri.
- Per i criteri del token di aggiornamento, selezionare Aggiorna token valido fino a quando non viene revocato.
È ora possibile usare Amministrazione Microsoft 365 Center per completare il resto del processo di installazione per il connettore Salesforce Knowledge Graph.
Introduzione
1. Nome visualizzato
Un nome visualizzato viene usato per identificare ogni citazione in Copilot, consentendo agli utenti di riconoscere facilmente il file o l'elemento associato. Il nome visualizzato indica anche contenuto attendibile. Il nome visualizzato viene usato anche come filtro dell'origine di contenuto. Per questo campo è presente un valore predefinito, ma è possibile personalizzarlo in base a un nome riconosciuto agli utenti dell'organizzazione.
2. URL della knowledge base di Salesforce
Usare l'URL dell'istanza di Knowledge Base salesforce dell'organizzazione. Questo URL è l'indirizzo Web specifico usato per accedere e interagire con i servizi API di Salesforce Knowledge per il recupero dei dati, che in genere è simile a https://[COMPANY_NAME].my.salesforce.com
3. Tipo di autenticazione
Per Il connettore Salesforce Knowledge Graph usare OAuth 2.0 per l'autenticazione.
Per eseguire l'autenticazione, immettere l'ID client e il segreto client. L'ID client è un identificatore univoco assegnato all'applicazione per effettuare richieste all'API Knowledge Base di Salesforce. Il segreto client è una chiave riservata usata insieme all'ID client per autenticare in modo sicuro l'applicazione con l'API Knowledge Base di Salesforce.
4. Distribuire a un pubblico limitato
Distribuire questa connessione in una base di utenti limitata se si vuole convalidarla in Copilot e in altre aree di ricerca prima di espandere l'implementazione a un pubblico più ampio. Per altre informazioni sull'implementazione limitata, vedere Implementazione a fasi.
A questo punto, si è pronti per creare la connessione per Salesforce Knowledge. È possibile fare clic sul pulsante "Crea" per pubblicare i post di connessione e indice dall'account Salesforce Knowledge.
Installazione personalizzata
La configurazione personalizzata è destinata agli amministratori che vogliono modificare i valori predefiniti per le impostazioni. Dopo aver fatto clic sull'opzione "Configurazione personalizzata", vengono visualizzate altre tre schede: Utenti, Contenuto e Sincronizzazione.
Utenti
Attualmente, gli articoli dell'istanza di Salesforce Knowledge dell'organizzazione sono indicizzati. Tutti i dati indicizzati tramite il connettore Salesforce Knowledge sono visibili a tutti gli utenti di Microsoft 365 nel tenant, accessibili tramite Microsoft Search o Copilot.
Contenuto
Gestire le proprietà
In questo caso, è possibile aggiungere o rimuovere le proprietà disponibili dall'origine dati Salesforce Knowledge, assegnare uno schema alla proprietà (definire se una proprietà è ricercabile, ricercabile, recuperabile o perfezionabile), modificare l'etichetta semantica e aggiungere un alias alla proprietà. Le proprietà selezionate per impostazione predefinita sono elencate di seguito:
| Proprietà Source | Etichetta semantica | Descrizione | Schema |
|---|---|---|---|
| ArticleId | Query, Retrieve | ||
| ArticleNumber | Numero univoco assegnato automaticamente all'articolo al momento della creazione. | Query, Retrieve | |
| ArticleType | Tipo o categoria dell'articolo della Knowledge Base( ad esempio, domande frequenti, articolo di supporto, procedura). | Recuperare | |
| CondensedBody | Include il contenuto completo o il corpo principale dell'articolo | Recupera, Cerca | |
| CreatedById | Query, Recupero, Ricerca | ||
| CreatedByName | createdBy | L'utente che inizialmente ha creato l'articolo. | Query, Recupero, Ricerca |
| CreatedDate | createdDateTime | Timestamp di quando l'articolo è stato creato inizialmente. | Query, Retrieve |
| IconUrl | iconUrl | Recuperare | |
| Lingua | Lingua in cui viene scritto l'articolo. | Recuperare | |
| LastModifiedById | Query, Recupero, Ricerca | ||
| LastModifiedByName | lastModifiedBy | L'ultimo utente che ha aggiornato l'articolo. | Query, Recupero, Ricerca |
| LastModifiedDate | lastModifiedDateTime | Timestamp dell'aggiornamento più recente all'articolo. | Query, Retrieve |
| LastPublishedDate | Data dell'ultima pubblicazione dell'articolo. | Query, Retrieve | |
| LastPublishedVersionId | Query, Retrieve | ||
| Riepilogo | Breve panoramica o astrazione del contenuto dell'articolo. | Ricerca | |
| Titolo | title | Titolo principale o titolo dell'articolo. | Query, Recupero, Ricerca |
| Url | URL | Collegamento all'articolo in Salesforce Knowledge. | Recuperare |
| UrlName | Nome univoco descrittivo dell'URL generato per l'articolo. | Query, Retrieve |
Sincronizza
L'intervallo di aggiornamento determina la frequenza con cui i dati vengono sincronizzati tra l'origine dati e l'indice del connettore Graph. Esistono due tipi di intervalli di aggiornamento: ricerca per indicizzazione completa e ricerca per indicizzazione incrementale. Per altre informazioni, vedere Impostazioni di aggiornamento.
Risoluzione dei problemi
Dopo aver pubblicato la connessione, è possibile esaminare lo stato nella scheda Origini datinell'interfaccia di amministrazione. Per informazioni su come eseguire aggiornamenti ed eliminazioni, vedere Gestire il connettore.
In caso di problemi o se si desidera fornire commenti e suggerimenti, contattare Microsoft Graph | Supporto.