Python SDK (@anthropic)
Тема дорожной карты · Claude от Anthropic
Python SDK от Anthropic представляет собой официальное программное обеспечение для взаимодействия с Messages API. Оно включает синхронный клиент Anthropic, асинхронный AsyncAnthropic, а также механизмы автоматических ретраев и стриминга через client.messages.stream. SDK поддерживает использование инструментов и предоставляет адаптеры для работы с Bedrock и Vertex. Установка пакета осуществляется с помощью команды pip install anthropic, а авторизация производится через переменную окружения ANTHROPIC_API_KEY. Это решение предлагает типизированные модели запросов и ответов, поддержку кэширования промптов, загрузку файлов и использование поля extra_headers для тестирования новых функций. Этот подход является рекомендованным для разработки бэкенд-сервисов и агентских циклов.
Как это работает
Python SDK (@anthropic) предоставляет официальные средства для взаимодействия с API Anthropic на Python (anthropic), TypeScript (@anthropic-ai/sdk), Java и Go. Эти инструменты включают механизмы автоматических ретраев, стриминга, типизированного построения сообщений и кэширования промптов. Взаимодействие с API осуществляется через паттерны, такие как client.messages.create(...) для выполнения одного запроса и client.messages.stream(...) для стриминга. Инструменты представлены как типизированные аргументы, что упрощает их использование. Agent SDK (Python + TypeScript) предоставляет более высокий уровень абстракции для построения агентов с определенными навыками, хуками и циклами использования инструментов.
Когда применять
Python SDK (@anthropic) следует использовать везде, где требуется взаимодействие с Messages API, а создание собственного HTTP-клиента нецелесообразно. Agent SDK (@anthropic) особенно полезен при разработке сложных систем, требующих оркестрования различных компонентов. Кэширование промптов следует использовать с самого начала работы с API, так как оно окупается уже после десяти запросов для повторяющегося контекста. Важно также начинать логирование затрат с самого начала, записывая метрики использования для каждого запроса.
Типичные ошибки
Когда используют Python SDK (@anthropic), могут возникнуть различные ошибки. Например, неправильное использование асинхронных запросов может привести к обрыву потока данных, что приведет к неполной обработке ответа. Также следует избегать жесткого кодирования версий моделей в клиентском коде, что может затруднить обновление и поддержку различных версий API. Вместо этого следует использовать переменные окружения для хранения ключей доступа и других параметров. Кроме того, использование одного запроса вместо использования батч-запросов может привести к блокировке и снижению производительности.