בניית סוכן AI חינמי שמבצע פעולות, ללא קוד

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

המדריך הזה בונה סוכן כזה מחשבון ריק, ללא קוד. בסופו יהיה לכם סוכן שעונה על שאלות מתוך ידע שאתם נותנים לו וקורא ל-REST API חי במהלך הצ’אט, ותראו את זה קורה ב-Inbox. הפעולה שתבנו כאן היא המתכון הראשי: בקשת HTTP מתוארת אחת. כוונו אותה ל-URL אחר ואותו מתכון ירשום ליד לגיליון אלקטרוני, יכתוב ל-CRM או יבצע מודרציה בשרת צ’אט. כל מדריך אינטגרציה בסוף הפוסט הזה הוא דוגמה מלאה שלו.

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

מה תבנו

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

עונה מתוך ידע שאתם נותנים לו: התוכניות, המחירים והתכונות של Meridian.
קורא ל-API חי אחד באמצע שיחה כדי להמיר מחיר למטבע של המבקר, ואז משתמש בתוצאה בתשובה שלו.

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

מה צריך:

חשבון Quickchat AI חינמי (הירשמו כאן).
בלי קוד, בלי שרת, בלי מפתח API.

מהו סוכן AI, ובמה הוא שונה מצ’אטבוט?

צ’אטבוט עונה. סוכן עונה ופועל. ב-Quickchat בונים סוכן משלושה חלקים.

שלושת החלקים של סוכן AI: Identity הוא מי הוא, Knowledge הוא על סמך מה הוא עונה, ו-Actions and MCPs הוא מה הוא יכול לעשות שני החלקים הראשונים יוצרים צ’אטבוט. השלישי, Actions, הופך אותו לסוכן.

Identity הוא מי הסוכן: השם, התפקיד וההוראות שלו. זהו AI Main Prompt.
Knowledge הוא על סמך מה הוא עונה: המסמכים, הדפים והעובדות שלכם.
Actions & MCPs הוא מה הוא יכול לעשות: לקרוא ל-API במהלך השיחה.

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

מהי באמת AI Action

AI Action היא בקשת HTTP מתוארת. אתם ממלאים את הבקשה פעם אחת (המתודה, ה-URL והערכים שיש לשלוח) וכותבים תיאור של מתי להשתמש בה. במהלך שיחה המודל מחליט אם לקרוא לה וממלא את החלקים שהשארתם פתוחים, Quickchat שולחת את הבקשה, והמודל קורא את התגובה בחזרה.

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

AI Action אחת היא בקשת HTTP מתוארת אחת. אתם מקבעים את הערכים הדטרמיניסטיים כמו המתודה, ה-URL ומטבע הבסיס. המודל ממלא את ערכי השיפוט כמו מטבע היעד והסכום מתוך השיחה אתם מקבעים את הערכים הדטרמיניסטיים. המודל ממלא את ערכי השיפוט מתוך הצ’אט. הפרמטרים הם הערכים היחידים שהוא צריך לדייק בהם.

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

מכניסים ערכי שיפוט באמצעות תפריט Add AI Data, שמוסיף שבב {{...}} לכל שדה. התפריט הזה מציע בדיוק את שלושת הדברים שפעולה עשויה להצטרך למשוך:

Parameters שאתם מגדירים (ערכי השיפוט שהמודל ממלא, כמו {{currency}}).
Conversation metadata שהערוץ מגדיר (כמו {{conversation_channel}} או {{metadata_visitor_email}}).
System Tokens: סודות ש-Quickchat מאחסנת ומזריקה, מוצגים כתג, ולעולם לא ניתנים למודל.

תפריט Add AI Data פתוח בשדה, ומציג את פרמטרי הפעולה (currency ו-amount) תחת Parameters, אחריהם ערכי מטא-דאטה של Visitor, ואז משתנים מובנים כמו scenario_id ו-conversation_channel תפריט Add AI Data מכניס ערך כשבב: פרמטר שהגדרתם, ערך של מבקר או שיחה, או משתנה מובנה.

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

Variable	מה הוא מכיל
`{{conversation_channel}}`	הערוץ שבו מתנהל הצ’אט (`widget`, `telegram`, `whatsapp` וכן הלאה)
`{{conversation_url}}`	קישור לשיחה המדויקת הזו ב-Inbox שלכם
`{{language}}`, `{{country}}`	השפה והמדינה של המבקר, כקודים בני שתי אותיות
`{{metadata_visitor_email}}`	האימייל של המבקר, אחרי ששיתף אותו
`{{scenario_id}}`, `{{conversation_id}}`	מזהים עבור הסוכן הזה והשיחה הזו

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

שלב 1: צרו את הסוכן ותנו לו ידע

הירשמו ופתחו סוכן חדש. בדף Identity, הגדירו את AI Agent Name ל-Meridian והדביקו את זה ב-AI Main Prompt. זהו שדה הפרומפט הזמין תמיד בכל תוכנית. אין צורך ברשימת AI Guidelines הנפרדת.

דף Identity של סוכן Meridian, עם AI Agent Name שמוגדר ל-Meridian ו-AI Main Prompt שמתאר את התפקיד שלו, איך הוא משתמש בידע, מתי להמיר מטבע, ושעליו לומר לא כשאינו יודע הוראות הסוכן נכנסות ל-AI Main Prompt הזמין תמיד, לא לרשימת AI Guidelines הנפרדת.

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

ענה באמצעות הידע שלך. כל מחיר בידע שלך הוא בדולרים אמריקאיים (USD).

כאשר מבקר שואל כמה תוכנית או מחיר עולים במטבע אחר, או מזכיר את המדינה שלו או מטבע מקומי, קרא לפעולה "Convert price to currency" עם הסכום בדולרים אמריקאיים וקוד בן 3 אותיות של מטבע היעד, ואז תן לו גם את מחיר ה-USD וגם את הסכום המומר לפי השער של היום.

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

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

עכשיו תנו לו משהו לענות ממנו. בדף Knowledge Base, הוסיפו כמה מאמרים קצרים עם העובדות של Meridian. המאמר שהדמו נשען עליו הוא תמחור:

ל-Meridian יש שלוש תוכניות, בחיוב לפי משתמש לחודש בדולרים אמריקאיים (USD):
- Starter: $19 למשתמש לחודש. פרויקטים ללא הגבלה, תצוגות ציר זמן ולוח, עד 3 אינטגרציות.
- Pro: $49 למשתמש לחודש. מוסיפה תכנון ספרינטים, תלויות בין משימות, שדות מותאמים אישית ואינטגרציות ללא הגבלה.
- Business: $99 למשתמש לחודש. מוסיפה מפות דרכים לפורטפוליו, הרשאות מתקדמות, SSO ותמיכה בעדיפות.
חיוב שנתי עולה 17% פחות מחיוב חודשי. כל תוכנית מתחילה בתקופת ניסיון חינמית של 14 יום, ללא צורך בכרטיס אשראי.

דף Knowledge Base של סוכן Meridian, המציג שלושה מאמרים שנוספו ידנית (Getting started and support, What Meridian does, ו-Meridian plans and pricing), כל אחד מסומן Ready, עם שלושה מתוך חמישים מאמרים בשימוש עובדות הדמו, שנוספו כמאמרים קצרים ומסומנות Ready. הסוכן עונה לשאלות תמחור מתוכן.

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

שלב 2: מתכון AI Action הראשי, קריאה לכל REST API

זה החלק שניתן לשימוש חוזר. פתחו את Actions & MCPs, ותחת Custom Actions לחצו על Add Action, ואז על API Action.

תחת Custom Actions, Add Action מציג את API Action ראשון: בקשת HTTP מתוארת לכל REST API.

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

הערכים שיש לאסוף

החלק העליון של עורך API Action: השדה API Action Name מוגדר ל-Convert price to currency, וטבלת What to ask the user first עם שני פרמטרים נדרשים, currency (Text) ו-amount (Decimal Number) החלק העליון של הטופס: API Action Name, ושני הפרמטרים הנדרשים שהמודל ממלא, currency ו-amount.

API Action Name. שם קצר שהמודל משתמש בו כדי להתייחס לפעולה.

Convert price to currency

What to ask the user first. ערכי השיפוט, שורה אחת לכל ערך. תנו לכל אחד Format, Name, ו-Description שאומר למודל איך למלא אותו, וסמנו אותו Required כדי שהמודל לעולם לא יקרא לפעולה בלעדיו.

Format	Name	Description	Required
Text	`currency`	קוד ISO בן 3 אותיות של המטבע שאליו יש להמיר, למשל EUR, GBP או JPY. הסק אותו מהמטבע או מהמדינה שהמבקר מזכיר.	yes
Decimal Number	`amount`	הסכום בדולרים אמריקאיים להמרה, שנלקח מהתוכנית או מהמחיר שעליהם המבקר שאל.	yes

“What to ask the user first” היא התווית במוצר, אבל הסוכן כמעט לא עוצר כדי לשאול. כשהמבקר כותב “כמה עולה Business באירו”, למודל כבר יש את שני הערכים (amount מתוך הידע שלכם, currency מתוך “אירו”) והוא ממלא אותם ישירות.

הבקשה לשליחה

החצי התחתון של עורך API Action: מתודת בקשת ה-API מוגדרת ל-GET, ה-API endpoint URL מוגדר לנקודת הקצה latest של Frankfurter, לשונית Query Params מציגה base שמוגדר ל-USD ו-symbols ו-amount שמוגדרים לשבבי currency ו-amount, ו-API Action Description הבקשה: GET אל Frankfurter, עם base קבוע ל-USD ושבבי currency ו-amount שנוספו תחת Query Params.

API request method and endpoint URL. קריאת GET לנקודת הקצה latest-rates של Frankfurter:

GET
https://api.frankfurter.dev/v1/latest

Query Params. כאן הערכים הדטרמיניסטיים וערכי השיפוט נפגשים. הוסיפו שלוש שורות תחת לשונית Query Params. הקלידו USD עבור הבסיס, ועבור שני האחרים לחצו על Add AI Data ובחרו את הפרמטרים שהגדרתם, מה שמוסיף את שבבי {{currency}} ו-{{amount}}.

Key	Value
`base`	`USD`
`symbols`	`{{currency}}`
`amount`	`{{amount}}`

Headers ו-Body: אין. זו קריאת GET עם הכול ב-query string.

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

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

שמרו אותה והפעילו את הפעולה on. זה כל המתכון: שם, הערכים שיש לאסוף, בקשה ותיאור.

פעולת Convert price to currency המוגמרת בדף Actions and MCPs, מופעלת, מתויגת API Action, ומציגה שיעור הצלחה של 100 אחוז בקריאות הפעולה המוגמרת, מופעלת on. הכרטיס מציג במבט אחד את מספר הקריאות ואת שיעור ההצלחה שלה.

שום דבר כאן אינו ייחודי למטבעות. החליפו את ה-URL וה-query ל-API שלכם וקיבלתם פעולה אחרת.

כוונו אותה ל-API שלכם

פעולת Frankfurter היא קריאה: GET עם נתונים ציבוריים. ה-API שלכם בדרך כלל משתמש באותו טופס עם כמה שדות נוספים שממולאים.

כדי לכתוב, לא רק לקרוא, הגדירו את המתודה ל-POST, PATCH או DELETE, ושימו את הנתונים בלשונית Body כ-JSON. אותם שבבי {{...}} עובדים בתוך הגוף, כך ש-{ "email": "{{email}}" } שולח את מה שהמודל אסף.
עבור API שדורש מפתח, הוסיפו שורה תחת לשונית Headers (למשל Authorization) והכניסו את המפתח באמצעות Add AI Data, בבחירת System Token. Quickchat מאחסנת את הסוד ומזריקה אותו בזמן הקריאה, כך שהוא מוצג כתג ולעולם לא ניתן למודל או נכתב לפרומפט.
כל השאר זהה: השם, הפרמטרים לאיסוף, והתיאור שמחליט מתי הפעולה מופעלת.

מדריך HubSpot בונה כך ארבע פעולות POST עם אסימון OAuth מוזרק, ומדריך Discord בונה שבע מול Discord API עם אסימון בוט בכותרת. שניהם אותו טופס שמילאתם עכשיו, עם URL וגוף אחרים.

שלב 3: בדקו את זה וצפו בקריאה מתרחשת

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

תרשים בן חמישה שלבים של קריאת AI Action אחת: המבקר מבקש מחיר באירו, המודל ממלא את ערכי השיפוט (currency EUR, amount 99), Quickchat מוסיפה את הערכים הקבועים ושולחת בקשת GET ל-Frankfurter API, ה-API מחזיר את השער המומר, והסוכן עונה איתו קריאה אחת, מקצה לקצה: המודל ממלא את ערכי השיפוט, ו-Quickchat מוסיפה את הקבועים ומבצעת את הבקשה.

שוחחו עם הסוכן שלכם ב-AI Preview (בחלק העליון של התפריט השמאלי), או בווידג’ט החי שלכם, ואז פתחו את השיחה ב-Inbox. שאלו קודם שאלת תמחור רגילה, ואז בקשו אותה במטבע אחר:

Visitor: כמה עולה תוכנית Business? Meridian: תוכנית Business עולה $99 למשתמש לחודש.

Visitor: כמה זה באירו? Meridian: תוכנית Business עולה $99 למשתמש לחודש, שהם בערך €86.81 למשתמש לחודש לפי השער של היום.

התשובה הראשונה מגיעה מהידע. השנייה היא הפעלת הפעולה. אתם לא צריכים להסתמך על נוסח התשובה: השיחה מציגה סימון 1 action called, ופתיחתו מציגה את הקריאה עצמה.

שיחת Meridian ב-Inbox. הסוכן עונה על מחיר תוכנית Business מתוך הידע, ואז ממיר אותו לאירו. כרטיס קריאת פעולה מורחב מציג ש-Convert price to currency החזירה 200 בתוך 85 אלפיות השנייה, עם amount 99 ו-currency EUR שנשלחו, ותגובת Frankfurter הסוכן עונה $99 מתוך הידע, ואז ממיר לאירו. כרטיס 1 action called מוכיח שהקריאה הופעלה והחזירה 200.

הכרטיס הוא האמצע הכנה בין ההודעה לתשובה. הוא מראה שהפעולה החזירה 200, את הערכים המדויקים שהמודל שלח (amount: 99, currency: EUR), ואת התגובה ש-Frankfurter החזיר. כשאתם בונים פעולה משלכם, הכרטיס הזה ויומן הקריאות לכל פעולה (סה”כ קריאות, שיעור הצלחה, כל בקשה ותגובה) הם המקום שבו מאמתים שהסוכן קרא לפעולה הנכונה עם הערכים הנכונים, ולא רק שהתשובה נשמעה נכונה.

אותה פעולה מטפלת בכל מטבע. בקשו את תוכנית Starter ביינים יפניים והסוכן יקרא ל-Frankfurter עם amount: 19 ו-currency: JPY, ואז יענה ש-$19 הם בערך ¥3,087 לפי השער של היום. אותו מתכון, ערך אחר שהמודל מילא.

שיחת Meridian שבה מבקר מבקש את תוכנית Starter ביינים יפניים, והסוכן עונה ש-19 דולר הם בערך 3,087 ין למשתמש לחודש, עם כרטיס קריאת פעולה שמציג amount 19 ו-currency JPY שחוזרים עם 200 אותה פעולה, מטבע אחר: $19 הופכים ל-¥3,087. רק הערך שהמודל מילא השתנה.

יומן הקריאות לכל פעולה נמצא במרחק לחיצה אחת. פתחו View logs על הפעולה כדי לראות כל קריאה שהיא ביצעה: הסך הכולל, שיעור ההצלחה, ולכל קריאה את הבקשה המדויקת ואת התגובה שהתקבלה.

יומן הפעולה Convert price to currency: שתי קריאות, שיעור הצלחה של 100 אחוז, וזמן שיהוי ממוצע של 144 אלפיות השנייה, כאשר כל קריאה מציגה את URL הבקשה, הפרמטרים שנשלחו (amount ו-currency), ואת התגובה המלאה מ-Frankfurter כל קריאה שהפעולה ביצעה, עם הבקשה, התגובה והסטטוס המדויקים. שתי ההמרות החזירו 200.

שלב 4: הפכו את זה לאמין

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

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

תנו לתיאור להחליט מתי הפעולה מופעלת. המודל קורא את ה-description, לא את השם, כדי לבחור פעולה. תיאור עמום (“ממיר מטבעות”) יופעל באופן לא צפוי. תיאור שקשור לאות (“call this whenever the visitor asks what a price costs in a currency other than US dollars”) יופעל כשצריך. כשפעולה נקראת בזמן הלא נכון או לא נקראת כלל, התיאור הוא כמעט תמיד התיקון.

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

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

שיחת Meridian שבה מבקר שואל אם Meridian מוסמכת SOC 2 Type II. הסוכן משיב שאין לו מידע על כך בתיעוד שלו, אינו יכול לאשר זאת, וממליץ לפנות לצוות, במקום לנחש ה”לא” הכנה: כשאין בידע שלו שום דבר על SOC 2, הסוכן מסרב במקום לנחש.

Visitor: האם Meridian מוסמכת SOC 2 Type II? Meridian: אין לי מידע בתיעוד שלי על כך ש-Meridian מוסמכת SOC 2 Type II, ולכן איני יכול לאשר זאת. אם אתם צריכים תשובה definitive לבדיקת אבטחה או רכש, אני ממליץ לפנות ישירות לצוות ב-support@meridian.example.

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

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

העלאה לאוויר

הפעולה שייכת לסוכן, לא לערוץ מסוים, ולכן היא פועלת בכל מקום שבו הסוכן פרוס. הפעילו את web widget ואותה המרת מטבע תעבוד עבור מבקר באתר שלכם. חברו את Telegram, WhatsApp, Messenger, Slack או Discord והיא תעבוד גם שם, ללא שינוי. אין מה לבצע מחדש לכל ערוץ. סוכן פרוס נושא איתו את הפעולות שלו.

לאן ממשיכים: האינטגרציות האמיתיות

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

רישום לידים ודוחות ל-Google Sheets: הסוכן מוסיף שורה כאשר שיחה מייצרת ליד או משוב.
יצירת אנשי קשר, עסקאות וטיקטים ב-HubSpot: תכנון CRM לכתיבה בלבד שממלא רשומה תור אחר תור ולעולם לא קורא בחזרה נתונים של אף אחד.
מודרציה בשרת Discord: timeout, kick ו-ban כ-AI Actions, כאשר הפעולות ההרסניות נעולות לאדמינים באמצעות שער בצד השרת.
הרצת בוט טיקטי תמיכה ב-Discord: שלוש פעולות משורשרות שפותחות thread פרטי, מוסיפות את החבר ומזמנות את תפקיד התמיכה שלכם.
ניהול קבוצת Telegram: הכרזה, נעיצה ומודרציה משפה פשוטה דרך Telegram Bot API.
הפיכת הסוכן שלכם לשרת MCP: חשפו אותו ככלי ש-ChatGPT, Claude ו-Cursor יכולים לקרוא לו.
הרצה וניהול של הסוכן שלכם מתוך ChatGPT: הפעילו את הסוכן שבניתם מתוך לקוח AI דרך MCP.

רפרנס השדות המלא נמצא ב-תיעוד AI Actions.

שאלות נפוצות

איך בונים סוכן AI בחינם?

צרו חשבון Quickchat AI חינמי, תנו לסוכן פרומפט ראשי קצר וקצת ידע שממנו יענה, ואז הוסיפו AI Action אחת, בקשת HTTP מתוארת, כדי שיוכל לקרוא ל-API במהלך השיחה. בניית הסוכן, טעינת הידע, ויצירה והפעלה של פעולות הן כולן בחינם, וכל המדריך פועל בתוכנית החינמית.

האם צריך לכתוב קוד כדי לבנות סוכן AI?

לא. אתם מתארים את הסוכן בשפה פשוטה וממלאים טופס פעולה: שם, הערכים שיש לאסוף מהמבקר, מתודת הבקשה וה-URL, ותיאור של מתי לקרוא לה. Quickchat שולחת את הבקשה ומחזירה את התגובה לסוכן. אתם לא כותבים ולא מארחים שום קוד.

כמה זמן לוקח לבנות סוכן AI?

כ-10 דקות לסוכן במדריך הזה: כמה דקות לכתיבת הפרומפט שלו ולהוספת העובדות שלכם כידע, ועוד כמה דקות למילוי טופס AI Action אחד. אין צורך להתקין דבר ואין קוד לכתוב.

מה ההבדל בין סוכן AI לצ’אטבוט?

צ’אטבוט עונה על שאלות. סוכן AI גם מבצע פעולות: הוא יכול לקרוא ל-API במהלך השיחה כדי לחפש משהו או לבצע שינוי, ואז להשתמש בתוצאה בתשובה שלו. ב-Quickchat בונים סוכן משלושה חלקים: Identity שלו (מי הוא), Knowledge שלו (על סמך מה הוא עונה), ו-Actions שלו (מה הוא יכול לעשות).

האם סוכן AI יכול להשתמש בנתונים חיים בזמן אמת?

כן. בכל פעם שהסוכן קורא ל-AI Action הוא מבצע בקשה חדשה, ולכן הוא תמיד משתמש בנתונים חיים. הסוכן במדריך הזה מביא את שער החליפין של היום בכל המרה. כוונו את הפעולה ל-API שלכם והוא יקרא את הנתונים העדכניים שלכם באותו אופן.

האם סוכן ה-AI יכול לקרוא ל-API שלי?

כן. ה-AI Action במדריך הזה היא בקשת HTTP כללית. כוונו אותה ל-REST API שלכם במקום ל-API הציבורי שבו משתמשים כאן, הגדירו את המתודה, ה-URL, הכותרות והגוף, ותארו מתי הסוכן צריך לקרוא לה. אותו מתכון עובד לכל REST API, כולל פרטיים מאחורי אסימון אימות.

האם לסוכן AI אחד יכולה להיות יותר מפעולה אחת?

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

האם ChatGPT, Claude או Gemini יכולים לבנות סוכן שמבצע פעולות?

אפשר לבנות את הסוכן עם Quickchat ולבחור איזה מודל יריץ אותו. במהלך שיחה המודל מחליט מתי לקרוא לפעולה שלכם וממלא את הערכים מתוך הצ’אט, כך שהסוכן מחפש משהו או מבצע שינוי בעצמו. אפשר גם לחשוף את הסוכן המוגמר שלכם ל-ChatGPT, Claude ו-Cursor כשרת MCP.

מה הסוכן באמת יכול לעשות אחרי שבונים אותו?

כל דבר ש-REST API יכול לעשות. המדריך הזה משתמש בבדיקת מטבע חיה, אבל אותה צורת פעולה רושמת ליד ל-Google Sheets, יוצרת איש קשר ב-HubSpot, מנהלת מודרציה בשרת Discord, או מנהלת קבוצת Telegram. כל אחד מאלה הוא דוגמה מלאה למתכון הראשי בפוסט הזה.

איך הסוכן יודע מתי לקרוא לפעולה?

תיאור הפעולה הוא מה שהמודל קורא כדי להחליט. קשרו אותו לאות ברור, למשל “call this when the visitor asks for a price in a currency other than US dollars”, וסמנו את הערכים שהוא צריך כנדרשים. הפרמטרים הם הערכים היחידים שהמודל צריך למלא. כל שאר הבקשה קבוע.

האם בטוח לתת לסוכן AI לקרוא ל-API?

אתם נשארים בשליטה על הבקשה. אתם מקבעים את המתודה, ה-URL וכל סוד (מוזרק בצד של Quickchat, לעולם לא מוצג למודל), והמודל ממלא רק את הפרמטרים שאתם מגדירים. עבור פעולות שכותבות נתונים אפשר להתנות את הקריאה בתנאים בצד השרת שהצ’אט אינו יכול לעקוף. מדריכי HubSpot ו-Discord עוברים על דפוסי הבטיחות המלאים.

האם אפשר לבנות ולנסות בחינם?

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