בניית Workflows אוטומטית דרך ה‑API עם סוכן קוד (Claude Code)

מה נלמד במדריך הזה

עד עכשיו בנינו Workflows ידנית. במדריך הזה נראה גישה מתקדמת: לחבר סוכן קוד (למשל Claude Code) ל‑API של המערכת, כך שהסוכן יוכל לבנות עבורנו אוטומציות בעצמו — במקום שנחפש דוקומנטציה, נקרא אותה ידנית ונבנה כל Workflow בעבודת יד.

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

איך זה עובד — הרעיון

למערכת יש API עם דוקומנטציה מלאה. ב‑Docs רואים כל מה שאפשר לעשות דרך ה‑API:

• שליפת Workflows ויצירת חדשים
• שינוי, פרסום (Publish) והעתקה (Copy) של Workflow
• הבנת כל המבנה: איך המערכת מחוברת, אילו נודים קיימים ואיך הם מתחברים

כשמעבירים את כל הידע הזה לסוכן קוד, הוא יכול לבנות אוטומציות דרך ה‑API בעצמו.

שלב 1: יצירת מפתח API

1. היכנסו ל‑Settings וצרו מפתח חדש.
2. לחצו Generate והעתיקו את המפתח — נשתמש בו בשלב חיבור הסוכן.

שלב 2: האכלת הסוכן בדוקומנטציה

בדוגמה נעבוד עם סוכן קוד שרץ בטרמינל (כמו Claude Code). הטריק פשוט ועובד היטב — בלי MCP ובלי כלים מיוחדים, רק דוקומנטציה:

1. אספו את כל כתובות ה‑URL של הדוקומנטציה — כל נקודות ה‑API.
2. העבירו אותן לסוכן אחת‑אחת כדי שילמד איך להשתמש בכל המערכת.
3. בסוף, ספקו לו את מפתח ה‑API (הוא גם יבקש אותו).

עם החומר הזה הסוכן בונה Skill משלו שמאפשר לו לתקשר ישירות עם ה‑API. גישה של “דוקומנטציה פשוטה + API” מגיעה לתוצאות טובות למדי.

שלב 3: בקשת Workflow מהסוכן

עכשיו אפשר לבקש מהסוכן לבנות Workflow. לדוגמה, בקשה מורכבת ששילבה:

• News Headlines API
• Crypto Prices
• OpenRouter לסיכום (Summarize)
• Telegram Interface לשליחת התוצאה

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

שלב 4: חיבור והרצה במערכת

לאחר שהסוכן בונה את ה‑Workflow:

1. חברו את ה‑Trigger (למשל Manual) והריצו בדיקה.
2. בדקו שהנתונים נשלפים נכון — לפעמים הסוכן לא לוקח את הנתונים הנכונים או “לא תופס את הקונספט” עדיין. זה באג צפוי בשלב הזה ודורש שיפור.

שלב 5: טיפול ב‑Credentials (חשוב לאבטחה)

כשהסוכן בונה Workflow הוא בכוונה לא ממלא את ה‑Credentials לבד:

• אתם צריכים להיכנס ל‑Workflow ולהעתיק ידנית את ה‑Credentials (Google, מפתחות, וכל מה שדורש הרשאה).
• זה מכוון ומטעמי אבטחה — לא רוצים למסור לסוכן את כל ה‑Credentials.
• כשהסוכן “מוריד קובץ” שהוא בעצם נקודת API עם ההנחיות, לפעמים הוא לא מציב אותו נכון — בדקו ותקנו ידנית.

טעויות ומגבלות נוכחיות

• הסוכן לא תמיד שולף את הנתונים הנכונים — עדיין לא “תופס” את הקונספט במלואו; בדקו את הפלט.
• מצפים שהסוכן ימלא Credentials אוטומטית — הוא לא, וזה בכוונה; מלאו ידנית.
• משתמשים במודל חלש לבקשות מורכבות — מודל חזק יותר (Claude) נותן תוצאות טובות יותר בבניית Workflows.
• טקסט עברי לפעמים מוצג הפוך בסביבת הסוכן — עניין תצוגה, לא פוגם בלוגיקה.

סיכום וצעדים הבאים

חיברנו סוכן קוד ל‑API של המערכת: יצרנו מפתח API, האכלנו את הסוכן בדוקומנטציה, והוא בנה Skill שמאפשר לו להפיק Workflows אוטומטית. במקום לחפש דוקומנטציה ולבנות ידנית — הסוכן כבר אסף את הידע ובונה בעצמו. השיטה חוסכת חצי מהעבודה, אך עדיין דורשת שיפורים ובקרה ידנית (במיוחד ב‑Credentials). זה הכיוון — ובהמשך נוסיף שכבות אבטחה ושיפורים נוספים.