Notion

Collega Notion con un solo accesso, poi lascia che il tuo agente cerchi, legga e scriva pagine e database, ma solo le pagine che condividi con l'integrazione.

Collega il tuo spazio di lavoro Notion con un unico accesso OAuth e il tuo agente ottiene otto strumenti: quattro strumenti di lettura per cercare, aprire e leggere pagine e database, e quattro strumenti di scrittura per creare pagine, aggiungere contenuti, aggiornare campi e commentare. L'unica regola da ricordare: l'agente vede sempre e solo le pagine e i database che condividi con l'integrazione in modo esplicito durante l'accesso.

Collega

Apri Integrazioni e scegli Notion.
Completa l'accesso a Notion. Nella schermata di consenso di Notion, seleziona le pagine e i database a cui vuoi che l'agente acceda, è questo il passaggio che concede l'accesso.
Sei collegato. Non c'è alcun selettore di ambito sul lato AnyBot; la selezione delle pagine avviene interamente sulla schermata di Notion.

Il trucco da conoscere: le integrazioni Notion negano l'accesso per impostazione predefinita. Tutto ciò che non hai spuntato durante l'accesso è invisibile all'agente, una ricerca semplicemente non restituirà nulla. Per aggiungere una pagina o un database in un secondo momento, aprilo in Notion, usa il menu ... → Connections → aggiungi AnyBot. Condividere una pagina principale ne condivide anche le sotto-pagine.

Cosa può fare l'agente

Strumento	Accesso	Tipo	Cosa fa
`notion_search`	Pubblico sicuro	Read	Cerca per titolo tra le pagine e i database condivisi e restituisce i loro id per gli altri strumenti.
`notion_get_page`	Pubblico sicuro	Read	Legge le proprietà di una pagina (titolo, campi) tramite id, solo i metadati, non il corpo.
`notion_get_block_children`	Pubblico sicuro	Read	Legge il contenuto del corpo di una pagina come un elenco piatto di blocchi in testo semplice; i blocchi annidati possono essere letti più in profondità.
`notion_query_data_source`	Pubblico sicuro	Read	Interroga le righe di un database con filtro e ordinamenti facoltativi, per origine dati o id del database.
`notion_create_page`	Solo proprietario	Write	Crea una pagina sotto una pagina principale o come riga di un database, facoltativamente con contenuto.
`notion_append_blocks`	Solo proprietario	Write	Aggiunge blocchi di contenuto (paragrafi, intestazioni, elenchi, cose da fare, citazioni, codice) a una pagina.
`notion_update_page`	Solo proprietario	Write	Aggiorna il titolo, le proprietà o lo stato di archiviazione di una pagina.
`notion_create_comment`	Solo proprietario	Write	Aggiunge un commento a una pagina o risponde a un thread di discussione.

Public-safe vs owner-only

I quattro strumenti di lettura sono public-safe: un agente rivolto ai visitatori del sito web può rispondere attingendo alla tua conoscenza in Notion, e i corpi delle pagine sensibili vengono oscurati dal flusso di strumenti in tempo reale. I quattro strumenti di scrittura sono owner-only, un visitatore del sito web non può mai creare, modificare o commentare. Preferisci mantenere un bot pubblico in sola lettura? Attiva l'impostazione Read-only (sola lettura) sull'integrazione e gli strumenti di scrittura scompaiono del tutto.

Esempio pratico

Tieni una pagina "Politica di reso" in Notion e la condividi con l'integrazione. Un cliente chiede al tuo bot di supporto: "Quanto tempo ho per restituire un articolo?" L'agente esegue notion_search per trovare la pagina, notion_get_block_children per leggerla, e risponde attingendo al testo effettivo della politica, nessun copia-incolla, e la risposta si aggiorna da sola nel momento in cui modifichi la pagina.

Limiti e onestà

Accesso negato per impostazione predefinita. Nulla è visibile finché non lo condividi nella schermata di consenso o tramite il menu ... → Connections.
I database seguono prima lo schema. Per notion_query_data_source, i nomi delle proprietà di filtro e ordinamento devono corrispondere esattamente al database, esegui una query una volta senza filtro per scoprire i nomi reali.
Scritture solo sui contenuti. Gli strumenti di scrittura modificano i corpi e le proprietà delle pagine; non gestiscono i membri dello spazio di lavoro, le autorizzazioni o la fatturazione.

Risoluzione dei problemi

La ricerca non restituisce nulla, la pagina non è condivisa. Aggiungi AnyBot tramite il menu ... → Connections della pagina.
"Connection is no longer valid", il token OAuth è scaduto o è stato revocato in Notion. Ricollega da Integrazioni.
L'agente non scrive, l'integrazione è in modalità Read-only, oppure lo strumento è owner-only e a chiedere è un visitatore. Entrambi i casi sono voluti.

FAQ

Devo condividere ogni pagina singolarmente? No, condividi una pagina principale e le sue sotto-pagine sono incluse.

Un visitatore del sito web può modificare il mio Notion? Mai. Tutti e quattro gli strumenti di scrittura sono owner-only.

Dove finiscono le nuove pagine? Nel database o nella pagina principale che indichi, oppure nel Default Database / Parent Page (Database / Pagina principale predefiniti) che imposti sull'integrazione.

Avanti

Google Workspace, Drive, Docs, Calendar e Gmail
Strumenti API personalizzati, collega qualsiasi altra cosa
Abilità dell'agente, come gli strumenti si collegano a un agente
Panoramica delle integrazioni

In questa pagina