שרת‎ ‎כלים‎ ‎מדמה

ה-CLI של Agent 365 כולל שרת כלים מדומה לבדיקות ופיתוח. שרת זה מדמה אינטראקציות בין שרת MCP ‏(Model Context Protocol), כך שתוכל לבדוק את יכולות הכלים של הסוכן שלך באופן מקומי בלי צורך במימושים אמיתיים של השרת. זה‎ ‎לא‎ ‎מכסה‎ ‎שום‎ ‎פונקציות‎ ‎אחרות‎ ‎של‎ Agent 365.

יתרונות‎ ‎השימוש‎ ‎בשרת‎ ‎המוקלט

השרת‎ ‎המדמה‎ ‎מציע‎ ‎את‎ ‎היתרונות‎ ‎הבאים‎ ‎לפיתוח‎ ‎ולבדיקות‎ ‎מקומיות‎:

• פיתוח‎ ‎לא‎ ‎מקוון‎: ‎בדוק‎ ‎את‎ ‎הסוכן‎ ‎שלך‎ ‎ללא‎ ‎חיבור‎ ‎לאינטרנט‎ ‎או‎ ‎תלות‎ ‎חיצונית‎.
• בדיקות‎ ‎עקביות‎: ‎קבל‎ ‎תגובות‎ ‎צפויות‎ ‎לבדוק‎ ‎מקרים‎ ‎קצה‎.
• איתור באגים‎: ‎צפה‎ ‎בכל‎ ‎הבקשות‎ ‎והתשובות‎ ‎בזמן‎ ‎אמת
• חזרה‎ ‎מהירה‎: ‎אין‎ ‎צורך‎ ‎לחכות‎ ‎לקריאות‎ API ‎חיצוניות‎ ‎או‎ ‎להקים‎ ‎סביבות‎ ‎בדיקה‎ ‎מורכבות‎.

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

לפני‎ ‎השימוש‎ ‎בשרת‎ ‎הכלים‎ ‎המדומים‎, ‎ודא‎ ‎שיש‎ ‎לך‎ ‎את‎ ‎הדרישות‎ ‎המוקדמות‎ ‎הבאות‎:

• Agent 365 CLI מותקן - השתמש בשרת הכלים המדומה לצד ה-CLI. ראה‎ ‎סוכן‎ 365 CLI‎ ‎להוראות‎ ‎התקנה‎.
  • עליך‎ ‎להיות‎ ‎בעל‎ ‎גרסה‎ ‎לפחות‎ 1.1.25-preview ‎כדי‎ ‎להשתמש‎ ‎בשרת‎ ‎הכלים‎ ‎המדומים‎.
• דוגמת‎ ‎פרויקט‎ ‎סוכן‎ - ‎פרויקט‎ ‎סוכן‎ ‎מקומי‎ ‎שיכול‎ ‎להתחבר‎ ‎לשרתים‎ ‎של‎ MCP. ראה‎ ‎את‎ ‎מאגר‎ ‎ה‎-‏Agent365-Samples‎ ‎שלנו‎ ‎לנקודות‎ ‎התחלה‎ ‎זמינות‎.

התחל‎ ‎את‎ ‎שרת‎ ‎הכלים‎ ‎המדומים

השתמש‎ ‎בפקודת‎ ‏a365 develop start-mock-tooling-server ‎‎ ‎כדי‎ ‎להתחיל‎ ‎את‎ ‎שרת‎ ‎הכלים‎ ‎המדומים‎.

# Full command
a365 develop start-mock-tooling-server

# Short alias
a365 develop mts

אפשרויות‎ ‎פקודה

שרת‎ ‎הכלים‎ ‎המדומים‎ ‎תומך‎ ‎באפשרויות‎ ‎הבאות‎:

אפשרות	Description	ברירת מחדל
-p, --port <port>	מספר‎ ‎פורט‎ ‎עבור‎ ‎השרת‎ ‎המדמה	5309
-v, --verbose	אפשר‎ ‎לוגים‎ ‎מפורטים	שקר
-?, -h, --help	הצג‎ ‎עזרה‎ ‎ומידע‎ ‎על‎ ‎שימוש	-
-bg	הרץ‎ ‎את‎ ‎השרת‎ ‎בטרמינל‎ ‎חדש	-

דוגמאות

הדוגמאות‎ ‎הבאות‎ ‎מראות‎ ‎דרכים‎ ‎נפוצות‎ ‎להתחיל‎ ‎את‎ ‎שרת‎ ‎הכלים‎ ‎המדומים‎:

התחל‎ ‎עם‎ ‎הגדרות‎ ‎ברירת‎ ‎מחדל‎:‎

a365 develop start-mock-tooling-server

התחל‎ ‎על‎ ‎פורט‎ ‎מותאם‎ ‎אישית‎:‎

a365 develop start-mock-tooling-server -p 8080

התחל‎ ‎עם‎ ‎רישום‎ ‎מפורט‎:‎

a365 develop start-mock-tooling-server -v

כאשר‎ ‎אתה‎ ‎מריץ‎ ‎את‎ ‎הפקודה‎, ‎זה‎:

1. מפעיל‎ ‎את‎ ‎השרת‎ ‎המזוייף‎ ‎על‎ ‎הפורט‎ ‎המוגדר‎ (‎ברירת‎ ‎מחדל‎: localhost:5309).
2. מציג‎ ‎יומני‎ ‎שרת‎ ‎ובקשות‎ ‎נכנסות‎ ‎במסוף‎.

השתמש‎ ‎בשרת‎ ‎דמה‎ ‎עם‎ ‎סוכנים‎ ‎לדוגמה

כדי‎ ‎לחבר‎ ‎את‎ ‎סוכן‎ ‎הדוגמה‎ ‎שלך‎ ‎לשרת‎ ‎הכלים‎ ‎המדומים‎:

שלב‎ 1: ‎התחל‎ ‎את‎ ‎השרת‎ ‎המדמה

a365 develop start-mock-tooling-server

השרת‎ ‎מתחיל‎ ‎ומציג‎ ‎פלט‎ ‎דומה‎ ‎לדוגמה‎ ‎הבאה‎:

info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5309
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.

שלב‎ 2: ‎הגדר‎ ‎את‎ ‎הסוכן‎ ‎שלך

הגדר‎ ‎את‎ ‎משתנה‎ ‎הסביבה‎ ‎MCP_PLATFORM_ENDPOINT‎ ‎בסוכן‎ ‎הדוגמה‎ ‎שלך‎ ‎כדי‎ ‎להפנות‎ ‎לשרת‎ ‎המוק‎.

MCP_PLATFORM_ENDPOINT=http://localhost:5309

אם‎ ‎אתה‎ ‎משתמש‎ ‎ביציאה‎ ‎מותאמת‎ ‎אישית‎, ‎החלף‎ ‎5309‎ ‎במספר‎ ‎היציאה‎ ‎שבחרת‎.

שלב‎ 3: ‎הרץ‎ ‎את‎ ‎הסוכן‎ ‎שלך

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

שלב‎ 4: ‎נטר‎ ‎פעילות‎ ‎שרת

טרמינל‎ ‎השרת‎ ‎המדמה‎ ‎מציג‎:

• בקשות‎ ‎נכנסות‎ ‎מהסוכן‎ ‎שלך
• תגובות‎ ‎מזויפות‎ ‎נשלחות‎ ‎חזרה
• מצב‎ ‎חיבור‎ ‎ושגיאות‎ (‎אם‎ ‎יש‎)

יומני‎ ‎שרת‎ ‎לדוגמה‎:

info: Microsoft.AspNetCore.Hosting.Diagnostics[1]
      Request starting HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - application/json 351
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[0]
      Executing endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Http.Result.JsonResult[3]
      Writing value of type '<>f__AnonymousType14`3' as Json.
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[1]
      Executed endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Hosting.Diagnostics[2]
      Request finished HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - 200 - application/json;+charset=utf-8 399.1814ms

עוצרת‎ ‎את‎ ‎השרת‎ ‎המזוייף

כדי‎ ‎לעצור‎ ‎את‎ ‎השרת‎ ‎המדמה‎, ‎השתמש‎ ‎בCtrl+C‎ ‎במסוף‎ ‎שבו‎ ‎השרת‎ ‎פועל‎, ‎או‎ ‎סגור‎ ‎את‎ ‎חלון‎ ‎המסוף‎.

‏‫פתרון בעיות

סעיף‎ ‎זה‎ ‎מכיל‎ ‎מידע‎ ‎על‎ ‎כיצד‎ ‎לפתור‎ ‎בעיות‎ ‎נפוצות‎ ‎עם‎ ‎שרת‎ ‎הכלים‎ ‎המדומים‎.

עצה

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

שרת‎ ‎המוק‎ ‎לא‎ ‎מצליח‎ ‎להתחיל

תסמין‎:‎Error: Address already in use

סיבה‎:‎‎ ‎תהליך‎ ‎אחר‎ ‎כבר‎ ‎משתמש‎ ‎בנמל‎ ‎ברירת‎ ‎המחדל‎ (5309) ‎או‎ ‎בנמל‎ ‎שציינת‎.

פתרון‎:‎

• השתמש‎ ‎בנמל‎ ‎שונה‎.

  a365 develop start-mock-tooling-server -p 8080
  

• או‎ ‎עצור‎ ‎את‎ ‎התהליך‎ ‎באמצעות‎ ‎הפורט‎ ‎ונסה‎ ‎שוב‎.

הסוכן לא מצליח להתחבר לשרת המדומה

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

סיבה‎:‎

• השרת‎ ‎המזוייף‎ ‎לא‎ ‎פועל‎.
• משתנה‎ ‎סביבה‎ ‎לא‎ ‎נכון‎ ‎MCP_PLATFORM_ENDPOINT‎.
• בעיות‎ ‎בחומת‎ ‎אש‎ ‎או‎ ‎בהגדרות‎ ‎הרשת‎.

פתרון‎:‎

1. אמת‎ ‎שהשרת‎ ‎המחקה‎ ‎פועל‎ ‎ומציג‎ "‎עכשיו‎ ‎מקשיב‎ ‎על‎: ‎http://localhost:5309"‎;.
2. בדוק‎ ‎אם‎ ‎משתנה‎ ‎הסביבה‎ ‎MCP_PLATFORM_ENDPOINT‎ ‎תואם‎ ‎את‎ ‎כתובת‎ ‎השרת‎.
3. ודא‎ ‎שאין‎ ‎חומת‎ ‎אש‎ ‎שחוסמת‎ ‎את‎ ‎החיבור‎ ‎על‎ ‎הפורט‎ ‎המוגדר‎.