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

Anthropic Python SDK 2.4.0: מגבלות הוצאה, בקשות העלאה ושתי שגיאות מגבלת סשן חדשות

Anthropic Python SDK 2.4.0 יצא ב-2 בנובמבר עם שיטות admin ב-GA ושתי שגיאות סשן חדשות לסוכנים מנוהלים. קראתי את ערות הגרסה והגדרות הטיפוסים ב-tag כדי לראות מה מגבלות הוצאה, בקשות העלאה וסיבות העצירה החדשות באמת אומרות.

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

Anthropic Python SDK v2.4.0 פורסם ב-GitHub ב-2 בנובמבר 2026. שני חלקים חשובים למי שמריץ סוכנים: שיטות admin למגבלות הוצאה, אנליטיקס ו-RBAC מפורטות עכשיו כ-GA, ולסשנים של סוכנים-מנוהלים יש שני טיפוסי שגיאה חדשים, tool_use_limit_reached_error ו-compaction_limit_reached_error. שניהם מתארים סיבוב שנעצר על מגבלה, לא בקשה שנכשלה.

קראתי את ערות הגרסה של v2.4.0 ו-v2.3.0 ואת קבצי המקור והטיפוסים של Python ב-tag v2.4.0 דרך GitHub API. לא התקנתי את ה-SDK, לא קראתי לאף endpoint, ולא קראתי את תיעוד ה-API של Anthropic. כל מה שלמטה הוא מה שמקור ה-SDK אומר, לא מה שהשירות עושה.

מה ערות הגרסה מפרטות

חלק הפיצ'רים של 2.4.0 מכיל שש שורות:

  • שיטות GA לאנליטיקס, מגבלות הוצאה ו-RBAC.
  • טיפוסי בטא בעלי שם למדדים מאוחדים ותגובות מחיקה של RBAC.
  • טיפוסים משותפים של סדר אנליטיקס ושחקן בקשת העלאה.
  • שני טיפוסי שגיאות הסשן למעלה.
  • טיפוסים ל-group_by של אנליטיקס ופילטרי תקופה של מגבלת הוצאה.
  • user_profile_id על External Keys ו-Workspaces.

תיקוני הבאגים כוללים הפיכת spend_limit ל-nullable בתגובת האישור של בקשת ההעלאה, ודרישת שדות אנליטיקס "always-sent". גרסת v2.3.0, מ-23 באוקטובר, הוסיפה endpoints של Claude Tag לארגוני Claude Enterprise. זה פריט נפרד ולא קראתי אותו לעומק.

מגבלות הוצאה, כפי שמוקלדות ב-SDK

ל-SDK שני עצים. תחת resources/beta/organization/spend_limits הקובץ מגדיר retrieve, list, delete ו-set, כולם מול /v1/organizations/spend_limits. תחת resources/organization/spend_limits, ה-spend_limits.py הלא-בטא שפתחתי חושף רק שני תתי-משאבים: effective (/v1/organizations/spend_limits/effective) ו-increase_requests. לא בדקתי אם עץ ה-GA מקבל set במקום אחר, אז אל תקראו את זה כהצהרה על מה חסר במוצר.

מה-docstring של SpendLimitSetParams בבטא:

  • amount הוא מחרוזת עשרונית ביחידה המשנית של מטבע החיוב של הארגון. ל-USD, "50000" הוא $500.00.
  • amount: null מגדיר "an explicit no-limit override" לאותו scope ותקופה בלבד. כל תקופה נפתרת בנפרד, אז תקרות לתקופות אחרות עדיין חלות.
  • ארגוני Claude Enterprise מגדירים מגבלות user. ארגוני Claude Console מגדירים מגבלות organization ו-workspace. כל שילוב אחר מחזיר 400.
  • הגדרת מגבלות organization ו-workspace דרך ה-API מתוארת כ-early access preview.
  • טיפוס התקופה הוא daily, weekly או monthly.

לעץ הלא-בטא יש גם טיפוסי scope ל-rbac_group, seat_tier, usage_tier, organization_service, user ו-workspace. ראיתי את שמות הקבצים, לא את התכולה, אז אני לא אומר איך הם משתלבים.

בקשות העלאה

ל-SpendLimitIncreaseRequest יש id, actor (מי הגיש), created_at, period, resolved_at ו-resolved_by אופציונליים, spend_summary אופציונלי, ו-status של pending, approved או denied. למשאב יש retrieve, list, approve ו-deny, ו-approve ו-deny חיים תחת /v1/organizations/spend_limit_increase_requests/....

פרמטרי ה-approve של הבטא לוקחים amount ("new per-user spend limit", ביחידות משנה), period אופציונלי, ו-suppress_notification. שימו לב לניסוח: ה-docstring אומר per-user, מה שמתאים ל-scope של Enterprise user. לא אימתתי איך זה מתנהג ל-scopes אחרים.

שתי שגיאות הסשן החדשות

שני הטיפוסים יושבים תחת types/beta/sessions ומשתמשים ב-prefix של managed-agents.

  • tool_use_limit_reached_error: לפי ה-docstring שלו, הסיבוב נעצר כי לולאת הסוכן הגיעה למגבלה של סיבובי שימוש-בכלים. תגובת מודל אחת שקוראת לכלים, ועוד הרצת הכלים האלה, היא סיבוב אחד.
  • compaction_limit_reached_error: הסיבוב נעצר כי ההקשר עבר compaction המספר המרבי של פעמים ברצף בלי שהמודל הפיק הודעה או קריאת כלי.

שניהם אומרים שהעצירה היא "not because a request failed". ה-thread הולך ל-idle עם stop_reason: retries_exhausted, thread ילד מסתיים, וה-user.message הבא מתחיל סיבוב חדש. כל אחד נושא message ו-retry_status, שהוא אחד משלושה טיפוסים:

  • retrying: השרת מנסה שוב אוטומטית. הלקוח צריך לחכות. אותה שגיאה עלולה לירות שוב כ-retrying, ואז פעם אחת כ-exhausted.
  • exhausted: הסיבוב מת, קלטים בתור מרוקנים, והסשן חוזר ל-idle. הלקוח רשאי לשלוח פרומפט חדש.
  • terminal: הסשן פגע בשגיאה טרמינלית ועובר ל-terminated.

ה-docstrings לא נותנים את מספרי המגבלה. לא מצאתי אותם בקבצים שקראתי.

מה הייתי בודק

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

  • אם אתם סופרים שגיאות לפי טיפוס, הוסיפו את שני הטיפוסים החדשים ל-handlers שלכם לפני שדרוג. סיבוב שמסתיים ב-retries_exhausted בלי בקשה כושלת עלול להיראות כהצלחה בדשבורדים שעוקבים רק אחרי שגיאות HTTP.
  • אל תשלחו אוטומטית הודעת "continue" כשרואים אחת מהשגיאות. לולאה שפגעה במגבלת שימוש-בכלים או לולאת compaction עלולה לפגוע בה שוב. רשמו בלוג את הסשן והסתכלו מה הסוכן עשה קודם.
  • התייחסו ל-amount כמחרוזת ביחידות משנה בעטיפות שלכם. שגיאת המרה ל-float כאן תשנה תקציב בפקטור 100.
  • אם אתם אוטומטים אישורים של בקשות העלאה, שמרו אדם בנתיב עבור הסכום. ה-SDK מראה ש-approve יכול להגדיר מגבלה חדשה, ו-suppress_notification קיים. זו הרבה סמכות לסקריפט.
  • קבעו את גרסת ה-SDK וקראו את diff הטיפוסים בין 2.3.0 ל-2.4.0 לפני שדרוג ב-production.

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

  • לא הייתי מסיק ש-API מגבלות ההוצאה זמין באופן כללי לכל חשבון. ערות הגרסה אומרות "GA methods", אבל אותו docstring קורא למגבלות organization ו-workspace early access preview.
  • לא הייתי מסיק מגבלה מספרית מסוימת לסיבובי שימוש-בכלים או compactions. לא מצאתי אחת.
  • לא הייתי מסיק איך חיוב או אכיפה עובדים. ה-SDK מתאר רק צורות בקשה ותגובה.
  • לא הייתי מתייחס למאמר הזה כסקירה של תמחור Claude API או קונסול ה-admin.

שאלות נפוצות

מה השתנה ב-Anthropic Python SDK 2.4.0?

ערות הגרסה מפרטות שיטות GA לאנליטיקס, מגבלות הוצאה ו-RBAC, טיפוסי בטא בעלי שם למדדים מאוחדים ותגובות מחיקת RBAC, שני טיפוסי שגיאות סשן, טיפוסי פילטר לאנליטיקס ותקופות מגבלת הוצאה, ו-user_profile_id על External Keys ו-Workspaces.

מתי זה יצא?

GitHub מראה v2.4.0 פורסם ב-2 בנובמבר 2026. v2.3.0 פורסמה ב-23 באוקטובר.

מה tool_use_limit_reached_error אומר?

לפי ה-docstring של הטיפוס, לולאת הסוכן הגיעה למגבלה של סיבובי שימוש-בכלים. זו לא בקשה כושלת. ה-thread הולך ל-idle עם stop_reason: retries_exhausted וה-user.message הבא מתחיל סיבוב חדש.

מה compaction_limit_reached_error אומר?

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

איך כותבים סכומי מגבלת הוצאה?

כמחרוזת עשרונית ביחידה המשנית של מטבע החיוב של הארגון. ל-USD, "50000" הוא $500.00. סכום null הוא override מפורש של ללא-מגבלה לאותו scope ותקופה.

אילו scopes של מגבלת הוצאה אפשר להגדיר?

ה-docstring של הבטא אומר שארגוני Claude Enterprise מגדירים מגבלות user וארגוני Claude Console מגדירים מגבלות organization ו-workspace, עם האחרונות ב-early access preview. שילובים אחרים מחזירים 400.

הרצת את זה?

לא. קראתי את ערות הגרסה ואת קבצי המקור והטיפוסים ב-tag. לא התקנתי את ה-SDK ולא קראתי ל-API.

מקורות

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

לא נקרא: תיעוד ה-API של Anthropic, משאבי האנליטיקס ו-RBAC בפירוט, תכולת טיפוסי ה-scope, endpoints של Claude Tag, וכל התנהגות של השירות החי.

קריאה נוספת

יומן הבנייה

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

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

עקבו ב-RSS