Change8

Migrating to LlamaIndex v0.12.48

Version v0.12.48 introduces 1 breaking change. This guide details how to update your code.

Released: 7/9/2025

1
Breaking Changes
1
Migration Steps
9
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

AgentWorkflowStartEventContext.getContext.setContext.store.getContext.store.setGoogleGenAIIntelEmbeddingCallbackManagerLlamaCloudIndex

Breaking Changes

Issue #1

The Context API has changed: ctx.get and ctx.set have been replaced by ctx.store.get and ctx.store.get. Code relying on the old methods will fail.

Migration Steps

  1. 1
    Update any calls to 'ctx.get()' or 'ctx.set()' to 'ctx.store.get()' and 'ctx.store.set()' respectively when working with Context objects.

Release Summary

This release introduces breaking changes to the Context API, adds Cached Content support for Google GenAI, and includes several bug fixes across core, OCI, and LlamaCloud integrations.

Need More Details?

View the full release notes and all changes for LlamaIndex v0.12.48.

View Full Changelog