Anthropic Python SDK 2.4.0: מגבלות הוצאה, בקשות העלאה ושתי שגיאות מגבלת סשן חדשות
Anthropic Python SDK 2.4.0 יצא ב-2 בנובמבר עם שיטות admin ב-GA ושתי שגיאות סשן חדשות לסוכנים מנוהלים. קראתי את ערות הגרסה והגדרות הטיפוסים ב-tag כדי לראות מה מגבלות הוצאה, בקשות העלאה וסיבות העצירה החדשות באמת אומרות.
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ו-workspaceearly 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.
- anthropic-sdk-python v2.4.0 release notes
- anthropic-sdk-python v2.3.0 release notes
- Spend limit set params (beta)
- Spend limit increase request type (beta)
- Tool use limit reached error type
- Compaction limit reached error type
- Beta spend limits resource
לא נקרא: תיעוד ה-API של Anthropic, משאבי האנליטיקס ו-RBAC בפירוט, תכולת טיפוסי ה-scope, endpoints של Claude Tag, וכל התנהגות של השירות החי.
קריאה נוספת
- Self-hosted Claude Managed Agents: שירות הסוכנים של Anthropic רץ עכשיו על התשתית שלך
Anthropic פתחה את self-hosted Claude Managed Agents בבטא פרטית: אתה מארח את שירות הסוכנים, את מסד הנתונים ואת ארגזי החול, וקריאות המודל הולכות ל-Claude API או לספק שאתה בוחר. מה רץ איפה, אילו הרשאות קיימות, מה עדיין יוצא מהרשת שלך, ומה כדאי לבדוק לפני שמתחייבים.
- המדריך של Anthropic לסוכני always-on: חמישה פרימיטיבים מאחורי סוכנים שלא יושבים בחינם
Anthropic פרסמה מדריך לבניית סוכני always-on: סוכנים שומרי-מצב ופרואקטיביים שמנהלים קונטקסט בין סשנים. הרעיון המרכזי הוא שהסוכן לא באמת רץ כל הזמן - הוא ישן בין ריצות, וחמישה פרימיטיבים ארכיטקטוניים מחליטים מתי הוא מתעורר, מה הוא זוכר, ומה מגיע אליך.
- חמש שרשראות הניצול של Claude מאת Anthropic: מה פוסט ה-Frontier Red Team טוען, ומה הוא משמיט
Anthropic אומרת שמודל פנימי שלא שוחרר מצא ושרשר פרצות ב-Chrome, Safari, Android, Windows ו-Linux. מה הפוסט של 27 באוקטובר טוען, תנאי הגילוי, העצה למגנים, והמספרים שהוא לא נותן.
יומן הבנייה
לעקוב אחרי העבודה.
מאמרים ואבטיפוסים חדשים, ישר לקורא ה-RSS שלכם. מנויי המייל בהשהיה זמנית, עד שאחבר שירות משלוח עובד. לא נאסף כאן אימייל.
עקבו ב-RSS