Mantieni la configurazione di accesso all'AI con governance di AI Data Engine
Mantieni l'accesso all'AI gestito in AI Data Engine (AIDE) allineato ai tuoi requisiti rivedendo e aggiornando le raccolte di Model Context Protocol (MCP), i provider di identità, gli ambiti di accesso e le impostazioni del server, e convalidando l'accesso dai tuoi client AI.
Prima di iniziare
-
Hai configurato una raccolta MCP e connesso un client AI. Fai riferimento a "Avvio rapido per l'accesso controllato all'AI con AI Data Engine".
-
Hai il ruolo di amministratore di AI Data Engine.
Le modifiche non hanno effetto immediato. Se modifichi i ruoli o gli ambiti dell'app Microsoft Entra ID, gli utenti riceveranno l'accesso aggiornato solo dopo che il loro client AI avrà ottenuto un nuovo token di accesso, operazione che può richiedere fino a circa un'ora. Gli utenti possono accedere di nuovo per ottenere un nuovo token più rapidamente. Se aggiungi dati a una raccolta, i file diventano ricercabili solo dopo che AI Data Engine li ha analizzati e indicizzati.
Verifica lo stato del server MCP e della raccolta
Verifica lo stato del server MCP e delle raccolte utilizzate dai tuoi client AI e risolvi eventuali avvisi di configurazione.
-
In NetApp Console, vai a AI data hub > AI Data Engine > Configuration > MCP collections.
-
Verifica lo stato del server MCP:
-
In esecuzione: Il server MCP è in esecuzione. I client AI possono connettersi quando l'opzione Abilita connessione a MCP è attivata.
-
Stato degradato: Il server MCP è in esecuzione, ma manca un prerequisito o non funziona correttamente, ad esempio non è configurato alcun provider di identità o il catalogo dei metadati risponde lentamente. I client AI potrebbero non essere in grado di autenticarsi o recuperare le raccolte.
-
Offline: Il server MCP è arrestato, disabilitato o irraggiungibile. I client AI non possono connettersi. Se la connessione a MCP è disattivata, consulta Abilita o disabilita la connessione a MCP.
-
-
Nell'elenco delle raccolte, verifica lo stato di ciascuna raccolta che i tuoi client AI usano. Una raccolta con stato Abilitata è disponibile per i client AI. Se i volumi di una raccolta sono ancora in fase di scansione, attendi il completamento dell'indicizzazione prima di cercare nuovi file.
-
Risolvi eventuali avvisi di configurazione:
-
Se manca un provider di identità, aggiungilo in Configurazione > Provider di identità. Fai riferimento a "Configura un provider di identità". Verifica che lo stato di connessione del provider di identità sia Connesso.
-
Se una raccolta mostra Pronto per la configurazione, apri il relativo menu Azioni, seleziona Configura per MCP e seleziona i provider di identità e gli ambiti utente. Vedi "Configurare una raccolta per MCP".
-
Se un volume in una raccolta mostra un errore di scansione, fai riferimento a "Visualizza lo stato e i dettagli della scansione".
-
Modifica una raccolta di dati
Aggiorna il nome, la descrizione o le risorse dati di una raccolta MCP.
-
In NetApp Console, vai a AI data hub > AI Data Engine > Configuration > MCP collections.
-
Apri il menu Azioni della raccolta e seleziona Modifica.
-
Aggiorna il nome o la descrizione secondo necessità.
-
Seleziona o deseleziona le risorse di dati per aggiornare la raccolta.
-
Seleziona Salva raccolta MCP.
Non puoi modificare, rinominare o eliminare la raccolta All files. Puoi configurarla per MCP. Consulta Aggiorna i provider di identità o gli ambiti utente per una raccolta.
Aggiornare un provider di identità
Aggiorna un provider di identità quando la configurazione del provider cambia.
-
In NetApp Console, vai a AI data hub > AI Data Engine > Configuration > Identity providers.
-
Apri il provider di identità per modificarlo.
-
Aggiorna il tenant ID, l'ID dell'applicazione (client) o il nome, se necessario.
-
Seleziona Salva.
Se è richiesto l'accesso di amministratore, chiedi al tuo amministratore di aggiornare il provider di identità.
Aggiorna i provider di identità o gli ambiti utente per una raccolta
Modifica i provider di identità che autorizzano l'accesso a una raccolta o gli scope utente che includono, quindi copia i dettagli di connessione aggiornati.
Se il provider di identità di cui hai bisogno non è presente nell'elenco, connettilo prima in Provider di identità. Consulta "Configura un provider di identità".
-
In NetApp Console, vai a AI data hub > AI Data Engine > Configuration > MCP collections.
-
Apri il menu Azioni della raccolta e seleziona Configura per MCP.
-
Seleziona i provider di identità che autorizzano l'accesso alla raccolta.
-
Per ogni provider di identità selezionato, rivedi gli Ambiti utente da includere. Mantieni Tutti gli ambiti utente oppure seleziona ambiti specifici e seleziona Aggiungi ambiti.
-
Seleziona Genera frammento di codice MCP.
-
Copia l'URL del server MCP aggiornato o il frammento di configurazione per il tuo client AI, quindi seleziona Chiudi.
La raccolta utilizza i provider di identità e gli ambiti utente che hai selezionato. Se l'URL del server MCP o il frammento di configurazione è cambiato, aggiorna ogni client AI interessato. Fai riferimento a Aggiorna le connessioni del client AI e convalida l'accesso.
Per ulteriori informazioni su questa attività, consulta "Configurare una raccolta per MCP".
Abilita o disabilita la connessione a MCP
Attiva Enable connection to MCP per consentire ai client AI di connettersi alle tue raccolte MCP. La connessione è disabilitata per impostazione predefinita. Attivala dopo aver configurato il server MCP e prima di generare il frammento di codice MCP per il tuo client AI. Se la disattivi in seguito, i client AI restano bloccati finché non la riattivi.
-
In NetApp Console, vai a AI data hub > AI Data Engine > Configuration > MCP collections.
-
Seleziona Impostazioni MCP.
-
Espandi Connessione al server MCP.
-
Usa l'interruttore Abilita connessione a MCP per attivare o disattivare la connessione.
Se disabiliti la connessione al server MCP, blocchi tutte le richieste dei client AI a tutte le raccolte MCP, indipendentemente dalle impostazioni della raccolta. I client AI già connessi perderanno l'accesso alla richiesta successiva. Disabilita la connessione solo se intendi sospendere l'accesso in tutto il server. -
Dopo aver attivato la connessione, controlla che il server MCP abbia lo stato Running. Fai riferimento a Verifica lo stato del server MCP e della raccolta.
Rivedi le impostazioni del server MCP
Verifica se i client AI possono connettersi al server MCP e controlla l'host name del cluster AIDE.
-
In NetApp Console, vai a AI data hub > AI Data Engine > Configuration > MCP collections.
-
Seleziona Impostazioni MCP.
-
In Connessione al server MCP, controlla Abilita connessione a MCP. Per attivare o disattivare la connessione, fai riferimento a Abilita o disabilita la connessione a MCP.
-
In MCP hostname, controlla l'host name del cluster AIDE. Se devi modificarlo, inserisci l'host name aggiornato e seleziona Configure.
Se cambi l'host name del cluster AIDE, cambia anche l'URL del server MCP. I client AI che usano l'URL precedente non possono connettersi finché non aggiorni le impostazioni di connessione. Il nuovo host name deve trovarsi in un dominio verificato nel tuo tenant Entra ID. Poiché l'Application ID URI e lo scope vengono creati a partire dall'host name, devi aggiornarli anche in Entra ID. Fai riferimento a Aggiorna le connessioni del client AI e convalida l'accesso. La protezione del server MCP con HTTPS richiede un certificato SSL/TLS. NetApp Console non gestisce il certificato. Lo script di ingress configura il certificato e l'host name del cluster AIDE. L'host name deve trovarsi in un dominio verificato nel tuo tenant Entra ID. Fai riferimento a "Prepara l'host MCP". -
Seleziona Chiudi.
Aggiorna le connessioni del client AI e convalida l'accesso
Dopo aver modificato raccolte, provider di identità, ambiti utente o impostazioni del server, verifica che i tuoi client AI possano ancora connettersi e che l'accesso corrisponda alle autorizzazioni desiderate.
-
Se l'URL del server MCP o il frammento di configurazione generato sono cambiati, aggiorna le impostazioni di connessione in ciascun client AI interessato. Fai riferimento a "Collega i client AI".
-
In ciascun client AI interessato, verifica che il client sia in grado di connettersi e autenticarsi.
-
Esegui una richiesta di ricerca rappresentativa.
-
Verifica che il contenuto della raccolta previsto sia accessibile e che l'accesso corrisponda alle autorizzazioni previste.
La configurazione del tuo MCP riflette le modifiche apportate, i client AI interessati possono connettersi e l'accesso corrisponde alle autorizzazioni previste.