ai-agents-for-beginners

הגדרת הקורס

מבוא

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

הצטרפות ללומדים אחרים וקבלת עזרה

לפני שתתחילו לשכפל את המאגר שלכם, הצטרפו לערוץ AI Agents For Beginners ב-Discord כדי לקבל עזרה בהגדרות, לשאול שאלות על הקורס או להתחבר ללומדים אחרים.

שכפול או יצירת מזלג למאגר זה

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

ניתן לעשות זאת על ידי לחיצה על הקישור ליצירת מזלג למאגר.

כעת אמורה להיות לכם גרסה משלכם של הקורס בקישור הבא:

מאגר עם מזלג

שכפול רדוד (מומלץ לסדנאות / Codespaces)

המאגר המלא יכול להיות גדול (~3 GB) כאשר מורידים את כל ההיסטוריה וכל הקבצים. אם אתם רק משתתפים בסדנה או זקוקים רק לכמה תיקיות שיעורים, שכפול רדוד (או שכפול חלקי) מונע את רוב ההורדה הזו על ידי קיצור ההיסטוריה ו/או דילוג על קבצים.

שכפול רדוד מהיר — היסטוריה מינימלית, כל הקבצים

החליפו <your-username> בפקודות למטה עם כתובת ה-URL של המזלג שלכם (או כתובת ה-URL המקורית אם אתם מעדיפים).

כדי לשכפל רק את ההיסטוריה של ההתחייבות האחרונה (הורדה קטנה):

git clone --depth 1 https://github.com/<your-username>/ai-agents-for-beginners.git

כדי לשכפל ענף מסוים:

git clone --depth 1 --branch <branch-name> https://github.com/<your-username>/ai-agents-for-beginners.git

שכפול חלקי (ספראסי) — קבצים מינימליים + רק תיקיות נבחרות

זה משתמש בשכפול חלקי וב-sparse-checkout (דורש Git 2.25+ ומומלץ להשתמש בגרסת Git מודרנית עם תמיכה בשכפול חלקי):

git clone --depth 1 --filter=blob:none --sparse https://github.com/<your-username>/ai-agents-for-beginners.git

עברו לתיקיית המאגר:

עבור bash:

cd ai-agents-for-beginners

עבור Powershell:

Set-Location ai-agents-for-beginners

לאחר מכן ציינו אילו תיקיות אתם רוצים (הדוגמה למטה מראה שתי תיקיות):

git sparse-checkout set 00-course-setup 01-intro-to-ai-agents

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

עבור Linux/macOS:

rm -rf .git

עבור Windows:

Remove-Item -Recurse -Force .git

שימוש ב-GitHub Codespaces (מומלץ להימנע מהורדות גדולות מקומיות)

טיפים

הפעלת הקוד

הקורס מציע סדרת מחברות Jupyter שתוכלו להפעיל כדי לקבל ניסיון מעשי בבניית סוכני AI.

דוגמאות הקוד משתמשות באחת מהאפשרויות הבאות:

דורש חשבון GitHub - חינם:

1) Semantic Kernel Agent Framework + GitHub Models Marketplace. מסומן כ-(semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace. מסומן כ-(autogen.ipynb)

דורש מנוי Azure: 3) Azure AI Foundry + Azure AI Agent Service. מסומן כ-(azureaiagent.ipynb)

אנו ממליצים לכם לנסות את כל שלושת סוגי הדוגמאות כדי לראות מה עובד הכי טוב עבורכם.

האפשרות שתבחרו תקבע אילו שלבי הגדרה תצטרכו לבצע בהמשך:

דרישות

הוספנו קובץ requirements.txt בתיקיית השורש של מאגר זה שמכיל את כל חבילות ה-Python הנדרשות להפעלת דוגמאות הקוד.

תוכלו להתקין אותן על ידי הרצת הפקודה הבאה בטרמינל בתיקיית השורש של המאגר:

pip install -r requirements.txt

אנו ממליצים ליצור סביבת Python וירטואלית כדי להימנע מכל קונפליקטים ובעיות.

הגדרת VSCode

ודאו שאתם משתמשים בגרסת Python הנכונה ב-VSCode.

תמונה

הגדרה לדוגמאות באמצעות GitHub Models

שלב 1: קבלת GitHub Personal Access Token (PAT)

קורס זה משתמש ב-GitHub Models Marketplace, המספק גישה חינמית למודלים של שפה גדולה (LLMs) שתשתמשו בהם לבניית סוכני AI.

כדי להשתמש במודלים של GitHub, תצטרכו ליצור GitHub Personal Access Token.

ניתן לעשות זאת על ידי מעבר להגדרות Personal Access Tokens בחשבון ה-GitHub שלכם.

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

  1. בחרו באפשרות Fine-grained tokens בצד שמאל של המסך על ידי מעבר להגדרות מפתחים.

    לאחר מכן בחרו Generate new token.

    יצירת טוקן

  2. הזינו שם תיאורי לטוקן שלכם שמשקף את מטרתו, כך שיהיה קל לזהות אותו מאוחר יותר.

    🔐 המלצה על משך זמן הטוקן

    משך זמן מומלץ: 30 ימים עבור אבטחה גבוהה יותר, תוכלו לבחור תקופה קצרה יותר—כמו 7 ימים 🛡️ זו דרך מצוינת להציב לעצמכם יעד אישי ולהשלים את הקורס תוך שמירה על המומנטום שלכם 🚀.

    שם הטוקן ותאריך תפוגה

  3. הגבילו את היקף הטוקן למזלג של מאגר זה.

    הגבלת היקף למאגר עם מזלג

  4. הגבלות הרשאות הטוקן: תחת Permissions, לחצו על לשונית Account, ולאחר מכן לחצו על כפתור “+ Add permissions”. תופיע תפריט נפתח. חפשו Models וסמנו את התיבה עבורו. הוספת הרשאת מודלים

  5. ודאו את ההרשאות הנדרשות לפני יצירת הטוקן. ודאו הרשאות

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

העתיקו את הטוקן החדש שיצרתם זה עתה. כעת תוסיפו אותו לקובץ .env הכלול בקורס זה.

שלב 2: יצירת קובץ .env

כדי ליצור את קובץ ה-.env שלכם, הריצו את הפקודה הבאה בטרמינל.

cp .env.example .env

זה יעתיק את קובץ הדוגמה וייצור קובץ .env בתיקייה שלכם, שם תמלאו את הערכים עבור משתני הסביבה.

עם הטוקן שהעתקתם, פתחו את קובץ ה-.env בעורך הטקסט המועדף עליכם והדביקו את הטוקן בשדה GITHUB_TOKEN. שדה טוקן GitHub

כעת תוכלו להפעיל את דוגמאות הקוד של הקורס.

הגדרה לדוגמאות באמצעות Azure AI Foundry ו-Azure AI Agent Service

שלב 1: קבלת נקודת הקצה של פרויקט Azure שלכם

עקבו אחר השלבים ליצירת hub ופרויקט ב-Azure AI Foundry שנמצאים כאן: סקירת משאבי Hub

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

ניתן לעשות זאת על ידי מעבר לדף סקירה כללית של הפרויקט שלכם בפורטל Azure AI Foundry.

מחרוזת חיבור לפרויקט

שלב 2: יצירת קובץ .env

כדי ליצור את קובץ ה-.env שלכם, הריצו את הפקודה הבאה בטרמינל.

cp .env.example .env

זה יעתיק את קובץ הדוגמה וייצור קובץ .env בתיקייה שלכם, שם תמלאו את הערכים עבור משתני הסביבה.

עם הטוקן שהעתקתם, פתחו את קובץ ה-.env בעורך הטקסט המועדף עליכם והדביקו את הטוקן בשדה PROJECT_ENDPOINT.

שלב 3: התחברות ל-Azure

כחלק מהמלצות אבטחה, נשתמש ב-אימות ללא מפתח כדי לאמת ל-Azure OpenAI עם Microsoft Entra ID.

לאחר מכן, פתחו טרמינל והריצו az login --use-device-code כדי להתחבר לחשבון Azure שלכם.

לאחר שהתחברתם, בחרו את המנוי שלכם בטרמינל.

משתני סביבה נוספים - Azure Search ו-Azure OpenAI

עבור שיעור Agentic RAG - שיעור 5 - יש דוגמאות שמשתמשות ב-Azure Search ו-Azure OpenAI.

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

דף סקירה כללית (פרויקט)

מרכז ניהול

דף מודלים + נקודות קצה

פורטל Azure

דף חיצוני

הגדרת אימות ללא מפתח

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

from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential

נתקעתם איפשהו?

אם יש לך בעיות בהפעלת ההגדרות הללו, הצטרף ל-Azure AI Community Discord שלנו או צור בעיה חדשה.

השיעור הבא

כעת אתה מוכן להפעיל את הקוד עבור הקורס הזה. למידה מהנה על עולם סוכני הבינה המלאכותית!

מבוא לסוכני בינה מלאכותית ושימושים אפשריים


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