Vai al contenuto principale

Strumenti

Tramite il riquadro Strumenti nell’area Impostazioni AI si imposta per ogni provider AI quali strumenti e integrazioni sono disponibili. Questo determina quali funzionalità aggiuntive l’AI può usare in una conversazione, come cercare su internet, creare immagini, fare calcoli, pianificare percorsi o registrare informazioni.

La pagina si apre su MCP. Seguono poi le schede dei provider dalle impostazioni del modello. Se un provider è disattivato lì, la relativa scheda degli strumenti non viene mostrata.

Impostare gli strumenti

App organizzativa Microsoft e azioni di scrittura​

Volete offrire Microsoft 365 tramite la vostra app organizzativa? Seguite Configurare Microsoft 365. Lì sono indicati l’app Entra necessaria, i permessi Graph, il consenso organizzativo, l’Identity Provider e gli URL di reindirizzamento per AI-School, AI-Corporate e AI-Public.

In MCP → Collegamenti rapidi della suite → Microsoft 365 rendete disponibili le integrazioni. Se la suite è disattivata, le righe sottostanti sono nascoste. Nella colonna Azioni di scrittura scegliete per ogni integrazione Bozze, Inviare, Scrivere o Pubblicare; solo le azioni autorizzate possono essere eseguite. Cliccate su Salva. Gli utenti attivano o disattivano solo le integrazioni disponibili nelle Preferenze.

Struttura della pagina​

La pagina è suddivisa in schede per provider, più una scheda MCP separata:

SchedaSignificato
MCPGestione delle suite e dei server MCP per l’ambiente
OpenAIImpostazioni degli strumenti per i modelli OpenAI
ClaudeImpostazioni degli strumenti per i modelli Claude
Google (Gemini)Impostazioni degli strumenti per i modelli Gemini
AI europeaImpostazioni degli strumenti per modelli europei come Mistral

Per ogni scheda, a seconda del provider, si gestiscono:

  1. Strumenti nativi (strumenti del provider integrati)
  2. Strumenti universali (strumenti di AI-School)

Nella scheda MCP si gestiscono i server MCP a livello di ambiente. Questi sono separati dalle impostazioni degli strumenti specifiche del provider.

La spiegazione di uno strumento individuale si trova nel pulsante informazioni accanto al nome dello strumento. In questo modo la pagina resta compatta, mentre gli amministratori possono comunque vedere un contesto aggiuntivo per ogni strumento.

Connettori Google e Microsoft​

In MCP → Collegamenti rapidi della suite si rende disponibile o non disponibile Google Workspace e Microsoft 365 come gruppo. In questo modo si gestiscono i collegamenti AI-School indipendenti dal provider per l’ambiente; un amministratore qui non accede per conto di tutti gli utenti.

Gli utenti attivano personalmente i connettori disponibili tramite Preferenze → Strumenti e concedono lì l’autorizzazione una sola volta. I loro token vengono salvati lato server e restano utilizzabili in nuove chat e su altri dispositivi.

Esempi di connettori MCP disponibili:

  • Google Calendar
  • Gmail
  • Google Drive
  • Microsoft Teams
  • Outlook Calendar
  • Outlook Mail
Indipendente dal provider

Gli strumenti Google e Microsoft sono eseguiti da AI-School e non sono collegati a OpenAI. Gli utenti possono usarli con OpenAI, Claude, Gemini e Mistral, purché il modello scelto supporti l’uso degli strumenti.

Google Calendar, Gmail e Google Drive: app Google propria​

Google Calendar, Gmail e Google Drive richiedono permessi di lettura che Google considera sensibili o restricted. Questi sono disponibili solo tramite un’app Google interna della vostra organizzazione. Senza un’app propria, risultano grigi e la suite Google Workspace in MCP → Collegamenti rapidi della suite non è disponibile. L’accesso con Google e il salvataggio di file nel Google Drive personale di un utente funzionano comunque tramite l’app centrale di AI-School.

Un’app interna (tipo utente Interno) non deve essere verificata da Google e non richiede una security assessment. Solo gli account all’interno del vostro Google Workspace possono accedervi e collegarla. Funziona come la propria app Entra per Microsoft:

  1. In Google Cloud, in un progetto della vostra organizzazione, create una schermata di consenso OAuth con tipo utente Interno. Aggiungete gli scope openid, email, profile, calendar.events.readonly, drive.file, drive.readonly e gmail.readonly e attivate le API Gmail, Google Drive API, Google Calendar API e Google Picker API.
  2. Create un client OAuth di tipo Applicazione web con questi due URI di reindirizzamento autorizzati:
    • https://ai-school-pro.firebaseapp.com/__/auth/handler (accesso con Google)
    • https://europe-west1-ai-school-pro.cloudfunctions.net/completeConnectorOAuth (collegamenti)
  3. Fornite l’ID client e il segreto client tramite il canale protetto concordato. L’amministratore della piattaforma li imposta sul provider Google del tenant del vostro ambiente in Google Cloud Identity Platform, attiva in Admin → Ambiente → Tenant il metodo di accesso Google e compila il dominio Google Workspace, ad esempio school.nl.
  4. A quel punto potete attivare Google Calendar, Gmail e Google Drive. Gli utenti con un collegamento Google precedente ricollegano il proprio account Google una sola volta.

Da quel momento in poi anche l’accesso con Google utilizza l’app propria e mostra solo gli account del dominio configurato.

Attività: Microsoft To Do e Google Tasks​

Nell’elenco delle integrazioni compaiono anche Microsoft To Do e Google Tasks. Questi non sono strumenti AI: fanno sincronizzare in due direzioni le Le mie attività degli utenti con un elenco in quel servizio. Attivate il servizio con l’interruttore nella riga; poi gli utenti effettuano il collegamento da soli, in Knowledge base → Attività o sotto Preferenze → Integrazioni. Per utente può essere attivo un solo servizio alla volta.

  • Microsoft To Do richiede il permesso Graph delegato Tasks.ReadWrite nella vostra app Entra (vedi Configurare Microsoft 365) e un account Microsoft con una cassetta postale di Exchange Online. Senza cassetta postale l’app segnala che non è possibile creare un elenco attività. Durante il collegamento Microsoft richiede solo il nuovo permesso; i permessi concessi in precedenza per ad esempio e-mail o file non vengono richiesti di nuovo.
  • Google Tasks funziona solo con l’app Google propria della vostra organizzazione, come descritto sopra. Senza quell’app la riga è grigia con il messaggio che è necessaria un’app Google propria. Nel consenso aggiungete lo scope https://www.googleapis.com/auth/tasks e attivate la Google Tasks API. Gli utenti ricollegano poi Google una sola volta.

Per gli utenti la spiegazione si trova in Attività.

Server MCP dell’ambiente​

Nella scheda MCP potete aprire prima, tramite Aggiungi server MCP, un negozio con preset adatti. La web app mostra solo i server che possono funzionare tramite una connessione pubblica Streamable HTTP. Tramite Aggiungi un server MCP manualmente aprite il modulo manuale.

Usate l’endpoint HTTPS completo, incluso il percorso MCP come /mcp. Il backend verifica DNS, indirizzi privati, redirect e handshake MCP. Dopo la registrazione, le chat usano solo un connectorId; endpoint e secret non sono nella configurazione della chat.

Un server MCP configurato qui appare nella dashboard sotto Strumenti per gli utenti che possono vedere i collegamenti MCP. Questi vedono questi server dell’ambiente accanto ai propri server MCP personali e possono avviare direttamente una chat con essi.

Gli utenti non possono modificare o eliminare da soli i server dell’ambiente. Possono però attivare o disattivare personalmente un server disponibile. La gestione avviene centralmente tramite Ambiente di amministrazione → Impostazioni AI → Strumenti → MCP.

In qualità di amministratore potete modificare, attivare o disattivare ed eliminare un server configurato in questo elenco. Gli utenti che avevano attivato il server lo mantengono attivo. Se modificate l’endpoint o il metodo di autenticazione, reinserite il secret e gli utenti effettueranno nuovamente l’accesso con OAuth. Un server disattivato non è più disponibile per gli utenti.

Accesso ai collegamenti MCP

I server dell’ambiente sono visibili solo agli utenti che hanno accesso ai collegamenti MCP. Questo accesso è determinato dai limiti dell’ambiente e da eventuali impostazioni individuali per dipendenti o studenti.

Strumenti nativi​

Gli strumenti nativi sono strumenti integrati del provider stesso. Non vengono eseguiti da AI-School, ma offerti dal provider insieme al modello.

StrumentoProviderDescrizione
OpenAI Web SearchOpenAICerca informazioni aggiornate tramite la funzione di ricerca web integrata di OpenAI
OpenAI Code InterpreterOpenAIEsegue codice Python per analisi dei dati, calcoli e visualizzazioni
Claude Web SearchClaudeCerca informazioni aggiornate tramite la funzione di ricerca integrata di Claude
Claude Web FetchClaudeRecupera contenuti da pagine web e documenti PDF
Claude Code ExecutionClaudeEsegue codice Bash e Python in una sandbox protetta
Gemini Google SearchGoogleCerca informazioni aggiornate tramite la ricerca Google integrata di Gemini
Gemini Code ExecutionGoogleEsegue codice per calcoli e analisi dei dati
Gemini URL ContextGoogleRecupera contenuti da URL per contesto aggiuntivo
Gemini Google MapsGoogleUsa Google Maps per informazioni sulle località, percorsi e luoghi

Gemini 3 e i modelli più recenti possono combinare strumenti Google nativi adatti con strumenti universali e collegamenti Google o Microsoft di AI-School. Nei modelli Gemini più datati, gli strumenti universali in un contesto con strumenti nativi attivi vengono disattivati per evitare combinazioni di strumenti incompatibili.

Gli strumenti di esecuzione del codice, come OpenAI Code Interpreter, Claude Code Execution e Gemini Code Execution, sono disattivati per impostazione predefinita. Attivateli consapevolmente quando sono necessari esecuzione di codice, calcoli, analisi dei dati o modifica di file.

Strumenti universali​

Gli strumenti universali sono disponibili presso i provider per cui sono tecnicamente adatti e vengono offerti da AI-School stessa. Per ogni provider scegliete per ogni strumento cosa deve accadere.

StrumentoDescrizione
Creare immagineGenera immagini sulla base di una descrizione testuale
Creare domande di esercitazioneCrea automaticamente quiz o domande di esercizio su un testo o un argomento
Cercare su internetCerca informazioni aggiornate su internet
Cercare immaginiCerca immagini su internet in base a un termine di ricerca
Richiedere il meteoRichiede le previsioni meteo attuali per una località
Controllare contenuti AIAnalizza se un testo può essere stato generato dall’AI
Cercare su WikipediaCerca informazioni enciclopediche su Wikipedia
Google RoutesPianifica percorsi e calcola tempi di viaggio
Google PlacesCerca informazioni su luoghi e aziende
Wolfram AlphaEsegue calcoli complessi e analisi scientifiche
Lezioni WikiwijsCerca su Wikiwijs materiali didattici
Obiettivi di apprendimento SLOCerca il curriculum olandese di SLO: obiettivi fondamentali, traguardi finali, livelli di riferimento, QCER e mappe degli obiettivi di apprendimento
RegistrazioneSalva informazioni importanti come nota modificabile nella chat
Strumenti automatici nascosti

Alcuni strumenti interni, come chat_history_search, non compaiono in questa panoramica. Sono disponibili automaticamente per l’assistente e seguono lo stesso ambiente, gli stessi diritti utente e lo stesso periodo di conservazione. Gli amministratori non possono gestirli separatamente tramite le impostazioni degli strumenti.

Impostazione per strumento​

Per ogni strumento scegliete tra quattro valori:

ImpostazioneSignificato
AutomaticoL’AI decide da sola se lo strumento è utile per la domanda
AttivoLo strumento è sempre abilitato nel contesto corrispondente
DisattivatoLo strumento è disabilitato e non può essere usato
Non visibileLo strumento scompare completamente dall’interfaccia utente e dalle preferenze personali

L’impostazione Automatico è nella maggior parte dei casi la scelta consigliata. Scegliete Attivo solo quando uno strumento è quasi sempre necessario in quel contesto.

Gli utenti nelle loro preferenze possono impostare solo eccezioni personali per gli strumenti visibili. Non possono sovrascrivere l’impostazione dell’ambiente per gli strumenti impostati su Non visibile.

Ripristino e salvataggio​

Tramite Ripristina valori predefiniti riportate le impostazioni degli strumenti di un provider alle impostazioni predefinite di AI-School. Le modifiche vengono salvate con il pulsante Salva nella barra degli strumenti dell’app.

Vedi anche​