לבנות AI Agent מאפס עם Claude API - בלי n8n ובלי Zapier

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

מה זה בעצם "סוכן"

סוכן AI, במובן הטכני הפשוט ביותר, הוא מודל שפה שרץ בלולאה: מקבל בקשה, מחליט אם הוא צריך "כלי" (tool) כדי להשלים אותה - קריאת קובץ, חיפוש באינטרנט, קריאה ל-API חיצוני - מריץ את הכלי, מקבל תוצאה, ומחליט אם צריך עוד שלב או שהוא מוכן לענות. ההבדל בין "צ'אטבוט" לסוכן הוא בדיוק היכולת הזו לבחור כלים ולפעול בכמה שלבים בלי שמישהו מנחה כל צעד בנפרד.

הלולאה המינימלית

מודל Claude תומך ב-tool use דרך ה-API הרגיל: מגדירים רשימת כלים בבקשה (למשל כלי שמחזיר מזג אוויר לעיר נתונה), והמודל מחליט מתי להשתמש בהם. התהליך בפועל: שולחים למודל את השאלה יחד עם רשימת הכלים הזמינים; אם הוא מחליט שהוא צריך כלי, הוא לא מריץ אותו בעצמו - הוא מחזיר בקשה מובנית ("תריץ את הכלי הזה עם הפרמטרים האלה"), והקוד שלכם הוא זה שבפועל מריץ את הפעולה (קריאה למאגר מידע, ל-API חיצוני וכו') ומחזיר את התוצאה בחזרה למודל. המודל ממשיך בלולאה הזו - מבקש כלי, מקבל תוצאה, מבקש עוד כלי אם צריך - עד שיש לו מספיק מידע לענות בפועל למשתמש.

זו בדיוק הלולאה ש-n8n או Zapier מריצים מאחורי הקלעים כשמגדירים "AI Agent" בממשק שלהם - ההבדל הוא שכשבונים את זה ישירות מול ה-API, אתם קובעים בעצמכם בדיוק אילו כלים קיימים, מה קורה כשכלי נכשל, ומתי לעצור.

עלות בפועל

לפי התיעוד הרשמי של Anthropic, Claude Sonnet 5 עולה 2 דולר למיליון טוקן קלט ו-10 דולר למיליון טוקן פלט - זה המודל המומלץ לרוב משימות הפרודקשן. Claude Opus 5, המודל החזק והיקר יותר, עולה 5 דולר קלט ו-25 דולר פלט למיליון טוקן, ומתאים למשימות עם היגיון מורכב יותר. חשוב לדעת: כל בקשה עם כלים מוסיפה תקורת טוקנים קבועה - אצל Sonnet 5 זה כ-354 טוקן נוספים כשה-tool_choice הוא "auto", גם לפני שהמודל בכלל השתמש בכלי.

איפה זה נשבר

הלולאה הידנית לא מטפלת לבד בכמה דברים קריטיים: שגיאה בכלי (חובה להחזיר tool_result עם is_error: true, לא סתם לזרוק חריגה), לולאה אינסופית אם המודל ממשיך לבקש כלים בלי סוף (כדאי להגביל מספר איטרציות), והיסטוריית שיחה שגדלה בכל סבב - שיחה ארוכה עם הרבה קריאות כלי צוברת טוקנים מהר. עבור לולאה שכבר כוללת טיפול בשגיאות, retry ו-hooks לאישור לפני הרצת כלי, יש ב-SDK הרשמי "Tool Runner" (client.beta.messages.toolRunner) שחוסך כתיבת הלולאה ידנית - שווה לבדוק לפני שממציאים מחדש את כל הטיפול בקצוות.

מקרה קצה: הכלי מחזיר תשובה חלקית

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

מתי כן עדיף n8n או Zapier

לא כל משימה מצדיקה כתיבת לולאה ידנית. אם המשימה היא בעיקר חיבור בין שירותים קיימים - Gmail, Slack, Google Sheets - בלי היגיון מותאם מורכב, פלטפורמת no-code חוסכת זמן פיתוח משמעותי ומתחזקת את הקוד בשבילכם. הקוד הישיר מול Claude API משתלם כשצריך שליטה על התנהגות שפלטפורמת no-code לא חושפת - למשל טיפול מותאם בשגיאות כלי ספציפי, לוגיקת retry מורכבת, או שילוב עם מערכת פנימית שאין לה חיבור מוכן.

מה לנסות עכשיו

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