v3.1.6

agno-agi/agnov3.1.6Oct 19, 2026by kausmeows

Upgrading?

AI Summary

This release introduces enhanced arguments and file support for evaluation cases, improves the OS Manager's documentation query capabilities, and fixes bugs affecting ParallelTools copying and result offloading.

Key Highlights

  • Eval Cases now support session management and file attachments via Message input.
  • OS Manager directly queries Agno documentation for framework questions.
  • Result offloading now returns multiple passages and supports character limits.
  • ParallelTools copying now preserves live SDK clients without errors.

New Features

  • Added run arguments (session_id, user_id, session_state, etc.) to Eval Cases.
  • Eval Cases can now accept Message input for images and files.
  • OS Manager queries documentation directly instead of delegating unscoped tasks.
  • search_result returns multiple passages from JSON lines.
  • read_result now accepts max_chars to read smaller excerpts.

Full Release Notes

# Changelog

## New Features:

- **Eval Case Run Arguments**: `Case` takes `session_id`, `user_id`, `session_state`, `dependencies`, `metadata` and `knowledge_filters`, forwarded to the agent or team run, and `input` accepts a `Message`, so a case can attach an image or file to the graded turn. Cases sharing a `session_id` run as consecutive turns. See [cookbook](https://github.com/agno-agi/agno/blob/main/cookbook/09_evals/suite/suite_session.py).

## Improvements:

- **OS Manager Docs Access**: OS Manager queries the Agno documentation directly for framework questions instead of delegating to Platform Manager, and keeps delegated tasks scoped to the question. `access_docs` now covers both.
 - **Result Offloading Search and Readback**: `search_result` returns separate passages from one long line, such as single-line JSON, instead of only the first match, and `read_result` takes `max_chars` to read a smaller excerpt.
 
## Bug Fixes:

- **ParallelTools**: Copying an agent or team with `ParallelTools`, as AgentOS does on every request, keeps the live SDK client and gives the copy its own settings, without `RLock` copy errors or `_state` finalizer warnings.

## What's Changed
* feat: add run arguments and Message input to eval Case by @harshsinha03 in https://github.com/agno-agi/agno/pull/10829
* fix: preserve Parallel SDK clients when copying toolkits by @ashpreetbedi in https://github.com/agno-agi/agno/pull/11172
* fix: keep OS Manager focused on the question by @ashpreetbedi in https://github.com/agno-agi/agno/pull/11169
* fix: retrieve focused passages from offloaded tool results by @ashpreetbedi in https://github.com/agno-agi/agno/pull/11171
* chore: Release v3.1.6 by @kausmeows in https://github.com/agno-agi/agno/pull/11170


**Full Changelog**: https://github.com/agno-agi/agno/compare/v3.1.5...v3.1.6

Related Repositories