Agenti personalizzati

Come creare un agente personalizzato
In questo articolo

Grazie agli agenti personalizzati, puoi creare workflow condivisi che automatizzano le attività ricorrenti del team, eseguendole esattamente come servono, dietro le quinte 🤖

Vai alle Domande frequenti

Gli agenti personalizzati automatizzano i workflow ricorrenti e manuali per tutto il team. Operano automaticamente in background in base a trigger predefiniti, utilizzando i tuoi documenti e i tuoi database esistenti come contesto.

Configurali una volta sola, creando un workflow per attività ripetitive come i report settimanali o la classificazione del feedback: diventa così una risorsa condivisa su cui tutto il team può fare affidamento.

Cosa sono gli agenti personalizzati?

Gli agenti personalizzati operano all'interno di Notion e funzionano in base alle tue istruzioni. Una volta configurati, possono:

  • Leggere le pagine e i database di Notion e alcune app collegate.

  • Funzionare in base a trigger ricorrenti e agli eventi dello spazio di lavoro.

  • Eseguire azioni come pubblicare report, segnalare bug, aggiornare record o inviare messaggi.

A differenza dell'agente di Notion, gli agenti personalizzati sono progettati per operare automaticamente in background in base a trigger e programmazioni.

Usa i tuoi documenti e i tuoi database esistenti come contesto

Gli agenti personalizzati sono integrati direttamente in Notion. Gli agenti utilizzano i tuoi documenti e i tuoi database esistenti come contesto e si connettono a Slack, aumentando la produttività. Grazie agli agenti personalizzati, puoi:

  • @menzionare Agenti nelle pagine Notion, nelle proprietà del database e nei commenti.

  • Collegarli a eventi del database (ad esempio, quando viene creata o aggiornata una pagina).

  • Consentire loro di monitorare il tuo spazio di lavoro e gli strumenti connessi in base ai trigger che configuri.

Automatizzare il lavoro ricorrente con i trigger

Usare i trigger per far sì che gli agenti personalizzati vengano eseguiti senza che tu debba avviarli manualmente ogni volta. Impostare un trigger una volta sola, poi il lavoro proseguirà ininterrottamente in background.

  • Eseguire in base a una programmazione (giornaliera, settimanale, mensile e altro).

  • Reagire agli eventi su Notion e Slack.

  • Continuare a funzionare in background una volta che li pubblichi.

Ciò consente di attivare workflow automatizzati, come report periodici, code di smistamento e gestione delle conoscenze, aiutandoti a recuperare tempo.

Sicuri e trasparenti per design

Gli agenti agiscono solo sulle pagine, sui database e sulle app esterne a cui concedi esplicitamente l'accesso. Per impostazione predefinita, non hanno mai accesso completo allo spazio di lavoro, il che riduce i rischi.

  • Controlla chi può modificare, eseguire o interagire con ciascun agente.

  • Visualizza i log delle attività per scoprire cosa ha fatto un agente e quando.

  • Utilizza la cronologia delle versioni per esaminare o ripristinare le configurazioni precedenti.

  • Mantieni le esecuzioni verificabili e reversibili, in modo da poter iterare in sicurezza.

  • Devi avere un piano Business o Enterprise di Notion. Scopri di più sui prezzi degli agenti personalizzati.

  • Usa l'app desktop o web per creare, modificare, visualizzare o interagire con gli agenti personalizzati.

Puoi creare un agente personalizzato da più posizioni. Il punto di accesso principale è la sezione Agenti nella barra laterale.

  1. Vai alla sezione Agenti nella barra laterale e seleziona + per creare un nuovo agente personalizzato.

2. Scegli come vuoi iniziare:

  • Crea con la chat AI

    • Nella chat, descrivi ciò che vuoi che l'agente faccia, usando un linguaggio naturale.

    • Rivedi le istruzioni, i trigger e gli accessi generati da Notion AI e itera.

    • Salva.

  • Crea a partire da un modello

    • Scegli un modello.

    • Rivedi le istruzioni, i trigger e gli accessi generati da Notion AI e itera.

    • Salva.

  • Crea da zero

    • Seleziona Crea da zero.

    • Inizia da un campo delle istruzioni vuoto o avvia una chat con Notion AI.

    • Crea le tue istruzioni manualmente, seguendo le best practice per istruzioni chiare e concrete. Definisci cosa deve fare l'agente, come deve comportarsi e quali attività deve svolgere.

    • Imposta i trigger, l'accesso e il tuo modello AI finché non sono in linea con il tuo workflow.

    • Salva.

Per creare istruzioni chiare per il tuo agente, inizia indicando l'attività e il risultato che desideri ottenere. Successivamente, aggiungi passaggi, input e output concreti. Se hai esempi, utilizzali.

Suggerimento: utilizza i nostri modelli di agente personalizzato come punto di partenza.

I trigger determinano quando viene eseguito il tuo agente. Puoi combinare più tipi di trigger per un singolo agente. Puoi anche utilizzare i filtri per fare in modo che il tuo agente venga eseguito solo per le pagine o i messaggi che ti interessano, oppure solo quando vengono soddisfatte determinate condizioni da te impostate (ad esempio, uno stato specifico o una parola chiave).

Automatizza i workflow con programmazioni ricorrenti basate sul tempo

Usa le programmazioni ricorrenti per eseguire gli agenti con una determinata frequenza.

  1. Apri le impostazioni del tuo agente personalizzato.

  2. Vai alla sezione Trigger.

  3. Aggiungi un Trigger ricorrente.

  4. Scegli quando vuoi che l'agente venga eseguito:

    • Seleziona una frequenza (ogni giorno, settimana, mese o anno).

    • Imposta un'ora specifica, incluso il fuso orario (ad esempio, "ogni giorno a mezzanotte PST").

  5. Controlla il prossimo orario di esecuzione programmato per verificare che la programmazione sia corretta.

  6. Salva il tuo trigger.

Usa i trigger di Notion

I trigger di Notion eseguono il tuo agente in base agli eventi che si verificano nel tuo spazio di lavoro. Puoi attivare gli agenti quando:

  • Viene aggiunto un commento a una pagina.

  • Viene aggiunta una pagina a un database.

  • Viene aggiornata una proprietà in un database.

  • Viene rimossa una pagina da un database.

Alcuni trigger di Notion ti consentono di aggiungere filtri, ad esempio per trovare corrispondenze con valori di proprietà specifici o per limitare le esecuzioni alle pagine di una determinata vista del database.

Per aggiungere un trigger di Notion:

  1. Apri le impostazioni del tuo agente personalizzato e seleziona Trigger.

  2. Scegli un tipo di trigger di Notion.

  3. Specifica:

    • La pagina o il database da monitorare.

    • L'evento (ad esempio, "pagina creata nel database").

    • Filtri o condizioni opzionali (ad esempio, un valore di stato specifico o una vista del database).

  4. Salva.

Usa i trigger di Slack

I trigger di Slack consentono agli agenti di monitorare gli eventi sia nei canali Slack pubblici che in quelli privati.

Requisiti di configurazione

Prima di poter configurare un trigger di Slack, un amministratore dello spazio di lavoro di Slack deve innanzitutto collegare Slack per gli agenti personalizzati. In questo modo, gli agenti personalizzati dispongono dei permessi di lettura e scrittura obbligatori per operare su Slack. Una volta abilitata l'integrazione, puoi configurare i trigger in base ai nuovi messaggi o alle reazioni con emoji.

Gli agenti possono monitorare:

  • Un messaggio pubblicato in un canale.

  • Una reazione con emoji aggiunta a un messaggio.

  • Una conversazione avviata in un canale.

  • L'agente personalizzato menzionato in un messaggio.

    • Nota: Per attivare un agente menzionandolo su Slack, l'amministratore dello spazio di lavoro di Slack deve innanzitutto consentire a tutti i membri di creare gruppi di utenti. Una volta abilitata questa impostazione, chiunque può attivare l'agente menzionandone il nome nel canale Slack associato.

Puoi aggiungere dei filtri per ridurre gli eventi indesiderati all'interno dei canali ad alto traffico, ad esempio limitando i trigger a canali specifici o a determinati tipo di eventi.

Come aggiungere un trigger di Slack:

  1. Se non l'hai ancora fatto, collega Slack al tuo agente durante la configurazione.

  2. Nella sezione Trigger, aggiungi un trigger di Slack .

  3. Seleziona:

    • Il tipo di evento.

    • Il canale da monitorare.

    • I filtri opzionali (trigger che si attivano solo quando un messaggio contiene una determinata parola chiave o una frase specifica).

  4. Salva.

Ogni volta che un agente personalizzato viene attivato su Slack, può mostrare un indicatore di digitazione ("Ci sto lavorando…") per segnalare che sta elaborando la richiesta. Ciò non significa necessariamente che l'agente risponderà. Puoi disattivare questa funzione in qualsiasi momento dalle impostazioni del trigger.

Come disattivare l'indicatore di digitazione:

  1. Apri il tuo agente personalizzato.

  2. Nella sezione Trigger, seleziona il trigger di Slack.

  3. Seleziona Altre impostazioni, quindi deseleziona Mostra l'indicatore di digitazione su Slack.

Nota:

  • Se desideri @menzionare un agente personalizzato con il suo nome su Slack, il proprietario dello spazio di lavoro su Slack deve consentire ai membri di creare gruppi di utenti. Si tratta di un requisito di Slack (non un'impostazione di Notion).

  • I messaggi salvati o contrassegnati “Per dopo” su Slack non sono supportati.

Per svolgere il loro lavoro, gli agenti personalizzati utilizzano solo i contenuti a cui concedi esplicitamente l'accesso. Puoi configurare questa opzione nelle impostazioni di accesso di ciascun agente.

Concedi a un agente personalizzato l'accesso ai contenuti del tuo spazio di lavoro

Per decidere cosa può vedere un agente in Notion:

  1. Apri le Impostazioni del tuo agente personalizzato.

  2. Vai alla sezione Strumenti e accesso.

  3. Aggiungi pagine o database specifici che l'agente deve utilizzare come fonti di riferimento:

    • Aggiungi pagine e database mirati per flussi di lavoro specifici (ad esempio, "Ticket dei clienti", "Bug", "Incidenti").

    • Concedi l'accesso alle pagine condivise con tutti i membri di Notion se desideri offrire un'ampia copertura rispetto ai contenuti disponibili all'interno dello spazio di lavoro.

  4. Mantieni l'accesso limitato a "nessuna" o a un piccolo insieme di pagine se desideri un ambito più ristretto.

Se inserisci un link a pagine Notion nelle tue istruzioni, queste non verranno aggiunte agli strumenti e all'accesso collegati.

Consenti o blocca l'accesso web

Gli agenti possono scegliere di navigare su Internet in caso di necessità. Utilizza l'accesso web quando il tuo flusso di lavoro dipende da informazioni esterne. Disattivalo nel caso dei flussi di lavoro strettamente interni o quando vuoi mantenere un controllo più rigoroso sulle fonti. Come controllare l'accesso web:

  1. Apri le Impostazioni dell'agente.

  2. Individua il pulsante Accesso web.

  3. Attivalo per consentire all'agente di recuperare informazioni da Internet.

  4. Disattivalo per limitare l'accesso dell'agente esclusivamente a Notion e alle app configurate.

Concedi agli agenti personalizzati l'accesso a Slack

Gli agenti personalizzati possono leggere e scrivere su Slack tramite un'integrazione dedicata. Prima di collegare Slack al tuo agente personalizzato, un amministratore deve innanzitutto collegare la connessione AI di Slack al tuo spazio di lavoro tramite le impostazioni di Notion AI. Gli agenti possono eseguire le seguenti operazioni:

  • Leggere determinati canali pubblici e privati.

  • Pubblicare messaggi, risposte e aggiornamenti solo nei canali specifici che selezioni.

  • Interagisci nelle conversazioni e usa le informazioni provenienti da Slack come fonte di riferimento.

Slack Enterprise Grid non è supportato.

Come collegare Slack:

  1. Durante la configurazione dell'agente, segui le istruzioni per collegare Slack.

  2. Assicurati che l'account Slack utilizzi lo stesso indirizzo email di quello Notion.

  3. Approva gli ambiti richiesti nel flusso di autorizzazione di Slack.

  4. Scegli a quali canali può accedere l'agente.

Gli agenti personalizzati possono operare utilizzando diversi modelli linguistici di grandi dimensioni. Ciò ti consente di trovare un equilibrio tra velocità, costi e qualità. Puoi modificare il modello nel tempo se il tuo flusso di lavoro o le tue esigenze in termini di prestazioni subiscono dei cambiamenti. I modelli supportati includono Claude, GPT e Gemini. "Automatico" è l'impostazione predefinita consigliata.

Scopri come viene monitorato l'utilizzo dashboard dei crediti Notion.

Come scegliere un modello:

  1. Apri le Impostazioni del tuo agente.

  2. Vai alla sezione Modello.

  3. Seleziona un modello specifico se preferisci un comportamento coerente oppure seleziona Automatico per consentire a Notion di scegliere il modello migliore per ciascuna richiesta.

  4. Salva.

Per quanto riguarda la condivisione con altri utenti nel tuo spazio di lavoro, gli agenti personalizzati si comportano come le pagine di Notion, con alcune differenze.

Condividi gli agenti con il tuo team

Quando vengono condivisi, gli agenti possono essere visualizzati nella barra laterale, nella sezione Agenti, nei risultati di ricerca e in qualsiasi area dello spazio di lavoro che elenchi o faccia riferimento agli agenti.

Come condividere un agente:

  1. Apri l'agente personalizzato.

  2. Clicca su Condividi.

  3. Aggiungi persone, gruppi o l'intero spazio di lavoro.

Livelli di permesso

Gli agenti utilizzano un insieme semplificato di livelli di permesso:

  • Accesso completoGli utenti con il permesso Accesso completo a un agente possono configurare istruzioni, trigger, accesso e modelli, visualizzare e gestire i registri delle attività ed eseguire l'agente o interagire con esso.

  • Può modificareGli utenti con il permesso Può modificare valido per un agente possono modificare le istruzioni e la configurazione ed esaminare le attività.

  • Può visualizzare e interagireGli utenti con il permesso Può visualizzare e interagire valido per un agente possonoeseguire l'agente, chattare con lui e visualizzare la pagina Impostazioni (Trigger, Istruzioni, Strumenti e Accesso) in modalità di sola lettura. Non possono modificare né condividere l'agente.

Gli utenti senza accesso possono comunque attivare gli agenti configurati o interagire con essi per rispondere a eventi come i messaggi Slack nei canali accessibili.

Una volta creato, l'agente personalizzato comparirà nella barra laterale. Ogni pagina dell'agente personalizzato include tre schede principali. Utilizza queste schede congiuntamente per progettare, testare e gestire un agente nel tempo.

  1. Chat Un'area di conversazione diretta, privata o condivisa, per quell'agente specifico.

    • Utile per testare nuove istruzioni, chiedere all'agente di eseguire attività occasionali e iterare sul suo comportamento.

  2. Attività Un registro di ogni esecuzione dell'agente, visibile per gli utenti con Accesso completo.

    • I registri includono le informazioni su ciò che ha attivato l'esecuzione, le azioni intraprese e gli eventuali errori o malfunzionamenti.

  3. Impostazioni Il centro di controllo dell'agente.

    • Il pannello Impostazioni comprende le istruzioniper l'agente, i trigger, i permessi di accesso e la selezione del modello.

Considera la configurazione come una conversazione. Utilizza la chat con l'agente personalizzato per eseguire test e debug e iterare le tue istruzioni. Chiedi all'agente di eseguire attività occasionali, fornire il contesto degli errori e testare scenari diversi.

Usa la scheda Impostazioni per modificare un agente

  1. Apri la pagina dell'agente.

  2. Vai alla scheda Impostazioni.

  3. Aggiorna le istruzioni, i trigger, l'accesso a pagine, database e strumenti esterni o la selezione del modello.

  4. Salva e pubblica le modifiche.

  5. Usa le schede Chat e Attività per verificare che il comportamento dell'agente sia quello previsto una volta apportate le modifiche.

Annulla una modifica con la cronologia delle versioni

Per ripristinare una versione precedente del tuo agente personalizzato:

  1. Apri la pagina dell'agente.

  2. Accedi alla Cronologia delle versioni.

  3. Controlla le versioni precedenti per scoprire:

    • Chi ha apportato le modifiche.

    • Quando sono state apportate le modifiche.

    • Cosa è stato modificato in ciascuna versione.

  4. Seleziona la versione che desideri ripristinare.

  5. Conferma il ripristino dell'agente a quella versione.


Domande frequenti

How is this different from Notion Agent in the bottom right corner?

Notion Agent helps you:

  • Draft, edit, and summarize content.

  • Answer questions about pages and databases.

  • Perform one-off tasks while you work.

Custom Agents:

  • They follow precise instructions you define.

  • They can run autonomously in the background via triggers and schedules.

  • They operate only on the pages, databases, and external tools you explicitly grant.

Notion Agent is on-demand, whereas Custom Agents are autonomous.

If a run fails, how can I debug it?

To debug a run:

  1. Open the agent page.

  2. Go to the Activity tab in the agent's Settings or from the agent chat view.

  3. Find the failing run in the list.

  4. Open it to see:

    • What triggered the run.

    • What the agent "thought" and did at each step.

    • Any error messages or explanations.

If the agent behaved incorrectly:

  • Adjust its instructions or triggers.

  • Re-run with updated configuration.

  • If something looks wrong or suspicious, provide a thumbs-down and a detailed description where available so the team can improve the system.

What Slack app do I need to connect?

To use Slack with Custom Agents:

  1. Make sure Slack is connected with the same email address you use for Notion.

  2. When prompted during agent setup, connect the Slack app even if you already use Slack elsewhere in Notion.

  3. Approve access and configure which channels the agent can read or write to.

The Agent showed "Working on it..." in Slack, but never replied. Why?

The “Working on it…” typing indicator appears as soon as a Custom Agent is triggered. Sometime the Agent will decide not to reply (based on instructions), or may time out before it can send a message. If this happens, the typing indicator will disappear automatically.

If you want to avoid this, you can always turn off the typing indicator in the Slack trigger’s settings, or update the agent’s instructions so it’s more likely to respond to the situations you care about.

Who can create and see Custom Agents?

  • Custom Agents are available to everyone in the workspace by default.

    • Enterprise plan Admins can restrict access by going to Settings > Notion AI >

      Agents > Control who can create agents.

  • For each agent:

    • The creator decides who can access it and at what level (Full access, Can edit, Can interact).

    • In Slack, anyone in a channel can see messages posted by that channel's agents.

    • Anyone with access to the agent can see its outputs, even if they don’t have access to the underlying Slack private channel.

Learn more about Custom Agent sharing & permissions here →

How will I know where this agent is going to run?

While configuring an agent, check:

  1. Triggers to see:

    • Which schedules are active.

    • Which Notion databases or pages are watched.

    • Which Slack channels or other apps are connected.

  2. Access / Permissions to see:

    • Which pages, databases, and external sources the agent can use.

  3. Activity to see:

    • Where the agent has already run and what it did.

After you publish:

  • Use the Activity tab and logs to confirm agents are running only where expected.

  • Review runs regularly to keep behavior aligned with your workflows.

Hai ancora dubbi? Invia un messaggio all'assistenza

Lascia un feedback

Ti è stata utile questa risorsa?