Suorita mukautettua koodia Workersilla (beta)

Tässä ohjeasiakirjassa

Ota selvää, mitä Workers ovat ja mihin niitä käytetään.

Siirry usein kysyttyihin kysymyksiin

Notion Workers ovat osa kehittäjäalustaa. Ne suorittavat mukautettua koodia Notionin infrastruktuurissa ja mahdollistavat seuraavat:

  • Tietokantasynkronointi

  • Työkalut mukautetuille palvelijoille

  • Webhook-käynnistimet

Teknistä käyttöönottoa varten katso kehittäjädokumentaatiota.

Lisätietoja hinnoittelusta saat tästä artikkelista.

  • Workers on saatavilla Business- ja Enterprise-sopimuksissa.

  • Oletusarvoisesti Workers on kytketty päälle työtilassa (vain omistajille).

  • Työtilan Omistajat voivat:

    • Rajoita workerin luominen vain omistajille.

    • Salli tiettyjen jäsenten tai ryhmien luoda Workers.

    • Poista Workers käytöstä työtilassa.

  • Jos yrität ottaa käyttöön tai hallita workeria, seuraat yleensä kehittäjädokumentaatiotamme ja käytät Notion CLI:tä.

  • Voit ottaa kehittäjätilan käyttöön, jotta voit tarkastella Workers Notionissa, lukea lokeja sekä poistaa Workers käytöstä tai poistaa niitä. Jos haluat ottaa workerin käyttöön tai muuttaa sen koodia tai asetuksia, käytä Notion CLI tai tiimisi koodaustyökalua. Lue lisää kehittäjätilasta →

Lisätietoja Workers-hinnoittelusta on tässä artikkelissa.

Synkronointi tietokantaan (Workersin tukemana) tuo tietoja ulkoisista työkaluista Notion-tietokantaan ja pitää ne automaattisesti ajan tasalla. Kun se on määritetty, Synkronoitu tietokanta pysyy ajan tasalla itsestään, joten tiimisi ja palvelijasi näkevät aina uusimmat tiedot ilman, että kenenkään tarvitsee Kopioida tai liittää tietoja työkalujen välillä.

Muutama yleinen esimerkki:

  • Synkronoi Zendesk-tukipyynnöt lajittelutietokantaan.

  • Synkronoi Salesforce-tilit myyntiputken seurantaan.

  • Synkronoi tietoja sisäisestä työkalusta tai tietokannasta.

Kun se on julkaistu, Synkronoitu tietokanta toimii kuten mikä tahansa muu Notionin tietokanta. Käyttöoikeuksia hallitaan Notionin tavallisilla jakamisasetuksilla.

Agenttityökalut (joita Workers käyttää) laajentavat mukautettujen palvelijoiden toimintoja Notionin sisäänrakennettujen toimintojen ja MCP:n lisäksi, ja ne on räätälöity tiimisi työskentelytavan mukaan.

Muutama yleinen esimerkki:

  • Tietovaraston kysely.

  • Resurssien luominen Notion-dokumentista.

  • Toimenpiteiden suorittaminen toisessa sovelluksessa, jota ei tueta natiivisti tai joka ei ole käytettävissä MCP:n kautta.

Webhook-käynnistimet (joita Workers käyttää) mahdollistavat sen, että toisen työkalun tapahtuma käynnistää työnkulun Notionissa tai missä tahansa muussa yhdistetyssä järjestelmässä.

Muutama yleinen esimerkki:

  • Tehtävän sulkeminen, kun pull-pyyntö yhdistetään.

  • CRM-tietueen päivittäminen, kun tilaus muuttuu.

  • Perehdytysdokumentin luominen, kun tarjous on allekirjoitettu.

Kun työnkulku on määritetty, se suoritetaan automaattisesti aina, kun tapahtuma ilmenee, joten tiimisi ei tarvitse siirtää tietoja manuaalisesti työkalujen välillä.

Kehittäjätilan avulla voit avata Workereita sivupalkin kehittäjäosiosta. Käytä tätä näkymää nopeisiin tarkistuksiin ja perustoimintoihin. Notionissa voit:

  • Näytä kaikki Workers yhdessä listassa.

  • Avaa worker ja tarkastele yleiskatsausta, lokeja, ympäristömuuttujia ja asetuksia.

  • Lue worker-lokit.

  • Poista worker käytöstä tai poista se kokonaan.

Käytä Notion CLI-työkalua tai tiimisi koodaustyökalua workerin käyttöönottoon tai sen koodin tai asetusten muuttamiseen.

Oletuksena vain workerin luonut henkilö voi muokata sitä tai lisätä sen uudeksi yhteydeksi. Jaa worker tiimin jäsenten kanssa, jotta he voivat yhdistää sen mukautettuun palvelijaan tai auttaa sen hallinnassa.

Kokeile näitä vaiheita järjestyksessä:

  1. Varmista, että työtilasi on kelvollinen ja että työtilan Omistaja on ottanut Workers käyttöön. Workers ovat käytettävissä Business- ja Enterprise-sopimuksissa, ja ne vaativat työtilan ylläpitäjän aktivoinnin.

  2. Varmista, että käytät tarkoitettua asennuspolkua. Useimmissa asennuksissa käytät Notion CLI-työkalua ja kehittäjädokumentaatiota.

  3. Jos worker-suoritus epäonnistuu, tarkista seuraavaksi käyttöoikeudet. Sinulla ei ehkä ole käyttöoikeutta suorittaa käyttöönottoa kyseiseen työtilaan, vaikka sinulla olisi tarkastelu sallittu sen sivuihin.

  4. Jos worker-suoritus onnistuu, mutta se ei muuta mitään Notionissa, testaa toimintoa ensin manuaalisesti. Jos et voi tehdä samaa muutosta Notionissa, kyseessä on yleensä käyttöoikeus- tai työtila-asetusongelma.

  5. Jos kustannukset vaikuttavat odotettua korkeammilta, vähennä suoritustiheyttä. Useammin suoritetut Workers maksavat enemmän. Aloita hitaammalla aikataululla ja lisää tahtia, kun olet varma, että se toimii.

  6. Jumissa edelleen? Seuraa kehittäjädokumentaatiota kyseisen virheilmoituksen kohdalla. Sieltä löydät tarkimman korjauksen.


Usein kysytyt kysymykset

Mitä eroa on Workers ja mukautetut palvelijat?

Workers ja mukautetut palvelijat ratkaisevat eri ongelmia, mutta ne voivat toimia yhdessä.

  • Workers: Suorita mukautettua koodia Notionin infrastruktuurissa. Kehittäjät käyttävät Workersia esimerkiksi automaatioihin, ajoitettuihin synkronointeihin ja mukautettuihin integraatioihin.

  • Mukautetut palvelijat: Hoitavat tiimisi toistuvat työt automaattisesti. Määrität Käynnistimet, ja ne toimivat taustalla työtilasi kontekstissa.

Joissakin kokoonpanoissa worker voi tehostaa ainutlaatuista työkalua, jota mukautettu palvelija voi hyödyntää. Esimerkiksi worker voi hakea tietoja toisesta järjestelmästä, ja palvelija voi käyttää niitä vastaamiseen tai toimintaan.

Ovatko Workers sama asia kuin automaatiot?

Eivät täysin. Automaatiot on sisäänrakennettu Notion-palveluun, ja ne on suunniteltu kenen tahansa määritettäviksi. Workers on tarkoitettu kehittäjille, jotka haluavat suorittaa mukautettua koodia. Jos et tarvitse koodia, aloita automaatioilla.

Suoritetaanko Workers omilla palvelimillani?

Ei. Workers suoritetaan Notionin palvelimilla, joten sinun ei tarvitse määrittää tai hallita mitään infrastruktuuria.

Tarvitsenko CLI-työkalua Workersin käyttämiseen?

Ei aina. Voit tarkastella Workers, lukea worker-lokit sekä poistaa workerit käytöstä tai poistaa ne Notionissa kehittäjätilan avulla. Tarvitset yleensä CLI-työkalun tai tiimisi koodaustyökalun workerin määrittämiseen, käyttöönottoon tai muuttamiseen.


Anna palautetta

Oliko tästä resurssista apua?


Powered by Fruition