Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il connettore ServiceNow Knowledge Copilot consente alle organizzazioni di visualizzare gli articoli di ServiceNow knowledge base (KB) all'interno di esperienze Microsoft 365 Copilot. Questo articolo descrive i passaggi per distribuire e personalizzare servicenow Knowledge Connector.
Per informazioni avanzate sulla configurazione di ServiceNow, vedere Configurare il servizio Informazioni su ServiceNow per l'inserimento del connettore.
Prerequisiti
Nella tabella seguente vengono riepilogati i passaggi per configurare l'ambiente ServiceNow e distribuire il connettore ServiceNow Knowledge.
| Ruolo | Attività |
|---|---|
| Amministratore di ServiceNow | Configurare l'ambiente |
| Amministratore di ServiceNow | Configurare i prerequisiti |
| Amministratore di Microsoft 365 | Distribuire il connettore nel interfaccia di amministrazione di Microsoft 365 |
| Amministratore di Microsoft 365 | Personalizzare le impostazioni del connettore (facoltativo) |
Prima di distribuire il connettore, verificare che siano soddisfatti i prerequisiti seguenti:
- L'utente è un amministratore di Microsoft 365.
- È possibile accedere a un'istanza di ServiceNow configurata.
- L'accesso all'API REST è abilitato per le tabelle ServiceNow necessarie.
- Gli elenchi di controllo di accesso (ACL) sono configurati per consentire l'accesso in lettura per il connettore.
- È stato identificato l'URL dell'istanza di ServiceNow.
Distribuire il connettore
Per aggiungere il connettore ServiceNow Knowledge per l'organizzazione:
- Nel riquadro sinistro della interfaccia di amministrazione di Microsoft 365 scegliere Connettori Copilot>.
- Passare alla scheda Connettori e nel riquadro sinistro scegliere Raccolta.
- Nell'elenco dei connettori disponibili scegliere ServiceNow Knowledge.From the list of available connectors, choose ServiceNow Knowledge.
Impostare il nome visualizzato
Il nome visualizzato viene usato per identificare i riferimenti nelle risposte copilot e consente agli utenti di riconoscere il file o l'elemento associato. Indica anche contenuto attendibile e viene usato come filtro dell'origine di contenuto.
È possibile accettare il nome visualizzato predefinito di ServiceNow o personalizzarlo per usare un nome riconosciuto dagli utenti dell'organizzazione.
Per altre informazioni, vedere Migliorare l'individuazione copilot del contenuto del connettore.
Scegliere il flusso in base ai criteri utente
ServiceNow Knowledge Connector supporta due flussi per le autorizzazioni dei criteri utente: Simple e Advanced.
Il valore predefinito è Simple. In questo flusso, i criteri utente avanzati basati su script e i criteri utente a livello di knowledge base (padre) non vengono considerati quando vengono considerati criteri utente a livello di articolo (figlio).
Se l'istanza di ServiceNow usa script avanzati nei criteri utente knowledge base o a livello di articolo o si vuole che il connettore valuti le autorizzazioni a livello di knowledge base o padre quando valuta le autorizzazioni dell'articolo, usare il flusso Avanzate. Questo flusso garantisce una gestione accurata delle autorizzazioni quando il contenuto viene inserito in Microsoft Graph. Per il corretto funzionamento dell'opzione Avanzate , è necessario configurare l'API REST.
Impostare l'URL dell'istanza
Per connettersi al sito ServiceNow, usare l'URL del sito, che in genere è il formato seguente: https://<instance-name>.service-now.com
È possibile trovare il nome dell'istanza nel dashboard di amministrazione di ServiceNow o controllando l'URL di accesso usato dall'organizzazione.
Scegliere il tipo di autenticazione
Scegliere il metodo di autenticazione allineato ai criteri di sicurezza dell'organizzazione. Il connettore ServiceNow supporta i tipi di autenticazione seguenti:
- Autenticazione di base : immettere il nome utente e la password di un account ServiceNow con il ruolo knowledge base per l'autenticazione nell'istanza.
- OAuth 2.0 (scelta consigliata): per informazioni dettagliate, vedere OAuth 2.0.
- Microsoft Entra ID OpenID Connect: per informazioni dettagliate, vedere Microsoft Entra ID OpenID Connect.
OAuth 2.0
Effettuare il provisioning di un endpoint OAUTH nell'istanza di ServiceNow per consentire l'accesso al connettore ServiceNow Knowledge. Per altre informazioni, vedere Creare un endpoint per i client per accedere all'istanza di .
Utilizzare le informazioni nella tabella seguente per completare il modulo di creazione dell'endpoint.
| Campo | Descrizione | Valore consigliato |
|---|---|---|
| Nome | Valore univoco che identifica l'applicazione per cui è necessario l'accesso OAuth. | Microsoft Search |
| ID client | ID univoco generato automaticamente di sola lettura per l'applicazione. L'istanza usa l'ID client quando richiede un token di accesso. | ND |
| Segreto client | Con questa stringa di segreto condiviso, l'istanza di ServiceNow e Microsoft Search autorizzano le comunicazioni tra loro. | Seguire le procedure consigliate per la sicurezza considerando il segreto come password. |
| URL di reindirizzamento | URL di callback necessario a cui viene reindirizzato il server di autorizzazione. | Per M365 Enterprise: https:// gcs.office.com/v1.0/admin/oauth/callback, For M365 Government: https:// gcsgcc.office.com/v1.0/admin/oauth/callback |
| Logo URL | URL che contiene l'immagine per il logo dell'applicazione. | ND |
| Attivazione | Selezionare la casella di controllo per rendere attivo il Registro applicazioni. | Impostare su attivo |
| Durata del token di aggiornamento | Numero di secondi di validità di un token di aggiornamento. Per impostazione predefinita, i token di aggiornamento scadono tra 100 giorni (8.640.000 secondi). | 31.536.000 (un anno) |
| Durata del token di accesso | Numero di secondi di validità di un token di accesso. | 43.200 (12 ore) |
Immettere l'ID client e il segreto client per connettersi all'istanza. Dopo la connessione, usare le credenziali dell'account ServiceNow per autenticare l'autorizzazione per la ricerca per indicizzazione. L'account deve avere almeno il ruolo di knowledge base . Per informazioni sui record di tabella e sulle autorizzazioni dei criteri utente dell'indice a cui fornire l'accesso in lettura, vedere Configurare le autorizzazioni per gli elementi dell'indice.
Microsoft Entra ID OpenID Connect
Per usare Microsoft Entra ID OpenID Connect:
Registrare una nuova app come singolo tenant in Microsoft Entra ID. Non è necessario un URI di reindirizzamento. Per altre informazioni, vedere Registrare un'applicazione.
Copiare l'ID applicazione (client) e l'ID directory (tenant) per l'app.
Creare un segreto client per l'app e salvarlo in modo sicuro.
- Passare a Gestisci>certificati e segreti.
- Scegliere nuovo segreto client.
- Specificare un nome e scegliere Salva.
Usare i cmdlet di PowerShell seguenti per recuperare l'ID oggetto entità servizio.
Install-Module -Name Az -AllowClobber -Scope CurrentUserConnect-AzAccountGet-AzADServicePrincipal -ApplicationId "Application-ID"Sostituire "Application-ID" con l'ID applicazione (client) dell'applicazione registrata nel passaggio 2. Si noti il valore dell'oggetto ID dall'output di PowerShell; questo valore è l'ID oggetto entità servizio.
In alternativa, è possibile recuperare le informazioni dal Interfaccia di amministrazione di Microsoft Entra:
a. Nella registrazione dell'app passare a Panoramica. b. Scegliere Applicazione gestita nella directory locale. c. Scegliere l'URL e copiare objectID. Questo è l'ID oggetto entità servizio.
Nell'istanza di ServiceNow registrare una nuova entità OIDC OAuth. Per informazioni dettagliate, vedere Creare un provider OIDC OAuth. Utilizzare i valori elencati nella tabella seguente nel modulo di registrazione; lasciare i valori predefiniti per gli altri campi.
| Campo | Descrizione | Valore |
|---|---|---|
| Nome | Nome univoco per l'entità OIDC OAuth. | Microsoft Entra ID |
| ID client | Dalla registrazione Microsoft Entra ID | ID applicazione (client) |
| Segreto client | Dalla registrazione Microsoft Entra ID | Segreto client |
Nota
Dopo aver creato l'entità OIDC OAuth, il segreto client viene generato automaticamente in ServiceNow. Sostituire questo segreto client con il segreto client generato nel centro Microsoft Entra Amministrazione.
Nel campo Configurazione provider OIDC OAuth selezionare l'icona di ricerca e quindi selezionare Nuovo.
Compilare il modulo di configurazione del provider OIDC come indicato di seguito:
Campo Valore OIDC Provider Microsoft Entra ID URL dei metadati OIDC Usare l'URL seguente: https://login.microsoftonline.com/<tenantId>/.well-known/openid-configuration.
Sostituire<tenantId>con l'ID directory (tenant).Intervallo di vita della cache di configurazione OIDC 120 Applicazione Globale Attestazione utente Sub Campo utente ID utente Abilitare la verifica delle attestazioni JTI Disabilitato Scegliere Invia per salvare la configurazione.
Creare un account ServiceNow. Per informazioni dettagliate, vedere Creare un utente in ServiceNow. Usare i valori seguenti; lasciare gli altri campi come predefiniti:
| Campo | Valore consigliato |
|---|---|
| ID utente | ID entità servizio |
| Solo accesso al servizio Web | Controllato |
- Assegnare il ruolo Knowledge Base all'account ServiceNow. Per informazioni dettagliate, vedere Assegnare un ruolo a un utente. Usare l'ID applicazione come ID client e segreto client nella configurazione guidata dell'interfaccia di amministrazione per eseguire l'autenticazione con Microsoft Entra ID OpenID Connect.
Nota
Non attivare l'assegnazione obbligatoria. Per altre informazioni, vedere Proprietà di un'applicazione aziendale - Microsoft Entra ID.
Aggiungere lo spazio dei nomi dell'API
Se si usa il flusso Avanzate , immettere lo spazio dei nomi API creato nell'istanza di ServiceNow. Per informazioni dettagliate, vedere Configurare l'API REST.
Eseguire l'implementazione
Per eseguire l'implementazione a un gruppo di destinatari limitato, scegliere l'interruttore accanto a Implementazione a gruppi di destinatari limitati e specificare gli utenti e i gruppi a cui distribuire il connettore. Per altre informazioni, vedere Implementazione temporanea per i connettori Copilot.
Scegliere Crea per distribuire la connessione. Il connettore ServiceNow Knowledge Copilot avvia immediatamente l'indicizzazione del contenuto.
Nella tabella seguente sono elencati i valori predefiniti impostati. Per personalizzare questi valori, vedere Personalizzare le impostazioni.
| Categoria | Impostazione | Valore predefinito |
|---|---|---|
| Utenti | Autorizzazioni di accesso | Solo gli utenti con accesso al contenuto nell'origine dati. |
| Utenti | Esegui il mapping delle identità | Identità dell'origine dati mappate tramite ID Microsoft Entra. |
| Contenuto | Stringa di query | active=true^workflow_state=published |
| Contenuto | Gestire le proprietà | Per visualizzare le proprietà e gli schemi predefiniti, vedere Gestire le proprietà. |
| Sincronizza | Ricerca per indicizzazione incrementale | Frequenza: ogni 15 minuti |
| Sincronizza | Ricerca per indicizzazione completa | Frequenza: ogni giorno |
Dopo aver creato la connessione, è possibile esaminare lo stato (incluso il numero di utenti indicizzati & articoli) nella sezione Connettori del interfaccia di amministrazione di Microsoft 365. Quando lo stato della connessione è Pronto, è possibile convalidare la connessione specificando l'oggetto sys_id di qualsiasi articolo della knowledge base e verificandone le autorizzazioni utente. Per altre informazioni, vedere Ricerca e convalida del contenuto indicizzato Microsoft 365 Copilot connettori.
Personalizzare le impostazioni
È possibile personalizzare i valori predefiniti per le impostazioni del connettore ServiceNow Knowledge. Per personalizzare le impostazioni, nella pagina del connettore nell'interfaccia di amministrazione scegliere Configurazione personalizzata.
Personalizzare le impostazioni utente
Autorizzazioni di accesso
Il connettore ServiceNow Knowledge Copilot supporta le autorizzazioni di ricerca utente seguenti:
- Tutti
- Solo gli utenti con accesso a questa origine dati (impostazione predefinita)
Se si sceglie Tutti, i dati indicizzati vengono visualizzati nei risultati della ricerca per tutti gli utenti. Se si sceglie Solo le persone con accesso a questa origine dati, i dati indicizzati vengono visualizzati nei risultati della ricerca per gli utenti che hanno accesso a questa origine dati.
Se si seleziona il flusso semplice per la lettura delle autorizzazioni dei criteri utente, il connettore ServiceNow Knowledge Connector gestisce le autorizzazioni nel modo seguente:
- Se un articolo ha
Can Readcriteri utente, questi criteri vengono applicati durante l'inserimento. I criteri utente oCan Contributea livelloCan Readdi knowledge base vengono ignorati. - Se sia l'articolo che knowledge base hanno
Cannot Readcriteri utente, vengono rispettati entrambi. - Se un utente fa parte dei criteri utente a livello
Can Readdi articolo, ma non del livello knowledge base, potrebbe comunque vedere l'articolo in Microsoft 365 anche se non può accederti in ServiceNow. Per impedire agli utenti di visualizzare l'articolo, rimuovere l'utente dai criteri utente a livelloCan Readdi articolo. - Se a un articolo della Knowledge Base non è applicato un criterio utente, viene visualizzato nei risultati per tutti gli utenti dell'organizzazione.
Se si seleziona il flusso avanzato per la lettura dell'autorizzazione dei criteri utente, durante la valutazione delle autorizzazioni a livello di articolo vengono considerate autorizzazioni a livello di knowledge base articolo (padre) e di articolo della knowledge base (figlio). Questo è il modo in cui le autorizzazioni vengono gestite in ServiceNow. Per altre informazioni, vedere Gestione dell'accesso alle Knowledge Base e agli articoli della Knowledge Base.
Nota
La funzionalità di gestione delle autorizzazioni di flusso avanzate è attualmente in anteprima.
Mapping delle identità
Per impostazione predefinita, ServiceNow esegue il mapping degli ID di posta elettronica a Microsoft Entra ID (UPN o Posta). È possibile fornire una formula di mapping personalizzata se l'organizzazione usa attributi di identità diversi. Per altre informazioni, vedere Eseguire il mapping di identità non Microsoft Entra ID.
Personalizzare le impostazioni del contenuto
Stringa di query
ServiceNow usa il filtro predefinito seguente: active=true^workflow_state=published.
È possibile modificare questo filtro per indicizzare solo articoli specifici in base alle esigenze dell'organizzazione. Usare il generatore di stringhe di query codificate di ServiceNow per creare filtri personalizzati. Per altre informazioni, vedere Generare una stringa di query codificata tramite un filtro.
Gestire le proprietà
È possibile gestire le proprietà nei modi seguenti:
- Aggiungere proprietà all'indice da ServiceNow.
- Personalizzare la proprietà AccessUrl per riflettere il formato URL dell'organizzazione.
Nella tabella seguente sono elencate le proprietà che il connettore ServiceNow Knowledge Connector indicizza per impostazione predefinita.
Nota
È possibile visualizzare ma non è possibile modificare gli attributi dello schema (Ricercabile, Queryable, Recuperabile, Affinabile), etichette semantiche e alias per queste proprietà predefinite. È tuttavia possibile aggiungere altre proprietà personalizzate e modificare gli attributi della proprietà quando si crea la connessione. Dopo aver creato la connessione, non è possibile modificare gli attributi della proprietà.
| Proprietà | Etichetta semantica | Descrizione | Attributi dello schema |
|---|---|---|---|
| AccessUrl | Url | URL di destinazione dell'elemento nell'origine dati. | Recuperare |
| Attivazione | Campo booleano che indica se l'articolo è attualmente attivo e può essere visualizzato o cercato dagli utenti. | ||
| ArticleType | Formato dell'articolo, spesso un tipo HTML o Wiki. | Query | |
| Author | Autori | Tutte le persone che hanno partecipato/collaborato all'elemento nell'origine dati | Query, Affina recupero |
| CanReadUserCriteria | Fornisce i criteri utente che definiscono i gruppi di destinatari che hanno accesso per visualizzare l'articolo. | ||
| CannotReadUserCriteria | Fornisce i criteri utente che definiscono il gruppo di destinatari a cui viene esplicitamente negato l'accesso per visualizzare l'articolo. | ||
| CmdbCi | Riferimento a un elemento di configurazione (CI) da CMDB, che collega l'articolo a un asset o a un servizio specifico. | Query, Recupero, Ricerca | |
| Descrizione | Breve riepilogo del contenuto dell'articolo, che consente agli utenti di comprendere il contenuto dell'articolo dai risultati della ricerca. | Recupera, Cerca | |
| Entitytype | Tipo di entità di cui si parla nell'articolo (Knowledge Base) | Query, Refine, Retrieve | |
| HelpfulCount | Numero di volte in cui gli utenti hanno contrassegnato l'articolo come utile. | ||
| IconUrl | IconUrl | URL icona che rappresenta la categoria o il tipo dell'articolo. | Recuperare |
| Itempath | Percorso dell'articolo all'interno della gerarchia knowledge base. | Query, Refine, Retrieve, Search | |
| KbCategory | Categoria a cui appartiene l'articolo all'interno del relativo knowledge base. | Query, Recupero, Ricerca | |
| KbKnowledgeBase | Il knowledge base in cui è archiviato l'articolo. | Query, Recupero, Ricerca | |
| KbKnowledgeBaseUrl | URL di collegamento al knowledge base | Query, Retrieve | |
| MetaDescription | Breve descrizione usata nei risultati del motore di ricerca | Recupera, Cerca | |
| Numero | Identificatore univoco assegnato automaticamente all'articolo della knowledge base, ad esempio "KB0000001" | Query, Recupero, Ricerca | |
| PreviewContent | Contenuto usato per una rapida anteprima dell'articolo. | Recuperare | |
| Pubblicato | Indicatore di data/ora che indica quando l'articolo è stato pubblicato e reso visibile agli utenti. | Query, Retrieve | |
| Valutazione | Valutazione media assegnata all'articolo dagli utenti. | Query, Retrieve | |
| ShortDescription | Titolo | Titolo dell'elemento che si vuole visualizzare in Copilot e in altre esperienze di ricerca | Query, Recupero, Ricerca |
| SysClassName | Identifica il modello per la conoscenza. Informazioni sui modelli standard, Altri valori possono essere domande frequenti, Procedura e così via. | ||
| SysCreatedBy | Creato da | Nome della persona che ha creato l'articolo | Query, Refine, Retrieve |
| SysCreatedOn | Data e ora di creazione | Data e ora di creazione dell'articolo | Query, Refine, Retrieve |
| SysDomain | Dominio a cui appartiene l'articolo della Knowledge Base in un'istanza multidominio | ||
| Sysid | ID univoco a 32 caratteri per l'articolo, usato per l'identificazione back-end. | Query, Retrieve | |
| SysModCount | Numero di volte in cui l'articolo è stato modificato. | Recuperare | |
| SysTags | Parole chiave o tag che possono essere aggiunti all'articolo per migliorare la ricerca e l'organizzazione. | Query, Refine, Retrieve, Search | |
| SysUpdatedBy | Autore ultima modifica | Nome della persona che ha modificato l'articolo più di recente. | Query, Refine, Retrieve |
| SysUpdatedOn | Data e ora dell'ultima modifica | Data e ora dell'ultima modifica dell'elemento | Query, Refine, Retrieve |
| SysViewCount | Numero di volte in cui è stato visualizzato l'articolo. | Query, Retrieve | |
| TassonomiaTopica | Riferimento a un argomento in una tassonomia definita, usato per un'organizzazione strutturata. | Query, Recupero, Ricerca | |
| Argomento | Un altro campo per la categorizzazione degli articoli | Query, Recupero, Ricerca | |
| UseCount | Numero di volte in cui l'articolo è stato allegato a un altro record, ad esempio un evento imprevisto o un problema. | ||
| ValidTo | Data di scadenza dell'articolo. Dopo questa data, l'articolo non verrà restituito nei risultati della ricerca | Query, Retrieve | |
| WorkflowState | Stato corrente dell'articolo nel relativo ciclo di vita, ad esempio "Bozza", "Revisione", "Pubblicato" o "Ritirato". | Query, Refine, Retrieve | |
Contenuto Content |
Corpo principale dell'articolo, in cui vengono scritte le informazioni dettagliate. | Ricerca |
Personalizzare la proprietà AccessURL
Per definire un'espressione personalizzata per la proprietà AccessURL :
- Nella scheda Contenuto passare a Gestisci proprietà.
- Nella tabella Proprietà selezionare la proprietà AccessURL .
- Nel pannello laterale, in Espressione predefinita, immettere l'espressione personalizzata nel campo Nuova espressione predefinita . Usare la
${PropertyName}sintassi per i valori dinamici. Ad esempio:https://instancedomain.service-now.com/sp?id=kb_article&sys_id=${SysId}. - Selezionare Salva modifiche.
- Per visualizzare in anteprima il risultato, selezionare Anteprima dati e scorrere fino alla proprietà personalizzata.
Nota
- È necessario creare una nuova connessione ServiceNow Knowledge per personalizzare la proprietà AccessURL . La modifica di una connessione esistente per personalizzare la proprietà dello schema non è attualmente supportata.
È possibile eseguire l'override dell'espressione predefinita per articoli della Knowledge Base specifici usando regole basate sui filtri delle proprietà. Per aggiungere una regola:
- In Imposta regole aggiuntive per configurare le espressioni selezionare Aggiungi nuova regola.
- Nel pannello delle regole:
- Scegliere una proprietà di filtro, ad esempio Category.
- Immettere uno o più valori (separati da virgole, con distinzione tra maiuscole e minuscole).
- Definire l'espressione personalizzata per tali valori.
- Selezionare Salva modifiche.
- Per visualizzare l'anteprima, selezionare Anteprima dati e scorrere fino alla proprietà personalizzata.
Nota
Se più regole si applicano a un elemento, viene usata la prima regola nell'elenco. Le modifiche diventano effettive dopo la successiva ricerca per indicizzazione completa.
Per altre informazioni, vedere Personalizzare i valori per determinate proprietà dello schema.
Personalizzare gli intervalli di sincronizzazione
Configurare la pianificazione della sincronizzazione per mantenere aggiornato il contenuto indicizzato:
- Ricerca per indicizzazione completa : reindicizza tutto il contenuto, rimuove il contenuto eliminato e aggiorna tutte le autorizzazioni. Per impostazione predefinita, la frequenza è giornaliera.
- Ricerca per indicizzazione incrementale : sincronizza solo il contenuto modificato, non gli aggiornamenti delle autorizzazioni. La frequenza predefinita è ogni 15 minuti.
Importante
- Le identità (utenti e gruppi) e le autorizzazioni di accesso vengono aggiornate solo durante le ricerche per indicizzazione complete. Le ricerche per indicizzazione incrementali non aggiornano le autorizzazioni di accesso o le appartenenze ai gruppi.
- Durante la prima ricerca per indicizzazione completa, viene eseguita prima la sincronizzazione delle identità (ad esempio la lettura di utenti, i criteri utente e il mapping degli utenti a criteri utente come le appartenenze ai gruppi), seguita dalla sincronizzazione del contenuto. In questo modo si garantisce il mapping delle autorizzazioni corrette agli elementi inseriti.
- Durante le successive ricerche per indicizzazione complete periodiche, la sincronizzazione del contenuto e dell'identità avviene in parallelo. La ricerca per indicizzazione completa periodica viene completata al termine della sincronizzazione del contenuto e dell'identità.
- Le ricerche per indicizzazione complete periodiche sono più veloci delle prime ricerche per indicizzazione complete perché la prima ricerca per indicizzazione include l'individuazione e l'inserimento per la prima volta di utenti, criteri utente e elementi di mapping e contenuto. Le ricerche per indicizzazione complete periodiche inseriiscono solo nuovi elementi, utenti e criteri utente.
Per altre informazioni, vedere Linee guida per le impostazioni di sincronizzazione.