בדיק, פרוס ואינטגרציה של סוכנים

  • 9 דקות

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

אסטרטגיות בדיקה לסוכנים

בדיקות יסודיות מבטיחות שהסוכנים שלך יתנהגו באופן אמין במגוון תרחישים לפני ההגעה למשתמשים. גם פורטל Foundry וגם ההרחבה של Visual Studio Code מספקים מגרשי משחקים לבדיקות אינטראקטיביות.

שימוש יעיל במגרש המשחקים:

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

לתעד תוצאות בדיקות כדי לעקוב אחרי שיפורים ולתפוס רגרסיות.

פריסת סוכנים לפרויקט שלך

Microsoft Foundry תומך בפריסת סוכנים מהפורטל או מ-Visual Studio Code. פריסה שומרת את תצורת הסוכן שלך לפרויקט Foundry כדי שתוכל לבדוק ולשדרג.

פריסה מפורטל ה-Foundry

  1. נווט לסוכן שלך בפורטל Foundry
  2. אמת שהקונפיגורציה ותוצאות הבדיקה מספקות
  3. בחר שמירה מדף הסוכן
  4. אשר את הגדרות הגרסה והפריסה

פריסה מתוך Visual Studio Code

  1. פתח את הסוכן שלך בערכת הכלים של הבינה המלאכותית
  2. בחר שמור ל-Foundry כדי לדחוף שינויים בתצורה
  3. לסוכנים מאוחסנים, פתח את תפריט +Build בכלי הפיתוח ובחר Deploy to Microsoft Foundry
  4. בחר את תצורת המכולה שלך ואשר

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

סוכני הוצאה לאור לנקודת קצה

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

מה ההוצאה לאור יוצרת

כשאתה מפרסם גרסת סוכן, Foundry יוצרת:

  • יישום סוכן - משאב Azure עם כתובת קריאה משלו, מדיניות אימות וזהות סוכן Entra.
  • פריסה - מופע רץ של גרסת סוכן ספציפית בתוך היישום, עם ניהול מחזור חיים/התחלה/עצירה.

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

פרסום מפורטל Foundry

  1. בפורטל, בחר את גרסת הסוכן שברצונך לפרסם
  2. בחר פרסום כדי ליצור את יישום הסוכן והפריסה

הוצאה לאור מתוך Visual Studio Code

  1. פתח את פלטת הפקודות (Ctrl+Shift+P) והפעיל את Microsoft Foundry: Deploy Hosted Agent עבור סוכנים מאוחסנים
  2. בחר את תצורת מרחב העבודה והמכולה היעד
  3. אישור ופריסה

לאחר הפרסום, הסוכן מופיע בחלק Hosted Agents (תצוגה מקדימה) בתצוגת עץ ההרחבה של AI Toolkit.

נקודת הסיום של יישום הסוכן

סוכנים שפורסמו חושפים נקודת קצה יציבה באמצעות פרוטוקול Responses API:

https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>/applications/<app-name>/protocols/openai/responses

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

אימות וזהות

יישומי סוכנים משתמשים ב-Microsoft Entra ID לאימות. המתקשרים חייבים להחזיק בתפקיד משתמש Azure AI במשאב יישום הסוכנים. אימות מפתחות API אינו נתמך עבור יישומי סוכן.

חשוב

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

אימות נקודת הקצה

לאחר הפרסום, ודאו שהקצה עובדת:

  1. קבל אסימון גישה:

    az account get-access-token --resource https://ai.azure.com

  2. התקשר לנקודת הקצה של אפליקציית הסוכן:

    curl -X POST \
  "https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>/applications/<app-name>/protocols/openai/responses?api-version=2025-11-15-preview" \
  -H "Authorization: Bearer <access-token>" \
  -H "Content-Type: application/json" \
  -d '{"input":"Say hello"}'

אם קיבלת 403 Forbidden, וודא שלמתקשר יש את תפקיד משתמש Azure AI במשאב Agent Application.

עדכון סוכנים שפורסמו

כדי להשיק גרסה חדשה של סוכן:

  1. בצע שינויים בסביבת הפיתוח שלך ובדוק היטב
  2. בפורטל Foundry, בחר פרסום עדכונים ממשחק הסוכנים
  3. אפליקציית הסוכן מנתבת אוטומטית 100% תעבורה לגרסה החדשה

כתובת ה-URL של נקודת הקצה נשארת ללא שינוי, כך שהאינטגרציות הקיימות ממשיכות לעבוד.

יצירת קוד אינטגרציה

ההרחבה Microsoft Foundry VS Code מייצרת קוד אינטגרציה לדוגמה כדי לחבר את היישום שלך לסוכן שפורסם:

  1. בחר את הסוכן המוצב שלך בתצוגת My Resources
  2. בחר קוד תצוגה
  3. בחר את התיקייה שלך
  4. ההרחבה מייצרת קוד לאימות, חיבור, שליחת הודעות ועיבוד תגובות

תבניות של אינטגרציה

דפוסים נפוצים לשילוב סוכנים שפורסמו כוללים:

  • יישומי ווב - שלחו הודעות משתמש לנקודת הקצה של Responses API והציגו תגובות בממשק המשתמש שלכם. אחסן היסטוריית שיחות בצד הלקוח לאינטראקציות מרובות תורות.
  • תהליכי עבודה מונעי API - קראו לנקודת הקצה של הסוכן משירותי backend שמופעלים על ידי אירועים או לוחות זמנים. מעבד תגובות באופן פרוגרמטי כדי להניע פעולות במורד הזרם.
  • ממשקי צ'אטבוט - מיפוי סשנים של המשתמש לשיחות. לטפל בהחלפת הודעות בזמן אמת דרך נקודת הקצה.
  • אוטומציה ברקע - תזמון קריאות לסוכן למשימות חזרות. הזנת נתוני מערכת לסוכנים ופלטי תהליכים כדי לעדכן מערכות עסקיות.

שיקולי ייצור

הפעלת סוכנים בייצור דורשת תשומת לב למספר תחומי תפעול:

  • ניטור - מעקב אחר זמני תגובה, שיעורי הצלחה בהפעלת כלים, דפוסי שגיאה וצריכת טוקנים באמצעות אינטגרציה של Application Insights
  • אבטחה - השתמש בזהויות מנוהלות לאימות, החל גישה עם הרשאות מינימליות, והגדר מדיניות שמירת נתונים.
  • ניהול עלויות - מעקב אחרי השימוש בטוקנים, קביעת מגבלות אורך תגובה, ויישום הגבלת קצב כדי למנוע קפיצות בלתי צפויות.
  • טיפול בשגיאות - יישום לוגיקת ניסיון חוזר עם הפסקה אקספוננציאלית לכשלים זמניים. טפל בהגבלת ריבית באמצעות אסטרטגיות נסיגה. אמת קלטים לפני ששולחים לסוכנים.
  • ניהול שיחות - נקודות קצה של יישום סוכן תומכות כיום רק ב-API Responses ללא stateless. שמור את היסטוריית השיחות אצל הלקוח שלך לחוויות מרובות תורות.