Un connettore consente a ONE di accedere a uno strumento che si trova al di fuori di Factorial IT. Aggiungine uno quando desideri che l'assistente cerchi informazioni o compia azioni su un altro sistema già utilizzato dal tuo team.

Funzionalità

Panoramica

Ogni connettore è un server Model Context Protocol (MCP) che registri tramite il suo URL. Quando è connesso, ONE può chiamare gli strumenti offerti da quel server mentre chatti con esso. Ad esempio, può trovare una pagina in Notion o eseguire un'attività in un altro servizio.

Motivi tipici per aggiungerne uno:

• Cercare dati altrove. Porta informazioni detenute da uno strumento su cui il tuo team fa affidamento.
• Agire altrove. Consenti all'assistente di completare attività all'interno di un servizio connesso.
• Estendere ciò che l'assistente può fare. Collega qualsiasi strumento che supporta il Model Context Protocol.

Non hai bisogno di un connettore se l'assistente deve lavorare solo con i dati di Factorial IT o con le linee guida della tua azienda. Per questo, utilizza gli articoli della knowledge base.

Prima di iniziare

• Per aggiungere, modificare, ri-autenticare o eliminare connettori, o per cambiare le loro autorizzazioni sugli strumenti, hai bisogno del permesso Gestisci agenti AI. Per vederli, Visualizza agenti AI è sufficiente.
• Hai bisogno dell'URL di un server MCP che supporta l'autenticazione OAuth.

Come utilizzare

1. Vai su Agenti AI > Impostazioni e seleziona la scheda Connettori.
2. Fai clic su Aggiungi connettore. Si apre una finestra.
3. Compila i dettagli:
   • Nome: come viene etichettato il connettore, per esempio Notion.
   • Server URL: l'endpoint MCP, per esempio https://example.com/mcp.
4. Apri Impostazioni avanzate solo se il tuo server MCP non supporta la Registrazione Dinamica del Client. In tal caso, registra Factorial IT nella console OAuth del fornitore e inserisci il ID Client e il Client secret. I client pubblici che si basano su PKCE possono lasciare il segreto vuoto.
5. Fai clic su Connetti. Verrai inviato al server MCP per effettuare il login. Una volta concessi i permessi, torni a Factorial IT e il connettore mostra Connesso.

Stati dei connettori

Visualizza un connettore

La scheda Connettori mostra prima i connettori integrati (Factorial IT e il connettore del centro assistenza), seguiti da quelli che hai aggiunto. I connettori integrati sono sempre Connessi. Fai clic su qualsiasi connettore per aprire la sua pagina.

Nella pagina di un connettore che hai aggiunto troverai:

• Impostazioni: il Nome, l'URL del server e, se ne hai inserito uno, il ID Client. Il client secret non viene mai visualizzato. Usa Modifica connessione per cambiare questi valori. Cambiare l'URL del server o le credenziali OAuth significa che devi autenticarti di nuovo.
• Autorizzazioni chat e Autorizzazioni agente: ogni strumento offerto dal server MCP, ognuno con la sua politica. Vedi "Imposta autorizzazioni sugli strumenti" qui sotto.

La lista degli strumenti viene recuperata dal server MCP ogni volta che apri la pagina, quindi corrisponde sempre a ciò che il server offre attualmente. Gli strumenti vengono visualizzati solo mentre il connettore è Connesso. Se il server non risponde, vedrai un avviso invece degli strumenti, e Impostazioni rimane utilizzabile.

I connettori integrati non hanno Impostazioni e nessun menu Azioni. Non puoi modificarli o eliminarli, ma puoi cambiare le loro autorizzazioni sugli strumenti.

Gestisci un connettore

Nella pagina di un connettore che hai aggiunto, utilizza il menu Azioni nell'angolo in alto a destra:

• Ri-autenticati: accedi di nuovo al server MCP. Questa opzione appare solo quando il connettore non è Connesso.
• Elimina: rimuovi il connettore insieme alle sue credenziali salvate, una volta confermato. Se un agente sta utilizzando il connettore, non puoi eliminarlo fino a quando non lo disattivi in quell'agente.

Imposta autorizzazioni sugli strumenti

La pagina del connettore controlla come ONE può utilizzare ciascun strumento. Quando il connettore è Connesso, i suoi strumenti sono elencati in due sezioni:

• Autorizzazioni chat coprono le tue conversazioni con ONE.
• Autorizzazioni agente coprono ONE quando lavora senza supervisione, ad esempio su un ticket dove l'hai aggiunto come agente. Quando attivi il connettore per un agente personalizzato, quell'agente prende una copia di queste impostazioni e la conserva. Le modifiche apportate qui in seguito non raggiungono quell'agente.

Entrambe le sezioni raggruppano gli strumenti in Strumenti di sola lettura e Strumenti di lettura e scrittura. Uno strumento conta come di sola lettura solo se il server MCP lo contrassegna con l'annotazione readOnlyHint. Tutto il resto è considerato di lettura e scrittura.

Per impostare una politica per un intero gruppo, utilizza il menu a destra di quel gruppo. La scelta si applica anche agli strumenti che il server aggiunge in futuro, e sovrascrive qualsiasi impostazione per strumento nel gruppo. Per impostare uno strumento, espandi il gruppo e scegli una politica con le icone accanto al nome dello strumento. Quando gli strumenti in un gruppo hanno politiche miste, il gruppo mostra Personalizzato.

Politiche predefinite, fino a quando non le cambi:

Ciò significa che gli agenti possono utilizzare immediatamente gli strumenti di lettura e scrittura. Per mantenere gli agenti limitati alla lettura su un connettore, imposta Strumenti di lettura e scrittura su Rifiuta sempre sotto Autorizzazioni agente. Qualsiasi agente personalizzato che utilizza già il connettore ha la propria copia, quindi aggiornalo anche in quell'agente.

Come ONE utilizza i connettori

Durante una conversazione, ONE ha accesso agli strumenti di ogni connettore connesso e sceglie quello giusto per ogni richiesta. Per indirizzarlo verso un particolare connettore, digita @ nella casella dei messaggi e seleziona il connettore. ONE controlla le Autorizzazioni chat del connettore prima di eseguire qualsiasi strumento. Per impostazione predefinita, ti chiede prima di utilizzare uno strumento che scrive o modifica dati.

Risoluzione dei problemi e FAQ

Risoluzione dei problemi

• Il connettore mostra Errore. La connessione è fallita. Apri la sua pagina e utilizza Azioni > Ri-autenticati.
• Il connettore rimane in Autenticazione in attesa. L'autenticazione non è stata completata. Ri-autenticati e completa il login sul server MCP.
• Nessuno strumento appare nella pagina del connettore. Gli strumenti vengono visualizzati solo mentre il connettore è Connesso, e il server deve rispondere. Se vedi un avviso, il server non ha risposto.
• Non puoi eliminare un connettore. Un agente lo sta ancora utilizzando. Disattivalo prima in quell'agente.
• La connessione fallisce su un server senza Registrazione Dinamica del Client. Registra Factorial IT nella console OAuth del fornitore e inserisci il ID Client e il Client secret sotto Impostazioni avanzate.
• Una modifica delle autorizzazioni non ha raggiunto un agente. L'agente mantiene la propria copia. Cambia la politica all'interno dell'agente.

FAQ

1. Quale autorizzazione mi serve per aggiungere un connettore?
   Gestisci agenti AI. Visualizza agenti AI ti consente solo di vedere i connettori.
    
2. Posso modificare o eliminare i connettori integrati?
   No. Puoi solo cambiare le loro autorizzazioni sugli strumenti.
    
3. Come decide Factorial IT se uno strumento è di sola lettura?
   Solo gli strumenti che il server MCP contrassegna con readOnlyHint sono di sola lettura. Ogni altro strumento è di lettura e scrittura.
    
4. Perché non c'è la Richiedi approvazione per gli agenti?
   Un agente opera autonomamente, quindi nessuno è presente per approvare lo strumento.
    
5. Posso vedere il client secret dopo averlo salvato?
   No. Non viene mai più mostrato.