הריצו קוד מותאם אישית עם Workers (בטא)

Notion Workers הם חלק מ-הפלטפורמה למפתחים שלנו. הם מריצים קוד מותאם אישית על התשתית של Notion כדי להפעיל:

• סנכרון מאגרי ידע

• כלים עבור סוכנים בהתאמה אישית

• טריגרים של Webhook

• Workers זמינים בתוכניות לעסקים ובתוכנית Enterprise.

• כברירת מחדל, Workers מופעלים עבור סביבת העבודה (עבור הבעלים בלבד).

• הבעלים של סביבת העבודה יכולים:

  • להגביל את יצירת ה-Worker לבעלים בלבד.

  • אפשרו לחברים או לקבוצות ספציפיים ליצור Workers.

  • כיבוי Workers עבור סביבת העבודה

• אם אתם מנסים לפרוס או לנהל Worker, בדרך כלל תעקבו אחר תיעוד המפתחים שלנו ותשתמשו ב-Notion CLI.

• ניתן להפעיל את מצב מפתח כדי להציג Workers ב-Notion, לקרוא יומנים, ולכבות או למחוק Workers. כדי לפרוס Worker או לשנות את הקוד או ההגדרה שלו, השתמשו ב-Notion CLI או בכלי הקידוד של הצוות שלכם. למידע נוסף על מצב מפתח →

למידע נוסף על תמחור עבור Workers, ניתן לעיין ב-מאמר זה.

סנכרון מסדי נתונים (המופעל על ידי Workers) מביא מידע מכלים חיצוניים למאגר ידע ב-Notion ושומר עליו מעודכן באופן אוטומטי. ברגע שהסנכרון מוגדר, המאגר המסונכרן נשאר מעודכן בעצמו, כך שהצוות שלכם והסוכנים שלכם תמיד רואים את הנתונים העדכניים ביותר מבלי שאף אחד יצטרך להעתיק או להדביק בין כלים.

כמה דוגמאות נפוצות:

• סנכרון כרטיסי תמיכה מ-Zendesk למאגר ידע למיון.

• סנכרון חשבונות מ-Salesforce למעקב אחר צינור מכירות.

• סנכרון נתונים מכלי פנימי או ממאגר ידע.

ברגע שהוא פעיל, המאגר המסונכרן מתנהג כמו כל מאגר ידע אחר ב-Notion. הגישה אליו מנוהלת לפי הרשאות השיתוף הרגילות שלכם ב-Notion.

כלי סוכנים (המופעלים על ידי Workers) מרחיבים את מה שהסוכנים בהתאמה אישית שלכם יכולים לעשות מעבר לפעולות המובנות של Notion ו-MCP, עם יכולות המותאמות לאופן שבו הצוות שלכם עובד.

כמה דוגמאות נפוצות:

• ביצוע שאילתות במחסן נתונים.

• יצירת נכסים ממסמך Notion.

• ביצוע פעולה באפליקציה אחרת שאינה נתמכת באופן טבעי או זמינה דרך MCP.

טריגרים של Webhook (המופעלים על ידי Workers) מאפשרים לאירוע בכלי אחר להפעיל זרימת עבודה ב-Notion או בכל מערכת מחוברת אחרת.

כמה דוגמאות נפוצות:

• סגירת משימה כאשר בקשת משיכה (pull request) מתמזגת.

• עדכון רשומת CRM כאשר מנוי משתנה.

• יצירת מסמך קליטה (onboarding) כאשר הצעה נחתמת.

ברגע שהוא מוגדר, זרימת העבודה פועלת באופן אוטומטי בכל פעם שהאירוע מתרחש, כך שהצוות שלכם לא צריך להעביר מידע באופן ידני בין כלים.

עם מצב מפתח, תוכלו לפתוח Workers מהקטע של המפתחים בסרגל הצד שלכם. השתמשו בתצוגה זו לבדיקות מהירות ופעולות בסיסיות. ב-Notion, באפשרותכם:

• הצגת כל ה-Workers ברשימה אחת.

• פתיחת Worker וצפייה ב-Overview, Logs, Environment Variables ו-Settings.

• קריאת יומני Worker.

• כיבוי או מחיקת Worker.

כדי לפרוס Worker או לשנות את הקוד או ההגדרה שלו, השתמשו ב-Notion CLI או בכלי הקידוד של הצוות שלכם.

כברירת מחדל, רק האדם שיצר Worker יכול לשנות אותו ולהוסיף אותו כחיבור חדש. מומלץ לשתף את ה-Worker עם חברי הצוות כדי שיוכלו לחבר אותו לסוכנים בהתאמה אישית או לסייע בניהולו.

למידע נוסף על אופן השיתוף של Worker →

יש לבצע את השלבים הבאים לפי הסדר:

1. יש לוודא שסביבת העבודה שלכם זכאית ושבבעלות סביבת העבודה הופעלו Workers. Workers זמינים בתוכניות לעסקים ובתוכנית Enterprise, ודורשים הפעלה על ידי מנהל סביבת עבודה.

2. יש לוודא שאתם משתמשים בנתיב ההגדרה המיועד. עבור רוב ההגדרות, תשתמשו ב-Notion CLI וב-תיעוד למפתחים.

3. אם פריסת ה-Worker שלכם נכשלת, יש לבדוק לאחר מכן את ההרשאות. ייתכן שאין לכם גישה לפרוס בסביבת עבודה זו, גם אם אתם יכולים לצפות בדפים בתוכה.

4. אם ה-Worker שלכם פועל אך אינו משנה דבר ב-Notion, יש לבדוק את הפעולה באופן ידני תחילה. אם אינכם מצליחים לבצע את אותו שינוי ב-Notion, זו בדרך כלל בעיית הרשאות או הגדרות סביבת עבודה.

5. אם העלות נראית גבוהה מהצפוי, מומלץ להקטין את תדירות ההרצה. Workers שמופעלים בתדירות גבוהה יותר יעלו יותר. כדאי להתחיל עם לוח זמנים איטי יותר, ולאחר מכן להגדיל את התדירות כאשר התפקוד מתגבש.

6. עדיין תקועים? יש לעיין ב-תיעוד המפתחים עבור הודעת השגיאה הספציפית; שם תימצא הפתרון המדויק ביותר.