ניפוי באגים בכלי WebMCP

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

פתיחת החלונית WebMCP

החלונית WebMCP נמצאת בחלונית Application. כדי לפתוח אותו, פועלים לפי השלבים הבאים:

  1. פותחים את כלי הפיתוח ל-Chrome בדף שמשתמש בכלי WebMCP.
  2. לוחצים על הכרטיסייה Application (אפליקציה).
  3. ברמה העליונה של סרגל הצד, בוחרים בחלונית WebMCP.
חלונית האפליקציה של DevTools עם החלונית WebMCP שנבחרה בסרגל הצד של האפליקציה.
חלונית Application בכלי הפיתוח, עם החלונית WebMCP שנבחרה בסרגל הצד של Application.

סקירה כללית של הממשק

בחלונית WebMCP יש פריסה של שני חלונות שעוזרת לכם לנהל את הכלים ולעקוב אחריהם:

  • כלים שהופעלו: יומן כרונולוגי של האינטראקציות בין סוכן ה-AI לבין הדף.
  • כלים זמינים: רשימה בזמן אמת של כל הכלים של WebMCP שזוהו בכרטיסייה הפעילה.

כלים זמינים

בקטע Available tools (כלים זמינים) מוצגים השמות והתיאורים של הכלים כפי שהם מופיעים לסוכן ה-AI. הוא כולל גם מונה הפעלות לכל כלי, שבו אפשר לראות כמה פעמים הכלי הופעל במהלך הסשן הנוכחי.

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

כלים שהופעלו

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

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

סינון היומן

כדי לצמצם את רשימת הכלים שהופעלו, משתמשים בסרגל Filter לפי הקריטריונים הבאים:

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

בדיקה ידנית של כלי הבדיקה

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

  1. ברשימה כלים זמינים, לוחצים על הכלי שרוצים לבדוק. לחלופין, ביומן Invoked Tools (כלים שהופעלו), מעבירים את העכבר מעל כלי כדי להציג את סמל ההפעלה (➜) ולוחצים עליו. אזור הבדיקה הידנית ייפתח. הערה: אם בחרתם את הכלי מתוך רשימת הכלים הזמינים, הפרמטרים באזור הבדיקה הידנית יהיו ריקים. אחרת, אם בחרתם בכלי שהופעל, אזור הבדיקה הידנית ייפתח עם הפרמטרים מהסשן הזה שכבר מאוכלסים מראש.
  2. באזור הבדיקה הידנית, מזינים או משנים פרמטרים בשדות הקלט.
  3. לוחצים על הפעלת הכלי.
מעבירים את העכבר מעל פריט ברשימת הכלים שהופעלו כדי להציג את סמל ההפעלה ופותחים את האזור של הבדיקה הידנית שאוכלס מראש.
העברת העכבר מעל פריט ברשימת הכלים שהופעלו כדי להציג את סמל ההפעלה ופתיחת אזור הבדיקה הידנית שאוכלס מראש.

פתרון בעיות בשילוב

החלונית WebMCP עוזרת לכם לאבחן כשלים נפוצים בשילוב:

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

אוטומציה וסוכנים

פרוטוקול WebMCP מיועד לאינטרנט מבוסס-סוכנים, שבו סוכני AI יכולים לגלות את הכלים באתר שלכם ולקיים איתם אינטראקציות. לפיתוח בעזרת סוכנים, פרויקט Chrome DevTools for agents מספק ממשק ייעודי שמשתמש בפרוטוקול הזה כדי לעזור לסוכני AI לבדוק את כלי WebMCP ולהשתמש בהם.

התרעות לגבי שורת פקודה

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

מקורות מידע שקשורים לנושא

מידע נוסף על WebMCP ועל האינטרנט האגנטי זמין במקורות המידע הבאים: