הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
Agent 365 CLI הוא כלי שורת פקודה חוצה פלטפורמות לפריסה ולניהול של ישומי Agent 365 CLI ב-Azure.
אין צורך להתקין את ה-CLI באופן ידני. ה- בינה מלאכותית-guided setup בודק אם קים CLI, מתקין או מעדכן אותו באופן אוטומטי ומריץ את כל הפקודות הנדרשות עבורך. דף זה משמש כחומר עזר למפתחים שצריכים להתקין או להשתמש ב-CLI ישירות — לדוגמה, בעת בנית אוטומצית CI/CD, פתרון בעיות בשלב מסוים או עבודה ללא סוכן קידוד בינה מלאכותית.
הערה
זרימת העבודה המלאה למפתחים – כולל הגדרה מונחית בחינה מלאכותית, הנחיות לתפקיד ושלבים שלאחר הפריסה – נמצאת במקטע תחילת העבודה עם פיתוח של Agent 365. דף זה הוא חומר העזר עבור CLI: התקנה, עדכון, הסרה, פקודות זמינות ופתרון בעיות.
דרישות מוקדמות
ה-CLI דורש .NET 8.0 ואילך. עבור כל הדרישות המוקדמות האחרות — מנוי Azure, תפקידי Entra הנדרשים ורישום של אפליקצית לקוח מותאמת אישית — ראה בינה מלאכותית-guided setup.
התקנת Agent 365 CLI
השתמש בשלבים הבאים על מנת להתקין את Agent 365 CLI באופן גלובלי במערכת ההפעלה.
דרישות מוקדמות
.NET חיב להיות מותקן. (מומלץ להשתמש ב-.NET 8.0.)
השתמש ב-dotnet tool install
יש להתקין את Agent 365 CLI באמצעות הפקודה הבאה:
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli
לקבלת ההוראות העדכניות ביותר והגרסאות הזמינות, בקר בדף הרשמי של NuGet: Microsoft.סוכןs.A365.DevTools.Cli ב-NuGet.org
אמת את ההתקנה
לאחר התקנת Agent 365 CLI, ודא שהוא הותקן באופן תקין באמצעות הפקודה --help:
a365 -h
פקודה זו מציגה את מידע העזרה ומאשרת שה-CLI מוכן לשימוש.
עדכן
עדכן את Agent 365 CLI באמצעות הפקודה עדכון כלי DotNet:
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
הערה
על מנת לעדכן את Agent 365 CLI, נדרש חיבור לאינטרנט על מנת לקבל גישה אל חבילת NuGet העדכנית ביותר: Microsoft.Agents.A365.DevTools.Cli.
הסרת ההתקנה של
הסרת Agent 365 CLI באמצעות הפקודה הסרת התקנה של כלי DotNet:
dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli
מיקומי קבצים
מיקום ברירת המחדל של קובץ ההפעלה של הכלי תלוי במערכת ההפעלה:
| מערכת הפעלה | נתיב |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
ה-SDK מוסיף מיקום זה ל-path שלך בעת ההפעלה הראשונה. כך תוכל להפעיל כלים גלובלים מכל ספריה מבלי לצין את מיקום הכלי.
הגישה לכלי היא ספציפית למשתמש, ולא גלובלית ברמת המחשב. כלי גלובלי זמין רק למשתמש שמתקין אותו.
פקודות זמינות
לקבלת הרשימה המלאה של הפקודות הזמינות, השתמש בפקודה --help או עין ב-Agent 365 CLI – הפנית לעיון.
עצה
אין צורך להריץ פקודות CLI באופן ידני. ה- בינה מלאכותית-guided setup מבצע אוטומציה של כל זרימת העבודה — התקנת CLI, תצורה, הגדרת blueprint, פריסה ופרסום — באמצעות סוכן קידוד בינה מלאכותית. השתמש בחומר העזר של CLI כאן אם אתה בונה אוטומצית CI/CD, פותר בעיות בשלב מסוים או עובד ללא סוכן קידוד בינה מלאכותית.
לקבלת הוראות מלאות להגדרת סוכן Agent 365 באמצעות CLI, יש לעיין במקטע תחילת העבודה עם פיתוח של Agent 365.
פתרון בעיות
מקטע זה מספק מידע על אופן פתרון שגיאות ב-Agent 365 CLI.
עצה
מדריך פתרון הבעיות של Agent 365 כולל המלצות מתקדמות לפתרון תקלות, שיטות עבודה מומלצות וקישורים לתוכן פתרון תקלות לכל חלק במחזור החיים של פיתוח Agent 365.
בעיות ספציפיות ל-CLI המכוסות במקטע זה:
הסוכן אינו מופיע ב-Teams
פתרון בעיות ביצירת מופעי סוכן: הסוכן אינו מופיע ב-Teams
לא ניתן ליצור מופע של סוכן ב-Teams
פתרון בעיות ביצירת מופעי סוכן: לא ניתן ליצור מופע של סוכן ב-Teams