התקן את Microsoft Copilot Studio ההרחבה עבור Microsoft Visual Studio Code

‏‫דרישות מוקדמות‬

לפני התקנת Microsoft Copilot Studio ההרחבה Microsoft Visual Studio Code, ודא שאתה עומד בדרישות הבאות:

דרישות המערכת

  • מערכת הפעלה:
    • Windows (ארכיטקטורת x64)
      • Windows 10 גירסה 1809 ואילך
      • Windows 11 (כל גירסה)
    • macOS
  • Visual Studio Code: גירסה 1.80 ואילך (הגירסה היציבה העדכנית ביותר מומלצת)
  • חיבור לאינטרנט: נדרש להתקנה ולאימות

דרישות חשבון

  • חשבון Microsoft: חשבון Microsoft פעיל עם רישיון או גישה ל-Copilot Studio
  • Copilot Studio license: רשיון מתאים שהוקצה לחשבון שלך
  • Environment access: הרשאות גישה לסביבה Copilot Studio אחת לפחות
  • הרשאות סוכן: גישה לקריאה וכתיבה לסוכנים שבכוונתך לערוך

שלבי התקנה

קיימות שתי דרכים להתקנת Copilot Studio ההרחבה Visual Studio Code:

  • התקן מתוך Visual Studio Code
  • התקנה מאתר האינטרנט של Visual Studio Code Marketplace

שיטה 1: התקנה מ-Visual Studio Code

  1. בחר את סמל הרחבות בסרגל הפעילות או הקש Ctrl+Shift+Xעל . החלונית Extensions נפתחת ב- Visual Studio Code.

  2. בסרגל החיפוש, הזן "Copilot Studio". חפש את Copilot Studio הרשמי ברשימת התוצאות. ודא כי המפרסם הוא "Microsoft".

  3. לאחר שתמצא את ההרחבה הנכונה, בחר אותה כדי לפתוח את דף פרטי ההרחבה.

  4. בחר התקן כדי להתחיל בהתקנה.

  5. המתן להשלמת ההתקנה. ייתכן שתראה בקשה לטעון מחדש Visual Studio Code, במקרה זה, בחר Reload כאשר תתבקש לעשות זאת.

  6. אמת את ההתקנה. חפש את Copilot Studio הסמל בסרגל הפעילות. הסמל מופיע עם מיתוג Copilot Studio חדש.

שיטה 2: התקנה מאתר האינטרנט Visual Studio Code Marketplace

  1. עבור אל https://marketplace.visualstudio.com/ וחפש את "Copilot Studio". באפשרותך גם להשתמש בקישור הישיר: https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio.

  2. בחר התקן בדף Marketplace. ייתכן שהנחיות הדפדפן יבקשו ממך להוריד Visual Studio Code לפני שהוא יבקש ממך לפתוח את Visual Studio Code.

  3. אפשר לדפדפן לפתוח את Visual Studio Code ולאאשר את ההתקנה על-ידי חיפוש סמל ההרחבה בסרגל הפעילות.

קביעת תצורה ראשונית

הפעלה ראשונה

  1. בחר Copilot Studio הסמל בסרגל הפעילות. ההרחבה נפתחת כחלונית יישום. מוצגת הודעה מוקפצת, המציינת כי נדרש להיכנס לחשבון על מנת להשתמש בהרחבת Copilot Studio.

  2. בחר היכנס בחלון המוקפץ ולאחר מכן בחר אפשר. ברירת המחדל שלך נפתח לדף אימות של Microsoft.

  3. הזן את אישורי האימות שלך והשלם כל אימות רב-גורמי במידת הצורך.

  4. סקור את ההרשאות המבוקשות:

    • קריאה וכתיבה של סוכני Copilot Studio
    • גישה למידע אודות הסביבה
    • סינכרון קבצים לענן

    בחר קבל אואפשר. הדפדפן מבקש ממך לסגור את החלון ולחזור Visual Studio Code.

  5. חזור אל Visual Studio Code. חלונית ההרחבה תטען את הסביבות שיש לך גישה אליהם ואת הסוכנים בסביבות אלה.

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

לאחר האימות, אתה אמור לראות מבנה תחת החלונית Agents בתוך הסיומת Copilot Studio ב- Visual Studio Code. אתה אמור לראות רשימה של קבוצות סביבה, עם סוכנים וסביבות מקוננות, בדומה למבנה הבא:

AGENTS
  └─ Environment Group (for example, developer, default, sandbox, production)
      ├─ Example Environment 1
      │   ├─ Agent 1
      │   └─ Agent 2
      └─ Example Environment 2
          └─ Agent 3

פתרון בעיות בהתקנה

להלן שלבים לפתרון בעיות עבור כמה בעיות שעשויות להתרחש בעת התקנה או קביעת תצורה של Copilot Studio Visual Studio Code ההרחבה.

ההרחבה אינה מופיעה

Problem: סמל Copilot Studio אינו מופיע בסרגל הפעילות.

פתרון:

  1. טעינה מחדש של Visual Studio Code
  2. בחר הרחבות וחפש את ההרחבה ברשימה מותקן . ודא שההרחבה אינה מושבתת.
  3. עדכן Visual Studio Code לגירסה העדכנית ביותר.
  4. התקן מחדש את ההרחבה.

כשלי אימות

בעיה: האימות נכשל או מבצע לולאות שוב ושוב.

פתרון:

  1. נקה את מטמון הדפדפן וקבצי ה- Cookie עבור microsoft.com.

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

  3. השבת הרחבות דפדפן שעלולות לחסום אימות.

  4. בדוק את הגדרות חומת האש של החברה וה- Proxy.

  5. ודא שאתה משתמש בסוג חשבון נתמך.

ההרחבה לא נמצאה ב Visual Studio Code marketplace

Problem: לא מצליח למצוא את הסיומת Copilot Studio בעת החיפוש.

פתרון:

  1. ודא שאתה מחפש בחלונית ' הרחבות ', ולא בחיפוש באינטרנט.

  2. בדוק את האיות: "Copilot Studio".

  3. פנה למנהל המערכת כדי לראות אם הארגון שלך מגביל את Visual Studio Code Marketplace שלך.

הסרת ההתקנה של ההרחבה

כדי להסיר את ההרחבה:

  1. פתח את החלונית הרחבות.

  2. חפש Copilot Studio בהרחבות המותקנות.

  3. ברשומה ברשימה, בחר ניהול (סמל גלגל שיניים) ולאחר מכן >.

  4. טען Visual Studio Code מחדש כאשר תתבקש לעשות זאת.

הערה

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

‏‫השלבים הבאים‬

לאחר התקנת ההרחבה Copilot Studio, אתה מוכן לבצע את הפעולות הבאות:

  • Last updated on