Обновления Python SDK от Anthropic: новые возможности API и исправления ошибок

github:anthropics/anthropic-sdk-python · оригинал

Материал подготовлен автоматизированной редакционной системой. Факты можно сверить по указанному первоисточнику.

Anthropic выпустила версии v2.10.0 и v2.11.0 официального Python SDK, добавив поддержку новых параметров биллинга и расширив набор кодов ошибок в Admin API. Обновления также включают исправление кодировки пробелов в запросах и оптимизацию производительности структурированных выходов.

Эти изменения улучшают стабильность интеграций с Claude, уточняют логику работы с биллингом и ошибками, а также повышают эффективность работы со структурированными данными для разработчиков.

Компания Anthropic представила два новых релиза официального Python SDK: v2.10.0 и v2.11.0. Эти обновления направлены на расширение функциональности API, исправление критических ошибок клиентской части и улучшение документации для разработчиков, работающих с платформой Claude.

В версии v2.11.0 ключевым нововведением стало добавление управляемых настроек Claude Code в Admin API. Это позволяет администраторам более гибко контролировать параметры работы инструментов разработки. Кроме того, в методы плагина Admin API была добавлена новая ошибка sandbox_egress_restricted, что помогает точнее диагностировать проблемы с сетевыми ограничениями в песочницах.

Существенное внимание уделено исправлению ошибок в клиентской части. Разработчики починили проблему с кодировкой пробелов в строках запросов: теперь они кодируются как %20. Это изменение гарантирует, что подпись AWS SigV4 для запроса будет соответствовать его строке запроса, если параметр содержит пробелы, устраняя потенциальные сбои аутентификации.

С точки зрения производительности, версия v2.11.0 оптимизирует работу со структурированными выводами (structured outputs). Теперь схема вывода для каждого вызова строится на основе кэшированного «сырого» схемы, что снижает накладные расходы при обработке данных.

Версия v2.10.0 фокусируется на расширении возможностей биллинга и обработки ошибок. В API добавлена бета-поддержка параметра запроса billing_policy, а также введены новые коды ошибок для сообщений: contract_spend_limit_reached, user_profile_billing_not_authorized и ошибки, связанные с отказом в биллинге для связанных счетов.

Также в v2.10.0 добавлены события вебхуков для отслеживания сбоев и восстановления внешних ключей. Исправлена ошибка, из-за которой неудачные соединения aiohttp ошибочно сообщались как тайм-ауты. Кроме того, сохранена обратная совместимость: устаревшие псевдонимы моделей и типы, вложенные под ними, продолжают работать.

Документация была обновлена для большей ясности. В v2.11.0 объяснено различие между типами лимитов на входные токены, а также указано, что провайдер и имя внешнего ключа Google Cloud не могут быть изменены после создания. В v2.10.0 уточнено, какие ключи AWS KMS можно использовать в рабочей области на Claude Platform on AWS, а также разъяснено, какие загрузки удерживает фиксация плагина. Важно отметить, что поле content_scan.reason при ошибочном сканировании теперь объясняет отсутствие вердикта, а не является признаком безопасности.