דלגו לתוכן
גיליון 001·חי·20:20 IL
→ יומן/2026-11-04·8 דק׳

Semantic Kernel Python 1.46.0: תיעוד הרשאת כלים, אמון בתבניות, ו-DNS מוצמד ב-HttpPlugin

Semantic Kernel Python 1.46.0 מערב תיקוני אבטחה עם תיעוד שאומר בקול מה שה-function filters שלו לא עושים. קראתי את הערות הגרסה, ה-pull requests ואת ה-README בתג כדי לראות מה השתנה ומה עדיין נופל על האפליקציה שלכם.

מאת Harel Asaf·בונה בינה מלאכותית·תל אביב

Semantic Kernel Python 1.46.0 היא בעיקר מהדורת חיזוק. החלק השימושי ביותר אולי הוא סעיף README שאומר משהו שהרבה מדריכי קריאת-כלים מדלגים עליו: רשימת פונקציות מורשת בוחרת אילו כלים המודל יכול לבחור, והיא לא מרשה דבר. הגרסה גם מצמידה בקשות HttpPlugin לכתובות DNS מאומתות, דוחה מקטעי נקודות בנתיבי העלאת מושב, ומפסיקה לרשום ערכי ארגומנטים של פונקציות בלוג.

קראתי את הערות הגרסה של python-1.46.0 (פורסמו ב-28 באוקטובר 2026), שבעה pull requests שהן מפרטות, ואת ה-README של Python בתג הזה. לא התקנתי את החבילה ולא הרצתי אף קוד. כל מה שכתוב למטה הוא מה שהמסמכים האלה אומרים.

סעיף ה-README על הרשאת כלים

Pull request 14647 מוסיף סעיף "Tool invocation and authorization" ל-README של Python. זה תיעוד בלבד. ה-PR אומר שה-dispatch המסונן הקיים כבר דוחה פונקציות לא-חברות לפני ההפעלה ושלא מוצג מנגנון חדש. טקסט ה-README בתג טוען את הנקודות האלה:

  • קריאות פונקציה וארגומנטים שנוצרו על ידי מודל הם קלט לא מהימן. פרומפטים, תיאורי פונקציות וההחלטה של המודל לקרוא לכלי הם לא בקרות הרשאה.
  • FunctionChoiceBehavior.Auto() בלי מסננים הופך את כל הפונקציות הרשומות ב-kernel לזמינות להפעלה אוטומטית. רשמו רק מה שהמשימה צריכה, או השתמשו ברשימה מורשית מפורשת ולא-ריקה עם included_functions, בפורמט PluginName-function_name.
  • רשימת הכללה ריקה היא לא דחיית-הכל. רשימות ריקות לא מגבילות בחירת פונקציות.
  • עם מסננים מוגדרים, נתיב ההפעלה האוטומטית בודק את הפונקציה המבוקשת מול המטא-נתונים המסוננים של ה-kernel. ה-README אומר שזה לא snapshot של הכלים שנשלחו למודל, אז לשמור פונקציות רשומות ומסננים ללא שינוי במהלך בקשה.
  • מסננים מגבילים בחירה. הם לא בודקים גישת נתונים או אם פעולה מותרת למשתמש נתון. הבדיקות האלה שייכות לפונקציה או למסנן הפעלת פונקציה.
  • מסנן הפעלת פונקציה אוטומטי יכול לדחות קריאה על ידי אי-קריאה ל-next(context). הגדרת context.terminate אחרי await next(context) עוצרת עיבוד מאוחר יותר אבל לא מבטלת את הקריאה.
  • לאישור לפני ביצוע, השתמשו ב-Auto(auto_invoke=False, filters=...), ואז בדקו והרשו כל קריאה שמוחזרת. אם אתם קוראים ל-Kernel.invoke_function_call בעצמכם, העבירו את אותה התנהגות כ-function_behavior. השמטה שלה מדלגת על סינון שמות, והעברת execution_settings לבדה לא מפעילה אותו.

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

גבול האמון של תבנית הפרומפט

Pull request 14648 הוא גם תיעוד, עם בדיקת רגרסיה אחת. התיאור שלו אומר שמקור תבנית יכול להפעיל פונקציות רשומות ב-Kernel במהלך הרינדור, ושזה לא היה מפורש קודם. השינוי מתעד ש:

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

הבדיקה החדשה מראה שתחביר דמוי-תבנית שמועבר כארגומנט מעובד מילולית ולא קורא לפונקציית plugin רשומה. ה-PR אומר ששום התנהגות runtime או ברירות מחדל לא משתנים.

HttpPlugin והצמדת DNS

Pull request 14649 (מוזג ב-23 באוקטובר) מתאר פער ב-HttpPlugin. הוא אימת את כתובות ה-DNS של מארחים ברשימה המורשית לפני שליחת בקשה, ואז זרק אותן. תעבורת ה-HTTP יכלה לפתור את שם המארח שוב בזמן החיבור. התיקון שומר את כתובות ה-IPv4 ו-IPv6 המאומתות ונותן ל-aiohttp פותרן ברמת-מארח שמחזיר רק אותן. ה-URL המקורי נשמר, אז כותרות Host, TLS SNI ובדיקות תעודה עדיין משתמשות בשם המארח. זה חל על GET, POST, PUT ו-DELETE. כתובות URL של IP מילולי והצטרפויות מפורשות של allow_all_domains ו-allow_private_network_access מתנהגות כמו קודם.

ה-PR אומר שבדיקות מכסות כל מתודה וכוללות בדיקת חיבור אמיתית שמראה שחיפוש שם מארח מאוחר יותר לא בשימוש. לא קראתי את הבדיקות.

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

Pull request 14563 (מוזג ב-16 באוקטובר) מתקן את SessionsPythonTool.upload_file ב-Python. הורדה כבר דחתה מקטעי נתיב . ו-.. בשם המרוחק, אבל העלאה רק הוסיפה קידומת /mnt/data/. remote_file_path שסופק על ידי מודל, כמו אחד עם מקטעי תיקיית-אב, יישלח לשירות המושבים כמו שהוא. התיקון עושה שימוש חוזר באותה שומר במסייע המשותף, עם אותו סוג חריגה.

ה-PR מציין שהבדיקה הקיימת בצד המקומי על תיקיות העלאה לא מכסה את זה, כי השם המרוחק הוא מחרוזת שהמודל בוחר. Pull request 14646 מחיל כלל דומה על תוסף ה-.NET, וגם מטפל ב-backslashes, שמות מושרשים, קידומות כונן ונתיבי UNC.

רישום לוג בלי ערכי ארגומנטים

Pull request 14574 (מוזג ב-12 באוקטובר) אומר שאבחון הפעלת פונקציות נהג לכלול ערכי ארגומנטים, תוצאה או חריגה מלאים ברמת INFO, DEBUG או ERROR. עכשיו הפעלה אוטומטית רושמת את זהות הפונקציה ב-INFO בלי ערכי ארגומנטים, ורושמת ספירות ארגומנטים, נוכחות תוצאה וסוג שגיאה במקום הערכים. פרטי חריגה גולמיים נשארים ב-spans של פונקציות רק כשאבחון רגיש מופעל במפורש.

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

שינוי .NET באותן הערות

Pull request 14504 חוסם עומק קינון אלמנטים במנתח פרומפטי ה-XML של .NET ב-64. ה-PR אומר שעבודת הניתוח גדלה עם עומק הקינון כפול גודל הפרומפט. פרומפטים מעל-למגבלה עוברים בנתיב ה-XML-לא-תקין הקיים ונשלחים כהודעת טקסט משתמש אחת. הוא בערות הגרסה הזו למרות שזה שינוי .NET, וזו תזכורת שההערות מכסות יותר מחבילת ה-Python.

מה אני הייתי בודק

אלה ההצעות שלא נבדקו שלי.

  • לחפש קריאות FunctionChoiceBehavior.Auto() בלי מסננים, וכל רשימת מסננים שנבנית בזמן ריצה ויכולה להיות ריקה.
  • לבדוק אם מקור תבנית כלשהו בנוי מטקסט של משתמש, קובץ או רשת. להעביר את הטקסט הזה לארגומנטים.
  • אם אתם משתמשים ב-HttpPlugin עם מארחים ברשימה מורשית, לשמור את הרשימה המורשית מפורשת ולהימנע מההצטרפויות הבלתי-מוגבלות.
  • אם אתם מנתחים לוגים מקריאות פונקציות, לחפש ערכי ארגומנטים שהסתמכתם עליהם.
  • אם אתם משתמשים בתוסף המושבים, לשמור את הנתיב המרוחק בשליטתכם ולא לקבל מחרוזות נתיב שנבחרו על ידי מודל בלי בדיקות משלכם.

מה לא הייתי מסיק

  • שמסננים הופכים קריאת כלים לבטוחה. ה-README אומר שהם לא מרשים גישה.
  • שהתיקונים האלה מכסים כל תוסף. קראתי רק את השינויים ב-HttpPlugin ובתוסף המושבים.
  • שהערות הגרסה עוסקות רק ב-Python. הן כוללות שינויי .NET ו-CI.

שאלות נפוצות

מה included_functions עושה ב-Semantic Kernel?

היא מגבילה אילו פונקציות בחירת הפונקציות יכולה לבחור, בפורמט PluginName-function_name. ה-README אומר שזו לא בקרת הרשאה.

האם רשימת included_functions ריקה חוסמת הכל?

לא. ה-README אומר שרשימות ריקות לא מגבילות בחירת פונקציות.

האם טקסט תבנית פרומפט יכול לקרוא לתוספים שלי?

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

האם escaping מונע מפונקציות תבנית לרוץ?

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

מה השתנה ב-HttpPlugin?

כתובות DNS מאומתות מוצמדות עכשיו לחיבור, אז התעבורה לא פותרת את שם המארח שוב. שם המארח נשמר לכותרות Host ולבדיקות TLS.

האם ארגומנטי פונקציות עדיין נרשמים בלוג?

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

הרצתם את זה?

לא. קראתי את הערות הגרסה, ה-pull requests וה-README. לא התקנתי או הרצתי Semantic Kernel.

מקורות

כולם נקראו ב-4 בנובמבר 2026.

לא נקרא: הקוד והבדיקות מאחורי ה-pull requests האלה, התיקונים הנותרים בערות הגרסה, ומהדורת ה-.NET.

קריאה נוספת

יומן הבנייה

לעקוב אחרי העבודה.

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

עקבו ב-RSS