Обновления Python SDK Anthropic: поддержка OpenTelemetry и новые параметры API
github:anthropics/anthropic-sdk-python · оригинал
Материал подготовлен автоматизированной редакционной системой. Факты можно сверить по указанному первоисточнику.
Компания Anthropic выпустила версии v1.14.0 и v1.15.0 официального Python SDK, добавив нативную поддержку трассировки OpenTelemetry и расширяя функциональность API для управления агентами и лимитами расходов. Обновления также включают исправления ошибок в потоковой передаче данных и уточнения в документации.
Внедрение нативной поддержки OpenTelemetry упрощает мониторинг производительности приложений на базе Claude, а новые параметры API предоставляют разработчикам более точный контроль над поведением моделей и администрированием организаций.
Anthropic представила два последовательных обновления официального Python SDK — версии v1.14.0 и v1.15.0. Ключевым нововведением в версии v1.14.0 стала нативная поддержка трассировки OpenTelemetry. Согласно документации, если приложение регистрирует глобальный провайдер трассировщика, SDK автоматически создает спаны и экспортирует их вместе с остальными трейсами. Также запросы получают заголовки контекста трассировки от глобального пропагатора. Разработчики могут отключить эту функцию, передав аргумент `open_telemetry=False` в клиенте или установив переменную окружения `ANTHROPIC_OPEN_TELEMETRY=false`. В этой же версии были добавлены новые поля в API: `execution_identity` для управляемых агентов (Managed Agents) и новый тип ошибки `organization_type_not_supported` в списках лимитов расходов. Кроме того, в Admin API появились эндпоинты для управления целями телеметрии (telemetry destinations), включая тестовый эндпоинт для проверки их работоспособности.
Версия v1.15.0 фокусируется на расширении возможностей моделей и улучшении пользовательского опыта. В типы возможностей моделей добавлено поле `between_tools` для thinking-типов, что позволяет более гибко конфигурировать поведение модели при работе с инструментами. В объект Messages введен новый параметр `speed`, а также добавлено поле `usage.speed` для отслеживания использования этого параметра. Важно отметить, что согласно документации, некоторые модели требуют заголовок beta для активации функции speed. Для организаций Console теперь возвращается лимит расходов (spend cap) как read-only значение, что упрощает мониторинг бюджетов.
Обе версии содержат ряд исправлений ошибок и улучшений в инфраструктуре. В v1.14.0 исправлена логика закрытия прерванных потоков (dropped streams), теперь они закрываются без ожидания сборщика данных. Также устранена проблема с исключением «Unexpected event order» для событий, предшествующих message_start. В документации уточнены описания префилла, thinking, fallback и моделей, а также добавлено пояснение о том, что флаг `is_enabled` всегда истинен для пользовательских лимитов расходов. В v1.15.0 улучшена скорость обнаружения ломающих изменений в CI-пайплайне, а также добавлены тесты для опций OpenTelemetry и таймаутов по умолчанию методов. Эти обновления делают SDK более стабильным и удобным для интеграции в корпоративные системы мониторинга и управления затратами.