שכפל את סוכן Microsoft Copilot Studio שלך ב- Microsoft Visual Studio Code

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

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

לפני שתתחיל בשכפול סוכנים, קיימים כמה דרישות מוקדמות ושיקולים חשובים.

בחר מיקום סביבת עבודה

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

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

הבנת מה משוכפל

כאשר אתה משכפל סוכן, קבצי הסוכן משוכפלים באופן מקומי במיקום שאתה בוחר, יוצר הגדרת מבנה כמו אלה בסייר Visual Studio Code הבא:

my-agent/
├── actions                   # Connectors
│   ├── DevOpsAction.mcs.yml  
│   └── GetItems.mcs.yml      
├── knowledge/files                # Knowledge sources
│   ├── source1.yaml
│   └── source2.yaml
├── topics/                   # Conversation topics
│   ├── greeting.mcs.yaml
│   ├── help.mcs.yaml
│   └── escalate.mcs.yaml
├── workflows/                    # Agent tools and actions
│   └── GetDevOpsItems
│       ├── metadata.yaml
│       └── workflow.json
│   └── GetMeetings
│       ├── metadata.yaml
│       └── workflow.json
├── trigger/                 # Event triggers
│   └── welcometrigger.mcs.yaml
├── agent.mcs.yaml                # Main agent definition
├── icon.png                      # Icon used for the agent, visible in test panel and in supported channels
├── settings.mcs.yml              # Configuration settings for the agent
└── connectioreferences.mcs.yml   # Connection References used by Connectors and other actions

שיטות שכפול

אם אתה משתמש בהרחבה בפעם הראשונה, או אפילו בגירסה חדשה ב- Visual Studio Code, הדרך הקלה ביותר לשכפל סוכן היא לבחור את קיף סוכן כאשר החלונית Extension פתוחה. עם זאת, אפשרות זו אינה זמינה כאשר כבר יש לך סוכן משוכפל ופתוח באופן מקומי. ניתן להשתמש בשיטות הבאות במקום זאת:

זוהי השיטה הנפוצה והמומלץ ביותר לשכפול סוכן.

  1. פתח את ההרחבה Copilot Studio על ידי בחירת הסמל של Copilot Studio בסרגל הפעילות. באפשרותך גם להקיש Ctrl+Shift+P ולהזין "Copilot Studio: התמקד בתצוגת סוכנים". החלונית Copilot Studio תיפתח בסרגל הצידי.

  2. בחלונית סוכנים , בחר את סביבת היעד שלך מהרשימה הנפתחת (לדוגמה, "סביבה 1") כדי לראות רשימה של הסוכנים בסביבה.

    > Environment 1
  Environment 2
  Environment 3

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

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    נפתחת תיבת דו-שיח של בורר קבצים.

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

  5. המתן להשלמת תהליך השכפול. מופיעה הודעת התקדמות המציגה "סוכן שכפול: בוט תמיכת לקוחות" ולאחר מכן הודעת הצלחה "סוכן משוכפל בהצלחה". תהליך זה נמשך בדרך כלל 10-30 שניות.

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

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

השתמש בשיטה זו אם אתה מעדיף זרימות עבודה ממוקדות בלוח המקשים.

  1. פתח את לוח הפקודות על-ידי הקשה על Ctrl+Shift+P.

  2. הקלד "Copilot Studio: Clone Agent" והקש Enter. הפקודה מתבצעת ומופיעות הנחיות.

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

שיטה 3: שכפל באמצעות כתובת URL של סוכן

שיטה זו שימושית כאשר מישהו משתף כתובת URL של סוכן איתך.

  1. פתח את הסוכן שלך בפורטל האינטרנט Copilot Studio שלך.

  2. בחר הגדרות פרטי>סוכן, והעתק את כתובת ה- URL של הסוכן. כתובת ה- URL אמורה לכלול את התבנית: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. כתובת ה- URL נמצאת כעת בלוח שלך.

  3. חזור אל Visual Studio Code ופתח את Copilot Studio ההרחבה.

  4. בחר שכפל סוכן. ההרחבה מזהה את כתובת ה- URL בלוח שלך ומציגה את הסוכן המסומן כ- "(מהלוח)".

  5. בחר את הסוכן המסומן "(מהלוח)," בחר תיקיית יעד והמתן להשלמת השכפול. הסוכן משוכפל למיקום שבחרת.

תרחישי שכפול נפוצים

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

תרחיש 1: שכפול לפיתוח סולו

המטרה: לעבוד על סוכנות בעצמך

  1. שכפל את הסוכן לתיקיה מקומית.

  2. אתחל מאגר Git מתוך בקרת מקור בניווט.

  3. בצע שינויים באופן מקומי.

  4. בצע את התחייבות שלך.

  5. החל את השינויים על Copilot Studio כאשר תהיה מוכן.

תרחיש 2: שכפול לשיתוף פעולה בצוות

המטרה: מפתחים מרובים עובדים על אותו סוכן

  1. המפתח הראשון משכפל את הסוכן.

  2. המפתח הראשון מאתחל את Git ודחף את התוכן למאגר משותף (GitHub, Azure DevOps).

  3. מפתחים אחרים משכפלים מהמאגר המשותף של Git.

  4. כל מפתח מפעיל Copilot Studio: חבר מחדש את הסוכן כדי לחבר את התיקיה המקומית שלו Copilot Studio.

  5. הצוות משתמש ב- Git לשיתוף פעולה ולעקוב אחר שינויים, ומשתמש Visual Studio Code ההרחבה כדי לעבוד על הסוכן.

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

תרחיש 3: שכפול בסביבות מרובות

המטרה: ניהול גירסאות פיתוח, בדיקה וייצור

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

  1. שכפל את הסוכן מתוך סביבת הפיתוח לתיקיה של פיתוח מקומי.

  2. בצע שינויים בתיקיה פיתוח.

  3. החל שינויים אלה ובדוק את השינויים באותה סביבה.

  4. השתמש Copilot Studio: חבר מחדש סוכן כדי לחבר את הסוכן לסביבה החלופית.

  5. בדוק את הסוכן בחלונית הבדיקה של Copilot Studio.

שיטות עבודה מומלצות

לעשות

  • שכפל את כל הסוכנים למיקום אחיד.
  • אתחל את Git מיד לאחר השכפול.
  • השתמש בשם תיקיה בעל משמעות.
  • ודא כי השכפול פועל לפני ביצוע שינויים.
  • שמור על גיבוי המיקום המשוכפל שלך (לדוגמה, GitHub או Azure DevOps).
  • תועד את המיקום המשוכפל שלך ב- Wiki הפנימי של הצוות או במסמכים שלך.

אל

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

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

לאחר שתשכפל את הסוכן שלך:

  • Last updated on