Notion Custom Agents: scrivi il brief di contesto prima di automatizzare il compito
Notion Custom Agents possono leggere più contesto, usare integrazioni e consumare crediti in base al lavoro svolto. Un brief breve aiuta a evitare esecuzioni vaghe, costose o rischiose.
8 maggio 2026
Notion Custom Agents stanno diventando più capaci. Notion dice che possono usare più contesto del workspace, lavorare con integrazioni, usare skills, alimentare AI Autofill e consumare crediti in base a ciò che leggono, alla frequenza di esecuzione, al modello usato e alle azioni svolte.
Highlight Reel
Salva il brief agente che il team può riusare
Trasforma istruzioni IA, fonti e decisioni di task in contesto pulito prima di un'altra esecuzione dell'agente.
Questo rende il prompt più simile a un brief di task che a un messaggio di chat.
Prima di automatizzare un compito con un Notion Custom Agent, scrivi il brief di contesto.
In breve
Un buon brief per Notion Custom Agents deve rispondere a cinque domande:
- Che cosa deve fare l'agente?
- Quali fonti deve usare?
- Che cosa deve ignorare?
- Quale formato di output deve produrre?
- Che cosa richiede revisione umana prima di fidarsi del risultato?
L'obiettivo non è un prompt più lungo. L'obiettivo è un lavoro più chiaro.
Perché il costo del contesto conta
La documentazione Notion sui prezzi dei Custom Agents indica che gli agenti usano crediti in base al lavoro necessario per completare un'esecuzione. Più lettura, più ricerca, più azioni, esecuzioni più frequenti e modelli più avanzati possono aumentare l'uso dei crediti.
Questo dettaglio di prodotto è importante. Insegna anche una lezione operativa più ampia:
Il contesto disordinato non è gratis.Se un agente scansiona troppo contenuto del workspace, cerca nel database sbagliato o agisce su una richiesta vaga, non rischi solo una risposta peggiore. Puoi anche spendere crediti su lavoro mai definito bene.
La soluzione non è togliere contesto all'agente. La soluzione è dargli il contesto giusto.
Brief di contesto per Custom Agents
Usalo prima di creare o eseguire un Custom Agent.
# Brief di contesto per Custom Agent
## Compito
Che cosa deve fare l'agente?
## Fonti approvate
- Database:
- Pagina:
- Canale Slack:
- Note riunione:
## Ignorare
- Documenti non aggiornati:
- Conversazioni private:
- Bozze non pronte:
## Formato di output
- Sintesi:
- Tabella:
- Task:
- Nota decisionale:
## Revisione umana
- Chi revisiona:
- Che cosa controllare:
- Che cosa l'agente non deve pubblicare o cambiare:Il brief può vivere in Notion, in un documento di progetto o in una pagina Highlight Reel salvata. La parte importante è che sia riutilizzabile.
Che cosa salvare dopo l'esecuzione
Dopo un'esecuzione di Custom Agent, salva più della risposta finale.
| Salva questo | Perché conta |
|---|---|
| Compito | Il team deve sapere che cosa è stato chiesto all'agente. |
| Fonti | Il risultato dipende da ciò che l'agente ha letto. |
| Output | Risposta, task, aggiornamento o bozza. |
| Modifica umana | Differenza tra output agente e lavoro approvato. |
| Follow-up | La prossima esecuzione non deve riscoprire lo stesso contesto. |
Se l'agente crea task, aggiorna pagine, compila righe di database o riassume contesto Slack, conserva la traccia decisionale. Altrimenti il workspace sembra aggiornato ma il ragionamento sparisce.
Quando non eseguire ancora l'agente
Metti in pausa se:
- il database fonte è disordinato
- documenti vecchi contraddicono la policy attuale
- l'output sarà visibile ai clienti
- l'agente può toccare canali Slack privati
- nessuno è assegnato alla revisione
- il compito è troppo vago per stimare il perimetro
Non è contrario all'automazione. È il modo in cui l'automazione diventa ripetibile.
Che cosa cambia per il team
Un brief di contesto non serve solo a scrivere un prompt migliore. Serve a rendere il lavoro dell'agente verificabile anche dopo.
Senza brief, l'output può sembrare una pagina Notion ben aggiornata, ma il team non sa quali database, pagine, canali Slack o documenti vecchi siano stati usati. Con un brief, chi revisiona può controllare subito se l'agente è rimasto dentro il perimetro giusto.
Per attività ricorrenti, conviene stabilizzare questi elementi:
| Attività ricorrente | Che cosa tenere stabile nel brief |
|---|---|
| Preparare follow-up di riunione | note approvate, pubblico, formato di output |
| Riassumere righe di database | database, filtri, campi esclusi |
| Preparare stato progetto | pagine rilevanti, periodo, rischi aperti |
| Analizzare contesto Slack | canali ammessi, contenuti privati, review gate |
Così il brief diventa una cornice di lavoro riutilizzabile. L'agente può partire più velocemente, ma il team deve indovinare meno.
Dove entra Highlight Reel
Highlight Reel è utile quando il contesto di partenza arriva da conversazioni IA, riunioni o ricerche disordinate.
Prima dell'esecuzione dell'agente, salva una pagina di contesto pulita:
- sintesi decisionale
- link alle fonti
- assunzioni accettate
- strade scartate
- prossima azione
Dopo l'esecuzione, salva l'output utile e la decisione umana:
- cosa ha prodotto l'agente
- cosa è stato accettato o modificato
- cosa va riusato nella prossima esecuzione
Così un'esecuzione agente diventa un artefatto di lavoro duraturo, non solo un'altra riga nell'attività del workspace.
Domande frequenti
Vale solo per Notion?
No. Notion è il punto di partenza perché Custom Agents rende visibile il flusso. Lo stesso schema di brief di contesto vale per agenti Slack, agenti Microsoft, strumenti MCP e automazioni interne.
Il brief deve stare dentro Notion?
Può stare lì. Il brief dovrebbe vivere dove il team rivede naturalmente il lavoro. Se la fonte era una conversazione IA, una pagina Highlight Reel pulita può essere una consegna migliore della chat grezza.
Un brief migliore riduce i crediti Notion?
Può aiutare a evitare lavoro inutile, ma l'uso reale dei crediti dipende da configurazione, modello, azioni, frequenza e volume di contenuto. Trattalo come strumento di perimetro, non come garanzia di costo.
Qual è il brief minimo utile?
Compito, fonti approvate, fonti ignorate, formato di output e responsabile della revisione.