Skip to content

Conversation

@dsfaccini
Copy link
Collaborator

@dsfaccini dsfaccini commented Dec 22, 2025

Closes #3697

@github-actions
Copy link

github-actions bot commented Dec 22, 2025

Docs Preview

commit: 1c6ff69
Preview URL: https://b319af6c-pydantic-ai-previews.pydantic.workers.dev
!!! info "No Native Persistence"
Unlike the [original Graph API](../../graph.md#state-persistence), the beta graph API does not include built-in state persistence. This is due to the [complexity of achieving consistent snapshotting with parallel execution](https://github.com/pydantic/pydantic-ai/issues/530#issuecomment-3504609992).

For workflows that need to preserve progress across failures, restarts, or long-running operations, use one of the supported [durable execution](../../durable_execution/overview.md) solutions:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd rather just link to this doc, without the list below, as it'll get out of date.

!!! info "No Native Persistence"
Unlike the [original Graph API](../../graph.md#state-persistence), the beta graph API does not include built-in state persistence. This is due to the [complexity of achieving consistent snapshotting with parallel execution](https://github.com/pydantic/pydantic-ai/issues/530#issuecomment-3504609992).

For workflows that need to preserve progress across failures, restarts, or long-running operations, use one of the supported [durable execution](../../durable_execution/overview.md) solutions:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd rather just link to this doc, without the list below, as it'll get out of date.

@DouweM DouweM merged commit 14c4ee9 into main Dec 23, 2025
30 checks passed
@DouweM DouweM deleted the clarify-graph-beta-docs branch December 23, 2025 00:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment