AIKraft/Агенты/Pydantic AI

Pydantic AI

Pydantic AI — агентный Python-фреймворк от команды Pydantic: типобезопасная разработка production-агентов на LLM с валидацией вывода.

PYPydantic Фреймворк агентов Python ★ 21.3k

Что это

Pydantic AI — агентный Python-фреймворк от команды Pydantic: типобезопасная разработка production-агентов на LLM с валидацией вывода.

Установка

Точная команда установки указана в официальном репозитории.

1Быстрый старт
from pydantic_ai import Agent # Define a very simple agent including the model to use, you can also set the model when running the agent. agent = Agent( 'anthropic:claude-sonnet-4-6', # Register static instructions using a keyword argument to the agent. # For more complex dynamically-generated instructions, see the example below. instructions='Be concise, reply with one sentence.', ) # Run the agent synchronously, conducting a conversation with the LLM. result = agent.run_sync('Where does "hello world" come from?') print(result.output) """ The first known use of "hello, world" was in a 1974 textbook about the C programming language. """

Перед запуском настройте API-ключи и переменные окружения, перечисленные в официальной документации проекта.

Что нового в версиях

v2.70.017 ноября 2026 г.

Релиз 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 и флагами рассуждений.
v2.69.017 ноября 2026 г.Ломает совместимость

Поддержка 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=.
v2.68.012 ноября 2026 г.Ломает совместимость

Добавлены GoogleDecisionsModel, RefineOutput, сохранение диалогов; исправлено определение моделей и токенов; улучшена работа с токенами и делегациями.

  • НовоеДобавлен бэкенд GoogleDecisionsModel для Gemini Decisions API и возможность сохранения UI-разговоров через ConversationStore.
  • НовоеВведена возможность запрашивать одобрение пользователя внутри выполнения (RequestInput) и новая возможность RefineOutput в хэрресе.
  • ИсправленоИсправлено определение идентификаторов моделей через карту семейств и корректное маппинг thinking для Z.AI GLM и DeepSeek на Bedrock.
  • Ломает совместимостьВведены новые исключения OutputTokenLimitExceeded и изменено поведение ModelFallback при превышении лимита токенов.
  • УстарелоПереименованы поля CapabilityEvent и суффиксы событий субагентов; старые имена оставлены как устаревшие алиасы.
v2.67.010 ноября 2026 г.Ломает совместимость

Добавлена поддержка SubAgents и DBOS в durable execution, улучшена работа RepoContext и исправлены ошибки потоковой передачи.

  • НовоеДобавлена поддержка SubAgents с динамическими агентами в durable execution.
  • НовоеРеализовано выполнение вызовов инструментов как дочерних рабочих процессов DBOS.
  • НовоеУлучшена работа RepoContext: поддержка вложенных файлов, ограничение длины инструкций и автоматическая загрузка.
  • ИсправленоИсправлена обработка потоковых ответов OpenAI без history_digest и статусов failed вызовов инструментов.
  • Ломает совместимостьПоля провайдеров перенесены в provider_settings, а CodeMode инструменты, совпадающие с встроенными, теперь отклоняются.
v2.66.04 ноября 2026 г.

Критические уязвимости в web_fetch, редактировании секретов и AG-UI, требующие немедленного обновления.

  • ИсправленоИсправлена DoS-уязвимость в web_fetch: рекурсивная индентация JSON могла исчерпать память.
  • ИсправленоУстранено экспоненциальное зависание event loop при редактировании секретов с паттерном private_key.
  • ИсправленоДобавлен в блоклист адрес метаданных Tencent Cloud для предотвращения утечки временных учетных данных.
  • ИсправленоИсправлено раскрытие учетных данных в OpenTelemetry-спанах через extra_headers и extra_body.
  • ИсправленоУстранены уязвимости типа ReDoS и DoS в AG-UI и DecisionModel при обработке пользовательских схем.
  • ИсправленоИсправлена десериализация истории сообщений, предотвращающая несанкционированные загрузки файлов.
v2.65.03 ноября 2026 г.

Добавлен 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.
v2.64.030 октября 2026 г.Ломает совместимость

Внедрена система ModelFallback для отказоустойчивости, добавлен BoxdSandbox и улучшена работа с токенами и оценками.

  • Ломает совместимостьОшибка при исчерпании попыток ретрансляции теперь возвращается как ModelHTTPError, что меняет логику обработки сбоев.
  • НовоеДобавлена возможность ModelFallback, позволяющая конструировать механизм переключения моделей из спецификаций агентов.
  • НовоеПоявился BoxdSandbox — изолированное рабочее пространство для запуска Coder, Shell и других возможностей harness.
  • НовоеВ Azure AI Voice Live и ElevenLabs Agents добавлена опция output_speech_timestamps для отслеживания таймингов речи.
  • ИсправленоИсправлен подсчет токенов в AnthropicModel, который ранее ошибочно отклонял отложенные запросы и занижал счетчик.
v2.63.028 октября 2026 г.Ломает совместимость

Добавлена поддержка 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 → Пересказ на русском — по заметкам к релизам и коммитам.