Starstruk Logo MarkStarstruk

v1.69.0

pydantic/pydantic-aiv1.69.0Mar 17, 2026by DouweM

AI Summary

Introduces a description parameter for Agents and enhances multimodal tool handling and fallback logic.

Key Highlights

  • Added `description` parameter to `Agent` and set `gen_ai.agent.description` on span
  • Send multimodal tool results to APIs directly instead of splitting into user parts
  • Added response-based fallback support for `FallbackModel`

New Features

  • Agent description parameter
  • Multimodal tool result handling
  • FallbackModel response-based fallback

Full Release Notes

<!-- Release notes generated using configuration in .github/release.yml at main -->

## What's Changed
### 🚀 Features
* Add `description` parameter to `Agent` and set `gen_ai.agent.description` on span by @Kludex in https://github.com/pydantic/pydantic-ai/pull/4677
* Send multimodal tool results to APIs directly instead of splitting into user parts by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/3826
* Add response-based fallback support for `FallbackModel` by @sarth6 in https://github.com/pydantic/pydantic-ai/pull/3786
### 🐛 Bug Fixes
* fix: enforce deps type on `FunctionToolset.tool` via `tool`/`tool_plain` split by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/4626
* fix: copy `details` dict in `Usage.__add__` to prevent mutation of or… by @sksvineeth in https://github.com/pydantic/pydantic-ai/pull/4606


**Full Changelog**: https://github.com/pydantic/pydantic-ai/compare/v1.68.0...v1.69.0