חיבור מודל AI למערכת דרך OpenRouter — מדריך למתחילים

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

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

עד סוף המדריך יהיה לכם מודל AI מחובר ועובד, וזרימת עבודה בסיסית שמחזירה תשובה אמיתית מהמודל.

שלב 1: הרשמה ל‑OpenRouter

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

• היכנסו לאתר openrouter.ai והירשמו (כרגע ההתחברות היא דרך חשבון Google).
• הוסיפו קרדיט לחשבון — מומלץ להתחיל עם סכום קטן, למשל 5 דולר. תמיד אפשר להוסיף עוד בהמשך לפי הצורך.

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

לאחר ההרשמה ניגשים לאזור מפתחות ה‑API:

1. לחצו על Create Key ותנו למפתח שם כלשהו (השם לא משנה).
2. OpenRouter מאפשר להגביל את הקרדיט לכל מפתח — אפשר להגדיר תקרה, למשל דולר אחד, כדי לשלוט בהוצאות.
3. את שדה ה‑Expiration אפשר להשאיר ריק.
4. לחצו Create והעתיקו את המפתח — נשתמש בו מיד בשלב הבא.

שלב 3: הגדרת Credential במערכת

עכשיו נחזור למערכת ונחבר את המפתח:

1. צרו Credential חדש ותנו לו שם מזהה, למשל test ai.
2. בחרו את הספק OpenRouter.
3. הדביקו בשדה המתאים את מפתח ה‑API שהעתקתם מ‑OpenRouter.
4. שמרו. עכשיו יש למערכת חיבור פעיל אל המודלים.

שלב 4: בניית ה‑Workflow הראשון

ניצור זרימת עבודה חדשה (New Workflow) ונבחר בה את המודל:

• בחרו את רכיב OpenRouter והגדירו את ה‑Connection ל‑Credential שיצרתם (test ai).
• בחרו מודל מתוך הרשימה. בהמשך ייתוספו עוד מודלים לבחירה.
• מלאו את השדות הבסיסיים: System Prompt (הנחיה כללית למודל) ו‑User Prompt (מה שתרצו לשאול).
• שמרו והריצו הרצת בדיקה (Run).

בדיקה ידנית לפני הרצה מלאה

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

חיבור כמה מודלים במקביל

אפשר לחבר יותר ממודל אחד לאותה זרימה ולהשוות ביניהם. למשל: רכיב אחד עם GPT‑4, רכיב נוסף עם מודל אחר (כמו Gemini), וכך אפשר להחליף בין המודלים בקלות ולראות איזו תשובה מתאימה יותר לצורך שלכם.

טעויות נפוצות

• שוכחים להוסיף קרדיט ב‑OpenRouter — בלי קרדיט המודל לא יחזיר תשובה. ודאו שיש יתרה בחשבון.
• בוחרים מודל יקר מדי לבדיקות — להתחלה עדיף מודל זול/בסיסי; מעבירים למודל חזק יותר רק כשצריך.
• מדלגים על בדיקה ידנית — הרצת רכיב בודד לפני הזרימה המלאה חוסכת זמן איתור תקלות.

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

חיברנו מודל AI למערכת דרך OpenRouter, יצרנו מפתח API ו‑Credential, ובנינו זרימת עבודה ראשונה שמחזירה תשובה. מכאן אפשר להתקדם: להוסיף מודלים נוספים, לשחק עם ה‑System Prompt, ולחבר את המודל ל‑Agent לזרימות מתקדמות יותר.