Esegui codice personalizzato con Workers (beta)

I Notion Workers fanno parte della nostra Developer Platform. Eseguono codice personalizzato sull'infrastruttura di Notion per alimentare:

• Sincronizzazione del database

• Strumenti per agenti personalizzati

• Trigger per webhook

• I Workers sono disponibili nei piani Business ed Enterprise.

• Per impostazione predefinita, i Workers sono attivati per lo spazio di lavoro (solo per i proprietari).

• I proprietari dello spazio di lavoro possono:

  • Limitare la creazione di Workers ai soli proprietari.

  • Consenti a membri o gruppi specifici di creare Workers.

  • Disattiva i Workers per lo spazio di lavoro.

• Se stai cercando di distribuire o gestire un Worker, in genere seguirai la nostra documentazione per sviluppatori e userai la Notion CLI.

• Puoi attivare la Modalità sviluppatore per visualizzare i Workers in Notion, leggere i log e disattivare o eliminare i Workers. Per distribuire un Worker o modificarne il codice o la configurazione, usa la Notion CLI o lo strumento di programmazione del tuo team. Scopri di più sulla modalità sviluppatore →

Per saperne di più sui prezzi dei Workers, consulta questo articolo.

La sincronizzazione del database (basata sui Workers) importa informazioni da strumenti esterni in un database Notion e le mantiene aggiornate automaticamente. Una volta configurato, il database sincronizzato si mantiene aggiornato da solo, così il tuo team e i tuoi agenti vedono sempre i dati più recenti senza che nessuno debba copiare o incollare tra gli strumenti.

Alcuni esempi comuni:

• Sincronizza i ticket di assistenza Zendesk in un database di triage.

• Sincronizza gli account Salesforce in un tracker della pipeline.

• Sincronizza i dati da uno strumento o database interno.

Una volta attivo, il database sincronizzato si comporta come qualsiasi altro database in Notion. L'accesso è regolato dalle autorizzazioni di condivisione standard di Notion.

Gli strumenti per agenti (basati sui Workers) estendono le funzionalità dei tuoi agenti personalizzati oltre le azioni integrate di Notion e MCP, con capacità su misura per il modo in cui lavora il tuo team.

Alcuni esempi comuni:

• Esecuzione di query su un data warehouse.

• Generazione di risorse da un documento Notion.

• Esecuzione di un'azione in un'altra app non supportata nativamente o disponibile tramite MCP.

I trigger webhook (basati su Workers) consentono a un evento in un altro strumento di avviare un flusso di lavoro in Notion o in qualsiasi altro sistema connesso.

Alcuni esempi comuni:

• Chiusura di un'attività quando viene unita una pull request.

• Aggiornamento di un record CRM quando cambia un abbonamento.

• Creazione di un documento di onboarding quando viene firmata un'offerta.

Una volta configurato, il flusso di lavoro viene eseguito automaticamente ogni volta che si verifica l'evento, così il tuo team non deve spostare manualmente le informazioni tra gli strumenti.

Con Modalità sviluppatore, puoi aprire i Workers dalla sezione sviluppatori nella barra laterale. Usa questa vista per controlli rapidi e azioni di base. In Notion, puoi:

• Visualizza tutti i Workers in un unico elenco.

• Apri un Worker e visualizza Panoramica, log, variabili d'ambiente e impostazioni.

• Leggi i log dei Worker.

• Disattiva o elimina un Worker.

Per distribuire un Worker o modificarne il codice o la configurazione, usa Notion CLI o lo strumento di programmazione del tuo team.

Per impostazione predefinita, solo la persona che ha creato un Worker può modificarlo e aggiungerlo come nuova connessione. Condividi un Worker con i membri del team in modo che possano connetterlo a un Custom Agent o aiutare a gestirlo.

Scopri di più su come condividere un Worker →

Prova questi passaggi in ordine:

1. Assicurati che il tuo spazio di lavoro sia idoneo e che un proprietario dello spazio di lavoro abbia abilitato i Workers. I Workers sono disponibili nei piani Business ed Enterprise e richiedono l'abilitazione da parte di un amministratore dello spazio di lavoro.

2. Conferma di utilizzare il percorso di configurazione previsto. Per la maggior parte delle configurazioni, utilizzerai Notion CLI insieme alla documentazione per sviluppatori.

3. Se la distribuzione del Worker non riesce, controlla i permessi. Potresti non avere l'accesso per distribuire in quello spazio di lavoro, anche se puoi visualizzarne le pagine.

4. Se il tuo Worker viene eseguito ma non modifica nulla in Notion, testa prima l'azione manualmente. Se non riesci ad apportare la stessa modifica in Notion, di solito si tratta di un problema di permesso o di impostazioni dello spazio di lavoro.

5. Se il costo sembra più alto del previsto, riduci la frequenza di esecuzione. I Workers che vengono eseguiti più spesso costeranno di più. Inizia con un programma più lento, quindi aumenta una volta che sei sicuro che funzioni.

6. Sei ancora bloccato? Segui la documentazione per gli sviluppatori per il messaggio di errore specifico. Lì troverai la soluzione più precisa.