pydantic/pydantic-ai

Что это?

Ключевые возможности

• 01Переключение между множеством провайдеров моделей с помощью строки с названием модели.
• 02Структурированные данные с валидацией и типизированные функции-инструменты с внедрением зависимостей.
• 03Запуск одного и того же агента через CLI, веб-чат, голосовую сессию в реальном времени или поток событий UI.
• 04Надёжное выполнение задач на движках вроде Temporal, DBOS и Prefect.
• 05Инструментирование на базе OpenTelemetry для трассировки вызовов моделей и инструментов.
• 06Генерация изображений и эмбеддинги в том же пакете.

Сценарии использования

• Создание типизированного конвейера извлечения данных, который возвращает валидированные модели Pydantic на основе вывода LLM.
• Создание длительно работающего исследовательского агента, который должен переживать перезапуски благодаря Temporal или DBOS.
• Добавление голосового помощника, вызывающего внутренние инструменты во время разговора в реальном времени.
• Оценка ответов агента и работы с инструментами на тестовом наборе данных.

Быстрый старт

1. 1

   Установите пакет с помощью uv

   uv add pydantic-ai
2. 2

   Создайте файл Python с Agent и вызовите agent.run_sync(...), чтобы получить типизированный результат

Что важно знать

• !Для запуска примеров с размещёнными моделями нужен API-ключ соответствующего провайдера, но в README это подробно не объясняется.
• !Для долговечного выполнения, голосовой связи в реальном времени и других расширенных возможностей нужны дополнительные установки и отдельный бэкенд, например Temporal.

Темы

Частые вопросы

Что такое pydantic-ai?

Python SDK для создания типизированных AI-агентов, работающих с разными моделями, веб-интерфейсами, CLI, голосом и длительными фоновыми задачами. Pydantic AI — это Python SDK для создания AI-агентов с типизированными входными и выходными данными и зависимостями. Модели провайдеров OpenAI, Anthropic, Google, Groq и других можно менять, указав другую строку, а одного и того же агента можно предоставить через CLI, встроенный веб-чат, голосовые сессии в реальном времени или потоки событий UI для интеграции с фронтендом.

pydantic-ai можно использовать бесплатно? Какая у него лицензия?

pydantic-ai распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

pydantic-ai всё ещё поддерживается?

Активно поддерживается. Последний коммит в pydantic-ai — 20 окт. 2026 г..

Для чего можно использовать pydantic-ai?

Создание типизированного конвейера извлечения данных, который возвращает валидированные модели Pydantic на основе вывода LLM. Создание длительно работающего исследовательского агента, который должен переживать перезапуски благодаря Temporal или DBOS. Добавление голосового помощника, вызывающего внутренние инструменты во время разговора в реальном времени. Оценка ответов агента и работы с инструментами на тестовом наборе данных.

Как установить pydantic-ai?

Установите пакет с помощью uv: uv add pydantic-ai Создайте файл Python с Agent и вызовите agent.run_sync(...), чтобы получить типизированный результат

Где скачать pydantic-ai?

Исходный код и инструкции по установке — на GitHub: https://github.com/pydantic/pydantic-ai