Connessione a Performance Hub

ciò che distingue il tuo Agente AI da un chatbot generico è il fatto di essere integrato nella tua attività. Tramite la connessione MCP di Performance Hub, l'agente può cercare clienti e membri, verificare prenotazioni e visite, controllare lo stato di salute dei dispositivi, estrarre report: gli stessi dati operativi che vedi in Performance Hub, a disposizione dell'agente durante la conversazione e nelle sue automazioni.

Puoi controllare con precisione quale parte di Performance Hub l'agente può raggiungere: quali strutture, quali capacità e persino quali singoli strumenti. Questa pagina spiega le opzioni disponibili.

L'impostazione MCP access viene configurata in Device management sotto Configuration → MCP access.

Figura 1: La sezione MCP access — ambito di accesso, capacità e interruttore di attivazione/disattivazione

Riferimento rapido

Consiglio: Lascia MCP access attivato (impostazione predefinita). Questa connessione è ciò che rende l'agente veramente utile per la tua attività e, fin da subito, è limitata in modo sicuro alla sola struttura in cui l'agente è stato aggiunto. Se in seguito avrai bisogno che l'agente operi su dati più estesi (più sedi, una regione o l'intera organizzazione), amplia l'Access scope anziché lavorare senza la connessione. "Se questa opzione è disattivata, l'agente non potrà accedere ad alcuna funzione, strumento o dato di Performance Hub."

Cosa offre la connessione all'agente

MCP (Model Context Protocol) è lo standard aperto che l'agente utilizza per chiamare Performance Hub: "Consenti a questo agente di chiamare gli strumenti di Performance Hub tramite un account di servizio. Nessuna chiave viene memorizzata sul dispositivo: l'accesso viene verificato a ogni richiesta e revocato nel momento in cui disattivi questa opzione." In pratica, significa che puoi fare richieste come:

• "Quanti visitatori si sono registrati alla reception questa settimana rispetto alla scorsa?"
• "Quali controller per porte sono attualmente offline?"
• "Trova il cliente il cui pagamento è fallito ieri e riassumi il suo account."

…e l'agente risponde attingendo dai dati in tempo reale di Performance Hub, limitandosi a ciò che gli hai concesso. La stessa connessione alimenta le automazioni (un riepilogo mattutino delle prenotazioni di ieri, un resoconto settimanale sullo stato dei dispositivi) e il manuale operativo integrato descritto in Skills.

L'agente agisce con la propria identità in Performance Hub (un account di servizio associato al dispositivo) e non come una persona specifica. Ogni chiamata effettuata viene verificata rispetto ai permessi concessi qui, sul lato di Performance Hub: la concessione viene applicata centralmente, non basandosi sulla fiducia.

Ambito di accesso — quali strutture l'agente può visualizzare

• Questa struttura (predefinito) — la struttura in cui è stato aggiunto l'agente. Ideale per un agente che opera su una singola sede.
• Strutture selezionate — solo le strutture che elenchi. Utile per un agente che serve alcune sedi.
• Regioni — ogni struttura nelle regioni selezionate. Utile per l'agente di un responsabile regionale.
• Intera organizzazione — tutto. Adatto agli agenti della sede centrale che effettuano report multi-sede.

"Puoi concedere l'accesso solo all'interno delle tue strutture, regioni e permessi."

Capacità — cosa l'agente può utilizzare

Le capacità sono gruppi di strumenti collegati ai moduli di Performance Hub.

• Tutte le capacità (predefinito) — "L'agente può utilizzare ogni capacità disponibile, comprese le nuove capacità man mano che vengono aggiunte."
• Solo le capacità selezionate — "L'agente può utilizzare solo le capacità selezionate di seguito." L'agente riceve esattamente queste e nient'altro, anche se i tuoi abbonamenti cambiano.
• Tutte le capacità tranne quelle selezionate — "L'agente può utilizzare ogni capacità tranne quelle selezionate di seguito. Le nuove capacità vengono incluse automaticamente." Un buon compromesso: piena utilità, escludendo ad esempio la fatturazione.

La sezione dispone anche di un interruttore di sola lettura: attivandolo, l'agente può effettuare ricerche ma non può modificare nulla, poiché gli strumenti che apportano modifiche vengono nascosti e rifiutati. È il modo più semplice per eseguire un agente strettamente informativo.

Selezione degli strumenti (avanzato)

Per un controllo granulare, espandi Advanced e scegli una Tool selection (Solo gli strumenti selezionati o Tutti tranne gli strumenti selezionati) per includere o escludere singoli strumenti all'interno delle capacità concesse. Ad esempio, potresti consentire la ricerca dei clienti ma escludere l'aggiornamento dei clienti. La maggior parte delle strutture non ne ha mai bisogno; il controllo a livello di capacità rappresenta il livello pratico ideale.

Ultimo aggiornamento di mostra l'ultimo utente che ha modificato i permessi concessi.

Una nota sulle azioni di scrittura

A meno che non attivi l'interruttore di sola lettura, l'autorizzazione copre tutto ciò che le funzionalità espongono, incluse le azioni che modificano i dati e non si limitano a leggerli, laddove un modulo le offra. Per fare in modo che l'agente rimanga informativo, utilizza l'interruttore di sola lettura, limitati a funzionalità orientate al reporting o escludi strumenti specifici. L'agente inoltre conferma le azioni rilevanti nella conversazione prima di eseguirci.

Disattivazione e revoca dell'accesso

• Disattiva l'MCP access e l'agente perderà immediatamente la connessione a Performance Hub: continuerà a funzionare come assistente generale con i suoi file e la sua Memory, ma non potrà più visualizzare i dati aziendali. Le modifiche (attivazione, disattivazione o modifiche dell'ambito) diventano effettive pochi istanti dopo il salvataggio; non è necessario riavviare nulla.
• Rimozione o ripristino dell'agente revoca completamente le sue credenziali.

Chi può concedere cosa

Le autorizzazioni sono limitate da chi le concede: l'ambito e le funzionalità di cui tu disponi nell'Organizzazione rappresentano il limite massimo di ciò che puoi assegnare all'agente. Se un'opzione non è disponibile, è perché il tuo ruolo non la include; un amministratore con l'accesso necessario potrà impostarla al suo posto. Se non riesci affatto a modificare l'MCP access, la sezione indicherà "Non disponi dell'autorizzazione per configurare l'MCP access per questo dispositivo."

Pagine correlate

• Skills — il manuale operativo che rende questa connessione produttiva
• Agent capabilities — connessione dell'agente alle tue altre app
• Automazioni e attività pianificate — processi non presidiati che utilizzano i dati di Performance Hub
• Controllo accessi — chi può parlare con l'agente (una questione separata rispetto a ciò che l'agente può raggiungere)
• Sicurezza e privacy