Pydantic AI
Pydantic AI — агентный Python-фреймворк от команды Pydantic: типобезопасная разработка production-агентов на LLM с валидацией вывода.
Что это
Pydantic AI — агентный Python-фреймворк от команды Pydantic: типобезопасная разработка production-агентов на LLM с валидацией вывода.
Установка
Точная команда установки указана в официальном репозитории.
Перед запуском настройте API-ключи и переменные окружения, перечисленные в официальной документации проекта.
Что нового в версиях
Релиз v2.70.0: новые возможности для Skills, StreamGuardrail, PruneToolResults и улучшенная работа с провайдерами.
- НовоеДобавлен StreamGuardrail для фильтрации потокового текста, мыслей и вызовов инструментов до их передачи вызывающей стороне.
- НовоеВведена возможность чтения связанных файлов в Skills через read_files=True с подстановкой плейсхолдеров ${SKILL_DIR}.
- НовоеДобавлен PruneToolResults, позволяющий модели заменять полученные результаты инструментов их кратким резюме.
- НовоеРасширены настройки HuggingFaceModelSettings: добавлены параметры logprobs и top_logprobs, возвращаемые в provider_details.
- ИсправленоИсправлена отправка идентификаторов элементов рассуждения как полей ассистента в OpenAIChatModel в режиме auto thinking.
- ИсправленоУлучшена обработка ошибок: добавлены проверки для GPT-6 с включенным reasoning и корректная работа Groq с JSON и флагами рассуждений.
Поддержка Gemini 4 Hydrogen и Groq service_tier, улучшена обработка ошибок и детекция циклов в streamed-ответах.
- Ломает совместимостьRequestInput объединён с HandleDeferredToolCalls, принимающим resume token.
- НовоеДобавлена поддержка модели Gemini 4 Hydrogen (gemini-4-hydrogen) в GoogleModel.
- НовоеВ GroqModel добавлена поддержка параметра service_tier.
- ИсправленоРеализована детекция циклов в потоковых ответах (мышление, текст, аргументы инструментов).
- ИсправленоУлучшена классификация ошибок API (QuotaExceeded, RateLimit, HTTPError) для Google, OpenAI и других провайдеров.
- УстарелоВ Advisor устарел параметр mode, вместо него следует использовать native= и local=.
Добавлены GoogleDecisionsModel, RefineOutput, сохранение диалогов; исправлено определение моделей и токенов; улучшена работа с токенами и делегациями.
- НовоеДобавлен бэкенд GoogleDecisionsModel для Gemini Decisions API и возможность сохранения UI-разговоров через ConversationStore.
- НовоеВведена возможность запрашивать одобрение пользователя внутри выполнения (RequestInput) и новая возможность RefineOutput в хэрресе.
- ИсправленоИсправлено определение идентификаторов моделей через карту семейств и корректное маппинг thinking для Z.AI GLM и DeepSeek на Bedrock.
- Ломает совместимостьВведены новые исключения OutputTokenLimitExceeded и изменено поведение ModelFallback при превышении лимита токенов.
- УстарелоПереименованы поля CapabilityEvent и суффиксы событий субагентов; старые имена оставлены как устаревшие алиасы.
Добавлена поддержка SubAgents и DBOS в durable execution, улучшена работа RepoContext и исправлены ошибки потоковой передачи.
- НовоеДобавлена поддержка SubAgents с динамическими агентами в durable execution.
- НовоеРеализовано выполнение вызовов инструментов как дочерних рабочих процессов DBOS.
- НовоеУлучшена работа RepoContext: поддержка вложенных файлов, ограничение длины инструкций и автоматическая загрузка.
- ИсправленоИсправлена обработка потоковых ответов OpenAI без history_digest и статусов failed вызовов инструментов.
- Ломает совместимостьПоля провайдеров перенесены в provider_settings, а CodeMode инструменты, совпадающие с встроенными, теперь отклоняются.
Критические уязвимости в web_fetch, редактировании секретов и AG-UI, требующие немедленного обновления.
- ИсправленоИсправлена DoS-уязвимость в web_fetch: рекурсивная индентация JSON могла исчерпать память.
- ИсправленоУстранено экспоненциальное зависание event loop при редактировании секретов с паттерном private_key.
- ИсправленоДобавлен в блоклист адрес метаданных Tencent Cloud для предотвращения утечки временных учетных данных.
- ИсправленоИсправлено раскрытие учетных данных в OpenTelemetry-спанах через extra_headers и extra_body.
- ИсправленоУстранены уязвимости типа ReDoS и DoS в AG-UI и DecisionModel при обработке пользовательских схем.
- ИсправленоИсправлена десериализация истории сообщений, предотвращающая несанкционированные загрузки файлов.
Добавлен WebSocket-транспорт, хранилище диалогов и улучшена обработка отказов моделей и ошибок лимитов.
- НовоеДобавлен WebSocket-транспорт для OpenAI Responses и класс ConversationStore для ведения истории переписки.
- НовоеУлучшена работа с отказами моделей: ModelFallback теперь корректно обрабатывает ContentFilterError, а Z.ai использует ModelQuotaExceededError.
- НовоеПоддержка 12-часового кэширования промптов в OpenAI Responses для GPT-5.6+ и нативных системных промптов в OpenRouter.
- ИсправленоИсправлены ошибки при фильтрации контента в Azure, обработке ошибок Bedrock и очистке ресурсов Playwright.
- НовоеУлучшена парсинг docstring для параметров инструментов и добавлена настройка allowed_callers для Anthropic web tools.
Внедрена система ModelFallback для отказоустойчивости, добавлен BoxdSandbox и улучшена работа с токенами и оценками.
- Ломает совместимостьОшибка при исчерпании попыток ретрансляции теперь возвращается как ModelHTTPError, что меняет логику обработки сбоев.
- НовоеДобавлена возможность ModelFallback, позволяющая конструировать механизм переключения моделей из спецификаций агентов.
- НовоеПоявился BoxdSandbox — изолированное рабочее пространство для запуска Coder, Shell и других возможностей harness.
- НовоеВ Azure AI Voice Live и ElevenLabs Agents добавлена опция output_speech_timestamps для отслеживания таймингов речи.
- ИсправленоИсправлен подсчет токенов в AnthropicModel, который ранее ошибочно отклонял отложенные запросы и занижал счетчик.
Добавлена поддержка GPT-6.1-terra, IPythonCodeMode, DetectLoops и PostgreSQL SpendStore; изменено поведение CodeMode по умолчанию.
- Ломает совместимостьCodeMode по умолчанию переключен на dynamic_catalog=True, что меняет логику добавления инструментов в кэш.
- НовоеДобавлена поддержка модели OpenAI gpt-6.1-terra.
- НовоеВнедрен IPythonCodeMode для выполнения кода в среде IPython.
- НовоеПоявилась возможность обнаружения зацикливаний через capability DetectLoops.
- НовоеДобавлен PostgresSpendStore для распределения бюджетов затрат через PostgreSQL.
- ИсправленоИсправлены проблемы с эскейпингом тегов, повторной записью данных при реплее и корректной работой с Azure rate-limit.
Все релизы на GitHub → Пересказ на русском — по заметкам к релизам и коммитам.