קהילת אוטומציה עסקית

פורום קהילת אנשי המקצוע מתחום הצ'טבוטים והאוטומציה העסקית.
הכתיבה בפורום הינה לחברי הקהילה בלבד.
מנהל הפורום: rabin
להצטרפות לקהילת אוטומציה, הקש כאן
@rabin


שלום לכולם,

אני עובד על מערכת שמקבלת מספר נתונים עבור משרות דרושים ומבוססת על מודול OpenAI ליצירת הודעות מסודרות לפרסום.
הנתונים שאני מקבל הם:

  1. סוג עבודה
  2. כמות עובדים
  3. סך השעות
  4. סכום לתשלום לשעה
  5. עיר ומיקום
  6. הערה (במקרים מסוימים)
במקרים בהם אני מקבל מספר טלפון, אני רוצה להוריד אותו מההודעה הסופית ולא להציג אותו.

האם יש למישהו ניסיון עם מודול OpenAI שיוכל לעזור לי:

  1. איך ליצור הודעה אוטומטית שמבוססת על הנתונים הנ"ל?
  2. איך להוריד מספר טלפון מההודעה אם הוא קיים?
  3. אם יש שיטה טובה לפתח את זה בתוך OpenAI, אשמח לקבל הסברים על איך להגדיר את המודול.
תודה רבה מראש לכל מי שיכול לעזור!
(אני עובד עם Make ואשמח לדעת איך לשלב את המודול של OpenAI בצורה הטובה ביותר).
בס"ד

מדריך לשימוש בשדה API במערכת Origami.ms​



מבוא:​

שדה ה-API מאפשר ביצוע קריאות חיצוניות לממשקי API לצורך הבאת נתונים דינמיים והצגתם ישירות במערכת. הוא מתפקד כשדה בחירה (Select) המותאם לחיפוש דינמי, כך שהמשתמש יכול להקליד בשדה, והמערכת תחזיר תוצאות בהתאם.

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

הנתונים המתקבלים מופיעים בהתאם להגדרות שהוגדרו מראש, ומוצגים ברשימה לבחירה (Drop-Down), כך שהמשתמש יכול לבחור את הערך המתאים מבין האפשרויות.



שלב 1: הגדרות בסיסיות של השדה

  1. שם השדה (field_name): יש להזין שם לשדה כפי שיופיע במערכת, למשל: "כתובת חיפוש".
  2. תיאור השדה (tooltip_description): תיאור קצר המסביר את מטרת השדה והשימוש בו, לדוגמה: "שדה לחיפוש כתובת לפי נתוני OpenStreetMap".



שלב 2: הגדרות API

  1. API קישור (api_url): הכניסו את כתובת ה-URL של ה-API אליו יבוצע החיפוש. לדוגמה:
    HTTP:
    https://nominatim.openstreetmap.org/search?format=json
  2. סוג פעולה (action_type): בחרו את סוג הבקשה (GET או POST). בדוגמה שלנו נשתמש ב-GET.




שלב 3: מיפוי פרמטרים בנתוני החיפוש

  1. id מזהה המאפיין (id_prop_name): כאן יש להזין את שם הפרמטר של המזהה (ID) במערך התשובה, חייב להיות מזהה חד ערכי. בדוגמה, הפרמטר הוא place_id.
  2. text שם המאפיין (text_prop_name): הפרמטר שיוצג למשתמש כתוצאה מחיפוש. בדוגמה זו, זהו display_name, אשר מכיל את הכתובת המלאה כמו "ירושלים, בני ברק, ישראל".
  3. שם מאפיין לחיפוש (search_prop_name): השם של פרמטר החיפוש שנשלח ל-API. בדוגמה זו, נשתמש בפרמטר q עבור החיפוש.
  4. שם מאפיין לעמוד (page_prop_name): ערך מוגדר כברירת מחדל ואינו ניתן לשינוי. כאן לדוגמה, נשתמש בפרמטר page.
  5. מאפיינים נוספים (custom_validation[extra_props]): קלט טקסט המאפשר הגדרת פרמטרים נוספים, לא פעיל כרגע.
  6. פילטר (custom_validation[filters]): הפילטרים בשדה מאפשרים לכם לבחור שדות API אחרים, ושולח את שמות השדות שהוגדרו + הערך id שלהם (ללא הטקסט).



שלב 4: הגדרות נוספות לשדה

  1. מספר תווים מינימלי לחיפוש (min_search_length): מגדיר את מספר התווים המינימלי שעל המשתמש להקיש לפני שהחיפוש יופעל. בדוגמה זו, נזין 3.
  2. מספר תוצאות (results_per_page): קובע את מספר התוצאות שיוצגו באוריגמי בכל חיפוש של תוצאות. בדוגמה, נבחר להציג 50 תוצאות.
  3. זמן תגובה מקסימלי (response_timeout_seconds): מגביל את הזמן שהמערכת תחכה לתשובת ה-API לפני שתציג הודעת שגיאה. בדוגמה, נזין 3 שניות.

1731226890576.png



דוגמה לקריאת API עם ערכים לדוגמה

נניח שהמשתמש מקיש את השאילתה "ירושלים בני ברק" בשדה החיפוש. הקריאה שתישלח ל-API תיראה כך:

HTTP:
https://nominatim.openstreetmap.org/search?format=json&q=ירושלים בניברק&instance_id=658e841ad55b828d150e1724&field_data_name=fld_1872&filter=&page=1

מה נשלח בבקשה​

  • q – מייצג את הערך שחיפש המשתמש.
  • instance_id – מזהה המופע באוריגמי, מזהה ייחודי לשדה במערכת.
  • field_data_name – שם השדה באוריגמי, במקרה הזה fld_1872.
  • page – מספר העמוד.
  • filter – ניתן להגדיר בפילטר שדות api אחרים בישות יישלח, ויישלחו שמות השדות שהוגדרו לפילטר, יחד עם מזהי ה-ID שלהם בלבד, ללא הטקסט. אם לא הוגדר פילטר, ישלח הערך כ-"ריק". לדוגמא: filter[fld_1224]: 38.

חשוב לדעת:​

  • אוריגמי תמיד שולחת את הפרמטרים instance_id ,field_data_name, filter, ו-page, מה שעלול ליצור בעיות עם מערכות שלא מקבלות פרמטרים נוספים בכתובת ה-API.
  • בכל הזנה של ערך בשדה נשלחת קריאה חדשה לשרת.



דוגמה לתשובת ה-API

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

    {

        "place_id": 194257751,

        "display_name": "ירושלים, הר שלום, בני ברק, נפת תל אביב, מחוז תל אביב, ישראל",

        "lat": "32.08502095",

        "lon": "34.8298572"

    },

    {

        "place_id": 194311477,

        "display_name": "ירושלים, הר שלום, בני ברק, נפת תל אביב, מחוז תל אביב, ישראל",

        "lat": "32.0874445",

        "lon": "34.830255"

    }

]

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




מה אוריגמי שומרת מהתשובה

  • id: הערך של place_id יישמר כערך ה-ID שהוגדר בשדה.
  • text: הערך של display_name יישמר יישמר כערך הטקסט להצגה שהוגדר בשדה.
במקרה זה, אוריגמי תשמור את הכתובת המלאה, לדוגמה: "ירושלים, הר שלום, בני ברק, נפת תל אביב, מחוז תל אביב, ישראל". ואת המזהה "194257751".
JSON:
"fld_1872": { "id": 194257751, "text": "בני ברק, נפת תל אביב, מחוז תל אביב, ישראל" }

1731227100544.png



סיכום

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



היי! 👋 חדשות מרגשות ממערכת Make!
6 פונקציות חדשות נוספו למערכת שיעזרו לך לשדרג את תהליכי האוטומציה שלך! הנה הסבר מורחב על כל אחת:

1. abs()
הופכת כל מספר שלילי לחיובי. עובדת גם על מספרים עשרוניים.
קוד:
abs(-5) = 5
קוד:
abs(5) = 5
קוד:
abs(0) = 0
קוד:
abs(-3.7) = 3.7

2. median()
מוצאת את הערך האמצעי ברשימת מספרים או במערך. אם יש מספר זוגי של ערכים, היא מחזירה את הממוצע של שני הערכים האמצעיים.
קוד:
median(3, 5, 7) = 5
קוד:
median(2, 3, 5, 8) = 4
קוד:
median(2.5, 3.5, 2, 4.5, 1) = 2.5

3. trunc()
מקצצת את החלק העשרוני של מספר. ניתן לציין כמה ספרות אחרי הנקודה לשמור.
קוד:
trunc(3.789) = 3
קוד:
trunc(3.789, 2) = 3.78
קוד:
trunc(-3.789, 2) = -3.78
קוד:
trunc(123.456, -2) = 100

4. stdevS()
מחשבת את סטיית התקן של מדגם. עובדת על מערך או על רשימת מספרים.
קוד:
stdevS(1, 2, 3, 4, 5) = 1.5811388300841898
קוד:
stdevS([1, 2, 3, 4, 5]) = 1.5811388300841898

5. stdevP()
מחשבת את סטיית התקן של אוכלוסייה. גם היא עובדת על מערך או על רשימת מספרים.
קוד:
stdevP(1, 2, 3, 4, 5) = 1.4142135623730951
קוד:
stdevP([1, 2, 3, 4, 5]) = 1.4142135623730951

6. replaceEmojiCharacters()
מסירה סמלי אימוג'י מטקסט. ניתן להחליף את האימוג'ים בטקסט אחר או להסיר אותם לגמרי.
קוד:
replaceEmojiCharacters("Hello, world!😃😉", "emptystring") = "Hello, world!"
קוד:
replaceEmojiCharacters("Automate🌐your📊workflow✂easily!", "emptystring") = "Automate your workflow easily!"

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

הצטרפות לניוזלטר

איזה כיף שהצטרפתם לניוזלטר שלנו!

מעכשיו, תהיו הראשונים לקבל את כל העדכונים, החדשות, ההפתעות בלעדיות, והתכנים הכי חמים שלנו בפרוג!

לוח מודעות

הפרק היומי

הפרק היומי! כל ערב פרק תהילים חדש. הצטרפו אלינו לקריאת תהילים משותפת!


תהילים פרק כה

אלְדָוִד אֵלֶיךָ יי נַפְשִׁי אֶשָּׂא:באֱלֹהַי בְּךָ בָטַחְתִּי אַל אֵבוֹשָׁה אַל יַעַלְצוּ אֹיְבַי לִי:גגַּם כָּל קוֶֹיךָ לֹא יֵבֹשׁוּ יֵבֹשׁוּ הַבּוֹגְדִים רֵיקָם:דדְּרָכֶיךָ יי הוֹדִיעֵנִי אֹרְחוֹתֶיךָ לַמְּדֵנִי:ההַדְרִיכֵנִי בַאֲמִתֶּךָ וְלַמְּדֵנִי כִּי אַתָּה אֱלֹהֵי יִשְׁעִי אוֹתְךָ קִוִּיתִי כָּל הַיּוֹם:וזְכֹר רַחֲמֶיךָ יי וַחֲסָדֶיךָ כִּי מֵעוֹלָם הֵמָּה:זחַטֹּאות נְעוּרַי וּפְשָׁעַי אַל תִּזְכֹּר כְּחַסְדְּךָ זְכָר לִי אַתָּה לְמַעַן טוּבְךָ יי:חטוֹב וְיָשָׁר יי עַל כֵּן יוֹרֶה חַטָּאִים בַּדָּרֶךְ:טיַדְרֵךְ עֲנָוִים בַּמִּשְׁפָּט וִילַמֵּד עֲנָוִים דַּרְכּוֹ:יכָּל אָרְחוֹת יי חֶסֶד וֶאֱמֶת לְנֹצְרֵי בְרִיתוֹ וְעֵדֹתָיו:יאלְמַעַן שִׁמְךָ יי וְסָלַחְתָּ לַעֲוֹנִי כִּי רַב הוּא:יבמִי זֶה הָאִישׁ יְרֵא יי יוֹרֶנּוּ בְּדֶרֶךְ יִבְחָר:יגנַפְשׁוֹ בְּטוֹב תָּלִין וְזַרְעוֹ יִירַשׁ אָרֶץ:ידסוֹד יי לִירֵאָיו וּבְרִיתוֹ לְהוֹדִיעָם:טועֵינַי תָּמִיד אֶל יי כִּי הוּא יוֹצִיא מֵרֶשֶׁת רַגְלָי:טזפְּנֵה אֵלַי וְחָנֵּנִי כִּי יָחִיד וְעָנִי אָנִי:יזצָרוֹת לְבָבִי הִרְחִיבוּ מִמְּצוּקוֹתַי הוֹצִיאֵנִי:יחרְאֵה עָנְיִי וַעֲמָלִי וְשָׂא לְכָל חַטֹּאותָי:יטרְאֵה אוֹיְבַי כִּי רָבּוּ וְשִׂנְאַת חָמָס שְׂנֵאוּנִי:כשָׁמְרָה נַפְשִׁי וְהַצִּילֵנִי אַל אֵבוֹשׁ כִּי חָסִיתִי בָךְ:כאתֹּם וָיֹשֶׁר יִצְּרוּנִי כִּי קִוִּיתִיךָ:כבפְּדֵה אֱלֹהִים אֶת יִשְׂרָאֵל מִכֹּל צָרוֹתָיו:
נקרא  2  פעמים
למעלה