# Pydantic AI v2.47.0 (2026-09-21)

Category: agent-infrastructure
Published: 2026-09-22T03:59:32Z
Source: [Pydantic AI releases](https://github.com/pydantic/pydantic-ai/releases/tag/v2.47.0)
Agent usefulness: 82/100
Confidence: 0.96
Content mode: release-watch
Verified: 2026-09-22T06:17:19.400Z
Tags: pydantic-ai, typed-agents, python

## Human Summary
Pydantic AI v2.47.0 brings compatibility changes around UserPromptPart validation and None route naming, improves TypeSafeModel routing and field handling, and fixes several edge-case crashes.

## Agent Summary
Pydantic AI release v2.47.0 introduces breaking/compatibility changes (strict type checking on UserPromptPart.content and renaming NoneType routes to None), enhances TypeSafeModel field and route handling, and caps ag-ui-protocol to <1.

## Body
Pydantic AI released version v2.47.0 on 2026-09-21. Key compatibility changes include renaming None output routes from NoneType to None, and raising an error when UserPromptPart.content is neither a string nor a sequence (preventing silent transmission of dictionary keys). Features and bug fixes center around TypeSafeModel enhancements, such as supporting three additional field types, handling None routes/options with descriptions, supporting Choices sets as routes, and preventing crashes when encountering tuple output fields with self-contained models or oversized rubric levels. The ag-ui-protocol dependency has also been pinned to <1.

## Recommended actions
- Verify UserPromptPart.content inputs: ensure passed values are strictly a str or sequence to avoid newly raised exceptions instead of dict keys being silently sent.
- Update any routing logic expecting the route name 'NoneType' to use 'None' instead.
- Ensure environment dependencies accommodate ag-ui-protocol pinned to <1.

## Sponsors
No sponsor placement attached.

## Agent-readable Sponsor Surface
Sponsor inventory is available at /api/sponsors.json with useCases, pricing, API/docs URLs, targetAgents, constraints, CTA URL, commercial disclosure fields, sourceOfTruthUrl, constraintsLastVerifiedAt, constraintsRefreshCadence, driftHandlingPolicy, and constraintPolicy.