Agent 365 – מדריך לפתרון בעיות

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

שלבים לפתרון הבעיה

כל אחד מהקישורים בטבלה זו מספק הנחיות לפתרון תקלות עבור תחומים ייעודיים. התוכן מקובץ לפי שלב מחזור החיים של פיתוח Agent 365 SDK.

שלב תוכן של פתרון בעיות
יצירה והפעלה של סוכן Agent 365 CLI
רישום אפליקציית לקוח מותאמת אישית עבור Agent 365 CLI
שרת כלים מדומה
יכולת תצפית על סוכנים
בדיקת סוכנים
בדיקת סוכנים באמצעות Dev Tunnels
הוספה וניהול של כלים
הגדרת תבנית סוכן הגדרת Blueprint של סוכן
פריסה פריסת הסוכן בסביבת Azure
פריסת סוכן בסביבת Amazon Web Services (AWS)
פריסת סוכן בפלטפורמת הענן של Google (GCP)
פרסום הסוכן במרכז הניהול של Microsoft 365 פרסום הסוכן במרכז הניהול של Microsoft
יצירת מופעי סוכן יצירת מופעי סוכן

הפניה לפקודות אבחון

לפני שמעמיקים בבעיות ספציפיות, השתמשו בפקודות אלה כדי לבדוק את המצב הנוכחי של הגדרת Agent 365 שלכם:

בדיקת CLI ותצורה

השתמש בפקודות אלו כדי לאמת את ה-CLI והתצורה שלך.

# Verify CLI is installed and check version
a365 --version

# Display current configuration
Get-Content a365.config.json | ConvertFrom-Json

# Display generated configuration (after setup)
Get-Content a365.generated.config.json | ConvertFrom-Json

אימות משאבי Azure

השתמש בפקודות אלה כדי לבדוק את משאבי Azure ואת מצב האפליקציה.

# Set these variables with appropriate data for your app
$resource-group = <your-resource-group>
$app-name = <your-app-name>

# Authenticate with Azure
az login

# List resources in your resource group
az resource list --resource-group $resource-group --output table

# Check Web App status
az webapp show --name $app-name --resource-group $resource-group --query state

# View Web App logs (real-time)
az webapp log tail --name $app-name --resource-group $resource-group

אימות Blueprint של הסוכן

ודא שה-Blueprint של הסוכן קיימת ומוגדרת כראוי.

# Check if blueprint ID is set
Get-Content a365.generated.config.json | Select-String "agentBlueprintId"

אימות blueprint ב-Microsoft Entra

  1. עבור אל https://entra.microsoft.com>רישום האפליקציה>כל היישומים.
  2. חפש את agentBlueprintId.

שיטות מניעה מומלצות

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

לפני שתתחיל

רשימת דרישות מוקדמות:

✅ NET 8.0 SDK. מותקן
✅ Azure CLI מותקן ומאומת
✅ הרשאות Entra נדרשות הוקצו
✅ אפליקציית לקוח מותאמת אישית נוצרה והוגדרה
✅ הדייר מופעל עבור Microsoft Agent 365 Frontier

פקודות אימות:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

במהלך הפיתוח

שמירת תצורת קו הצינור:

  • שמור גיבויים של קובצי התצורה.
  • תעד את ההגדרות שבחרת.
  • שמור את המזהים שנוצרו, כגון מזהה Blueprint ומזהה זהות מנוהלת.

המשך העדכון של CLI:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

בדיקה בהדרגה:

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

לפני הפריסה

רשימת פעולות לפני ביצוע פריסה

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

קבלת עזרה נוספת

כדי לעיין בקוד לדוגמה, לדווח על בעיות או לחפש בעיות קיימות, השתמש במאגרים הבאים:

  • Last updated on