תחילת הפיתוח עם Agent 365

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

סוגי סוכנים

לפני שתתחיל, שאל את עצמך: איזה סוג של סוכן אני בונה?

קימים שני סוגי סוכנים בהתאם לסוג הגישה שיש להם:

סוג הסוכן ‏‫‏‫מבט כולל
סוכנים פועלים בשם משתמש עם גישה מואצלת, או פועלים כישום עם הרשאות מוגבלות להיקף. רשומים כישומי Microsoft Entra או כתוכניות זהות של סוכנים.
עמית בינה מלאכותית פועלים באמצעות זהות המשתמש שלהם ב-Microsoft 365, כולל תיבת דואר, נוכחות ב-Teams ורשומת ספריה. סוג זה של סוכן זמין רק עבור דירים המשתתפים בתוכנית התצוגה המקדימה של Frontier.

סוכנים

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

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

תרחישים לדוגמה:

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

בסיס הזהות:

באופן מסורתי, רושמים סוכנים כישומי Microsoft Entra. גישה זו ממשיכה לפעול. בהמשך, ניתן גם ליצור סוכנים במזהה סוכן Microsoft Entra באמצעות תוכנית זהות של סוכן - ההגדרה המאושרת על-ידי צוות ה-IT, שנאכפת באמצעות הגדרות פיקוח לגבי יכולות הסוכן, גישה מותרת לכלים ומגבלות התאימות. בניה על בסיס תוכנית היא הנתיב המומלץ עבור סוכנים חדשים. היא מאפשרת גישה מנוהלת לכלי Work IQ, הגנת נתונים של Microsoft Purview, ניטור איומים של Microsoft Defender וממשל של Entra מזהה - והופכת את הסוכן שלך לזהות ארגונית המנוהלת באופן מלא מהיום הראשון. אם משתמשי הסוכן נכנסים דרך ספק זהויות של צד שלישי, עיין במקטע שילוב של מזהה סוכן Microsoft Entra עם ספקי זהויות שמהווים צדדים שלישיים.

עמית בינה מלאכותית

חשוב

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

עמית בינה מלאכותית פועל ב-Microsoft 365 באמצעות זהות הסוכן שלו. ניתן להקצות לו יכולות כגון שליחה וקבלה של דואר אלקטרוני באמצעות תיבת הדואר שלו, השתתפות בשיחות 1:1 ובשיחות קבוצתיות ב-Teams, והופעה במטא-נתונים של הספריה והארגון עם שיוך למנהל שהוקצה. אנשים יכולים לקים איתו אינטראקציה באמצעות נקודות כניסה מוכרות של Microsoft 365 כגון @mentions, דואר אלקטרוני, הזמנות ליומן ו-Teams chat.

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

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

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

תרחישים לדוגמה:

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

בסיס הזהות:

מבוסס על תוכנית זהויות סוכנים, שיוצרת מזהה סוכן Microsoft Entra וחשבון משתמש משויך: נדרש תמיד.

הוספת יכולות הדרגתיות של Agent 365

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

מדוע לבנות על בסיס תוכנית זהות של סוכן?

כאשר אתה יוצר תוכנית זהות של סוכן, Agent 365 CLI מקצה מזהה סוכן Microsoft Entra עבור הסוכן – זהות מהשורה הראשונה בדייר, שכפופה לאותן מדיניות פיקוח ארגונית כמו משתמשים אנושים. זהות יחידה זו היא הבסיס ליתרונות האבטחה הזורמים באופן אוטומטי לכל סוכן המבוסס על תוכנית:

יתרון המשמעות עבור הסוכן שלך
ניהול מזהה Microsoft Entra ID מחזור החים של הזהות והגישה של הסוכן מנוהל באמצעות אותם מנגנוני Conditional Access, הגנת זהות וביקורות גישה החלים על משתמשים אנושים.
Microsoft Purview כל אינטראקצית נתונים שהסוכן מבצע כפופה לתוויות הרגישות, למדיניות ה-DLP ולמדיניות השמירה של הדיר שלך - באופן אוטומטי, ללא קוד נוסף.
Microsoft Defender התנהגות הסוכן מנוטרת באופן רציף לאיתור חריגות ואיומים. פעילות חשודה מפעילה את אותן התראות ותהליכי תגובה כמו עבור כל משתמש בדיר.

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

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

יכולת סוכן מנוע מותאם אישית של Microsoft 365 כל שאר הסוכנים 1
רישום ✓ 2 ✓
תצפיתיות ✓ ✓
Work IQ ✓ ✓
עמית בינה מלאכותית ✓ 3 ✓ 3

1 סוכנים הרשומים כיום כישומי Microsoft Entra חיבים תחילה ליצור תוכנית זהות של סוכן על מנת להתחיל להשתמש בכל יכולת בעמודה זו.

2 סוכני Microsoft 365 עם מנוע בהתאמה אישית כבר רשומים באמצעות רישום ישום Microsoft Entra קיים – אין צורך בהגדרה נוספת.

3 עמית בינה מלאכותית עבור סוכני Microsoft 365 custom engine דורש תוכנית זהות של סוכן. זמין עבור תוכנית Frontier למשתתפים בלבד.

הירשם

כאשר אתה רושם את הסוכן שלך, אתה הופך אותו לגלוי ולניתן לניהול במרכז הניהול של Microsoft 365. מנהלי מערכת יכולים לגלות אותו ולראות אותו במלאי הסוכנים של הארגון שלהם.

מה תקבל:

  • הסוכן שלך מופיע במרכז הניהול של Microsoft 365; מנהלי מערכת יכולים למצוא אותו ולראות אותו במלאי הסוכנים של הארגון שלהם.
  • סוכנים המבוססים על תוכנית מקבלים גם את מלוא היתרונות של Entra מזהה governance, ‏Purview ו-Defender המתוארים במאמר למה לבנות על תוכנית אב של זהות סוכן?

מה תבנה:

רשום את הסוכן באמצעות רישום ביישום Microsoft Entra קיים או באמצעות Blueprint.

הערה

אם אתה בונה את הסוכנים שלך על Google Vertex בינה מלאכותית או Amazon Bedrock, הרישום אינו דורש עבודת פיתוח. ממשקי ה-API של Google ושל Amazon מושכים את הסוכנים באופן אוטומטי. אין צורך בשילוב SDK, אין צורך בתוכנית ובשינויי קוד. לאחר הרישום, תוכל להשתמש ב-Agent 365 SDK על מנת להוסיף בהדרגה יכולות צפייה\ גישה לכלי Work IQ ויכולות נוספות. על מנת להתחיל, עין במאמר Registering Google Vertex בינה מלאכותית and Amazon Bedrock סוכןs.

כיצד בונים אותו:

השתמש בהגדרה המודרכת על-ידי בינה מלאכותית וענה בהתאם על השאלות לגבי סוג הסוכן. ההגדרה המודרכת על-ידי בינה מלאכותית מבצעת את השלבים הנדרשים עבור שכבה זו. כבר היום ניתן לגלות סוכני Microsoft 365 custom engine באמצעות רישום ישום Microsoft Entra הקים שלהם.

נראות

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

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

הערה

אם הסוכן שלך הוא super סוכן - כלומר, הוא קורא באופן פנימי לסוכן משנה אחד או יותר על מנת להשלים משימה — ניתן גם לרשום את קריאות סוכני המשנה בצינור עיבוד ה-Observability. רשום אותן כקריאת כלי או כקריאה בין סוכנים (A2A), לפי הענין,, על מנת שכל שרשרת ההאצלה תהיה גלויה וניתנת לביקורת.

מה תקבל:

  • מעקב מלא המבוסס על [OpenTelemetry (OTel) (OTel)](https://opentelemetry.io/docs/specs/otel/protocol/) אחר כל אינטראקציה של הסוכן: קלטים, פלטים, קריאות לכלים והפעלות מודל.
  • הפעילות גלויה במרכז הניהול של Microsoft 365 ובמשטחי הניטור המחוברים.
  • נתיבי ביקורת המזינים את Microsoft Entra, ‏Microsoft Purview ו-Microsoft Defender, ותומכים בדרישות של תאימות, הגנת נתונים ותגובה לאיומים.

מה תבנה:

שימוש בכלים באמצעות ממשקי API שמאפשרים יכולת צפייה ב-Agent 365 SDK: באמצעות שימוש אוטומטי בכלים (אם אתה משתמש ב-OpenAI, ‏LangChain או ב-Agent Framework) או שימוש ידני בכלים עבור כל מחסנית אחרת

הערה

עבור רוב האינטגרציות החדשות, השתמש ב- Microsoft OpenTelemetry Distro — ה- הגדרה המודרכת על-ידי בינה מלאכותית יכולה להגדיר עבורך את Observability באופן אוטומטי.

אם כבר יש לך קו צינור לעיבוד של OpenTelemetry, אם מסגרת הסוכן אינה יכולה להשתמש ב-Agent 365 SDK או אם הסוכן נוצר בשפה שעדין אינה נתמכת על-ידי SDK (כגון Java), תוכל לשלוח נתוני מדידת שימוש ישירות אל Agent 365 באמצעות OTLP/HTTP גולמי, ללא כל תלות ב-SDK. עיין במקטע אינטגרציה עם יכולת צפייה של Agent 365 באמצעות OTel ישיר.

כיצד בונים אותו:

השתמש בהגדרה המודרכת על-ידי בינה מלאכותית וענה בהתאם על שאלות ה-Observability. ההגדרה המודרכת על-ידי בינה מלאכותית מבצעת את השלבים הנדרשים עבור יכולת זו. פעולה זו משתמשת בהפצת Microsoft OpenTelemetry על מנת לאפשר לסוכן שלך לעבוד.

Work IQ

לאחר רישום הסוכן שלך והפיכתו לניתן לתצפית, הענק לו גישה לנתונים ולפעולות של Microsoft 365 באמצעות Work IQ. Work IQ הוא אוסף כלים מנוהל המאפשר לסוכן שלך לעבוד עם Mail, ‏Calendar, ‏OneDrive, ‏SharePoint, ‏Teams ועוד.

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

מה תקבל:

  • גישה לקטלוג המלא של כלי Work IQ - ‏Mail, ‏Calendar, ‏OneDrive, ‏SharePoint, ‏Teams ועוד.
  • הרשאות שמנהלי מערכת שולטים בהן ומגבילים אותן בדיוק למה שהסוכן שלך צריך.
  • כל קריאה לכלי נעקבת וניתנת לביקורת באמצעות צינור התצפיתיות.

מה תבנה:

קוד סוכן שקורא לכלי Work IQ באמצעות ממשקי API של Agent 365 SDK Tooling.

כיצד בונים אותו:

השתמש בממשקי API של Agent 365 SDK Tooling על מנת להוסיף באופן ידני קריאות לכלי Work IQ אל קוד הסוכן. ההגדרה המודרכת על-ידי בינה מלאכותית אינה תומכת כרגע ביכולת זו.

עמית בינה מלאכותית

עמיתי בינה מלאכותית זמינים עבור תוכנית Frontier משתתפים.

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

הערה

שינוי במודל הזהות וההרשאות

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

משמעות השינוי היא:

  • בגישה מואצלת של משתמש, הסוכן פועל בשם המשתמש המחובר ומוגבל לגישה של אותו משתמש. עם זהות עצמאית של הסוכן, אתה מעניק גישה למשאבי Microsoft 365 כגון mailbox, ‏calendar, ‏Teams ו-SharePoint ישירות לזהות הסוכן.
  • אתה מנהל ומבקר את ההרשאות שהוענקו לזהות הסוכן כהרשאות הגישה של אותו סוכן. הן אינן זהות להרשאות מואצלות של משתמש המועברות מהמשתמש הקורא.
  • אם המימוש הנוכחי שלך מסתמך על גישה מואצלת של משתמש או על הרשאות ישום, בדוק מחדש והתאם את היקף ההרשאות האלה עבור זהות הסוכן לפני הפעלת יכולת זו.

מה תקבל:

  • כל מה שזמין ב-Discoverability, ‏Observability ו-Work IQ.
  • זהות משתמש של סוכן עם תיבת דואר משלה - אנשים יכולים לשלוח לה דוא"ל ישירות והיא יכולה לשלוח דוא"ל מהכתובת שלה.
  • נוכחות בכל ישומי Microsoft 365 - אנשים יכולים, @mention יתו, להוסיף אותו לערוצים ולהזמין אותו לפגישות ב-Teams; ולקים איתו אינטראקציה ישירה ב-Word, ‏Excel, ‏PowerPoint ובמשטחי M365 אחרים.
  • רשומה בתרשים הארגוני תחת מנהל יעודי - הסוכן מופיע בספרית הארגון.
  • מחזור חים הנשלט על-ידי מנהל מערכת - הסוכן נוצר, מנוהל ומוצא משימוש באמצעות מרכז הניהול של Microsoft 365, עם ממשל מלא על כל מופע.

מה תבנה:

כל היכולות, בנוסף ליצירת מופעים ו-(אופציונלית) פרסום ב-Marketplace.

כיצד בונים אותו:

השתמש ב- הגדרה מודרכת על-ידי בינה מלאכותית והשב בהתאם על השאלות לגבי עמית ה-בינה מלאכותית. ההגדרה המודרכת על-ידי בינה מלאכותית מבצעת את השלבים הנדרשים עבור שכבה זו.

הגדרה מודרכת על-ידי בינה מלאכותית

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

דרישות מוקדמות להגדרה המודרכת על-ידי בינה מלאכותית

לפני שתתחיל, ודא שברשותך הפריטים הבאים:

דרישה פרטים
סוכן קידוד בינה מלאכותית Visual Studio Code עם ההרחבות GitHub Copilot ו- GitHub Copilot Chat או סוכן קידוד בינה מלאכותית אחר עם גישה למסוף
קוד הסוכן פרויקט סוכן פעיל ב-Python, ‏Node.js או ..NET אם אין לך כזה, התחל באמצעות דוגמת quickstart.
תפקיד Entra Global Administrator - משלים את כל השלבים, כולל הענקת הרשאות OAuth2. סוכן מזהה Developer - משלים את כל השלבים למעט הענקת הרשאות OAuth2; ההגדרה יוצרת העברה ל-Global Administrator.

שלבי ההגדרה המודרכת על-ידי בינה מלאכותית

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

פתח את פרויקט הסוכן והעתק את ההנחיה הזאת אל סוכן AI לבחירתך. אם אתה משתמש ב- GitHub Copilot, עבור תחילה למצב סוכן למצבי Ask ו-Edit אין גישה למסוף.

Follow the steps at aka.ms/agent365enable to enable my agent for Agent 365.

סוכן ה-AI מתחיל בשאילת שלוש שאלות על מנת לקבוע אילו יכולות חלות על הסוכן:

שאלה 1: האם הסוכן שלך כבר זמין ב-Teams או ב-Copilot?

  • ‏‏כן‬
  • לא

שאלה 2: כיצד הסוכן שלך יאמת את עצמו בעת קריאה ל-API-ים במורד הזרם?

  • On-behalf-of (OBO) — הסוכן פועל כמשתמש המחובר (הרשאות מואצלות)
  • שירות-to-שירות (S2S) — הסוכן פועל באמצעות הזהות שלו (הרשאות ישום)
  • שניהם (OBO ו-S2S)

שאלה 3: אילו יכולות של Agent 365 ברצונך להפעיל?

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

לאחר מכן, סוכן ה-AI מבצע באופן אוטומטי את הרמות הרלוונטיות ועוצר רק על מנת לבקש את הקלט שלך:

יכולת מה סוכן AI עושה 1
רישום בודק את NET. ואת Agent 365 CLI (מתקין או מעדכן אם חסרים), מתקין את Azure CLI אם הוא חסר מפעיל az loginאם האימות לא בוצע, מאמת את רישום יישום הלקוח בהתאמה אישית, אוסף את שם הסוכן ואת כתובת הדוא"ל של המנהל, מגדיר את הסוכן ב-בפורטל הפיתוח של Teams ורושם את תוכנית הסוכן
תצפיתיות מוסיף כלי יכולת צפייה של Agent 365 SDK לקוד הסוכן
עמית בינה מלאכותית מפעיל a365 publish ומנחה אותך בשלבים שלאחר הפריסה, כולל יצירת מופע סוכן

1 השלבים המבוצעים תלוים בסוג הסוכן ובשלבים שבחרת בתחילת ההגדרה.

חשוב

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

מידע הנדרש להשלמה

סוכן AI עוצר על מנת לאסוף את התצורה במהלך ההגדרה:

הצג שאלה מה יש לספק
שם הסוכן, כתובת הדוא"ל של המנהל מטא-נתונים בסיסים של הסוכן
אישור ערכים נגזרים בדוק את השמות שנוצרו אוטומטית עבור זהות הסוכן, התוכנית וה-User Principal
סקירת מינפסט אשר שה- manifest.json שלך מעודכן בשם הסוכן, בתיאורו ובפרטי המפתח

שלבים לאחר הפריסה

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

  1. צור מופע סוכן

    (לעמית בינה מלאכותית בלבד) — ב-Microsoft Teams, עבור אל Apps, חפש את הסוכן שלך ובחר Add. אם נדרש אישור של מנהל מערכת, מנהל Microsoft 365 שלך יקבל את הבקשה. לאחר האישור, הסוכן שלך יופיע בתרשים הארגוני. למופעים נוספים, ראה צור מופעי סוכן. יתכן שיחלפו כמה דקות עד שסוכן שפורסם לאחרונה יופיע בחיפוש של Teams.

  2. בדוק את הסוכן שלך

    שלח הודעה לסוכן שלך ב-Teams על מנת לוודא שהוא פועל.

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

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

עיון במסלול הידני

השתמש בעיון זה רק אם אתה פותר בעיה בשלב מסוים, בונה אוטומצית CI/CD או עובד ללא סוכן קידוד בינה מלאכותית.

שלב מה‎ ‎זה‎ ‎עושה מדריך
תצורת ההגדרה יוצר a365.config.json את עם פרטי הדיר, המנוי והפרויקט שלך. אם יש לך פריסה קימת, הגדר כאן את נקודת הקצה להעברת הודעות. הגדרת תצורה של Agent 365
הגדר תוכנית רושם את זהות הסוכן שלך ב-Entra ומקצה משאבי Azure (קבוצת משאבים, App שירות Plan, ‏Web App) הגדר תוכנית סוכן
פריסה פורס את קוד הסוכן שלך אל Azure App שירות. אופציונלי אם כבר מתארח במקום אחר. Azure · AWS · GCP
פרסום יוצר manifest.zip ומעלה אל מרכז הניהול של Microsoft 365 סוכן פרסום

להתקנת CLI, פקודות ופתרון בעיות, עיין במקטע Agent 365 CLI.

פרסם את הסוכן שלך ב-Microsoft Marketplace

לאחר שתפתח ותבדוק את הסוכן שלך באופן מלא בדיר או בדירים שלך, הפוך אותו לזמין ב- Microsoft Marketplace.

לשם כך, דרוש לך חשבון Microsoft בינה מלאכותית Cloud Partner Program ב- מרכז השותפים. אם אין לך אחד, צור חשבון על מנת לקבל PartnerID. לאחר מכן, הירשם לתוכנית Microsoft 365 and Copilot, המעניקה לך גישה למשאבים ולתמיכה הדרושים לפרסום הצעות של סוכנים. לאחר ההרשמה, עין ברשימת הבדיקה להגשה ובהנחיות האימות, ולאחר מכן שלח את הסוכן שלך באמצעות מדריך ההגשה של מרכז השותפים שלב אחר שלב.

למד כיצד לשלוח את הסוכן שלך ל-Microsoft Marketplace באמצעות מרכז השותפים.

לאחר שתסים, הסוכן שלך יפורסם ב-Microsoft Marketplace ויהיה זמין ללקוחות לגילוי ולפריסה.

פתרון בעיות בהגדרה המודרכת על-ידי בינה מלאכותית

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

בעיה Description
סוכן AI אינו מפעיל פקודות מסוף סוכן AI מתאר פקודות, אך אינו מבצע אותן
סוכן AI מדלג על שלבים נראה שההגדרה מדלגת על שלבים נדרשים
פקודות CLI נכשלות עקב שגיאות הרשאה שגיאות הרשאה בעת הפעלת פקודות a365 CLI
ערכי התצורה שגוים יש לשנות את התצורה לאחר יצירת a365.config.json

סוכן AI אינו מפעיל פקודות מסוף

אם סוכן AI מתאר פקודות, אך אינו מבצע אותן, ודא שאתה משתמש במצב סוכן ב-GitHub Copilot Chat. למצבי Ask ו-Edit אין גישה למסוף.

סוכן AI מדלג על שלבים

קובץ ההוראות אוכף סדר שלבים קפדני. אם נראה שסוכן AI מדלג על שלב, בקש ממנו להתחיל מחדש:

Please start from Step 1 in the setup instructions and work through each step in order.

פקודות CLI נכשלות עקב שגיאות הרשאה

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

לפתרון בעיות כללי, עיין במקטע המדריך לפתרון בעיות של Agent 365.

ערכי התצורה שגוים

אם עליך לשנות ערכי תצורה לאחר יצירת a365.config.json, בצע אחת מהאפשרויות הבאות:

  • ערוך את הקובץ ישירות והפעל מחדש a365 config init -c ./a365.config.json
  • בקש מסוכן ה-AI לעדכן ערכים מסוימים
  • Last updated on