Grafana AI Observability Python Framework Module: Pydantic AI

sigil-sdk-pydantic-ai provides an AbstractCapability implementation that maps Pydantic AI lifecycle hooks into Sigil generation recorder lifecycles.

Installation

pip install sigil-sdk sigil-sdk-pydantic-ai
pip install pydantic-ai

Quickstart

from pydantic_ai import Agent
from sigil_sdk import Client
from sigil_sdk_pydantic_ai import create_sigil_pydantic_ai_capability

client = Client()
capability = create_sigil_pydantic_ai_capability(client=client, provider_resolver="auto")

agent = Agent("openai:gpt-4o", capabilities=[capability])
result = agent.run_sync("What is the weather?")
print(result.output)

client.shutdown()

End-to-end example (run + run_stream)

from pydantic_ai import Agent
from sigil_sdk import Client
from sigil_sdk_pydantic_ai import with_sigil_pydantic_ai_capability

client = Client()
capabilities = with_sigil_pydantic_ai_capability(
    None,
    client=client,
    provider_resolver="auto",
    agent_name="pydantic-ai-example",
    agent_version="1.0.0",
)

agent = Agent("openai:gpt-4o-mini", capabilities=capabilities)

# Non-stream call -> SYNC generation mode.
result = agent.run_sync("Summarize why retry budgets matter.")
print(result.output)

# Stream call -> STREAM generation mode + TTFT tracking.
async def stream_example() -> None:
    async with agent.run_stream("Give me three short reliability tips.") as stream:
        async for chunk in stream.stream_text():
            print(chunk, end="", flush=True)
        print()

import asyncio
asyncio.run(stream_example())

client.shutdown()

Conversation mapping

Primary mapping is Pydantic AI run identity:

conversation_id / session_id from ctx.deps or ctx.metadata
thread_id from ctx.deps or ctx.metadata
fallback sigil:framework:pydantic-ai:<run_id>

Metadata and lineage

Required: sigil.framework.run_type
Optional: sigil.framework.run_id, sigil.framework.parent_run_id, sigil.framework.thread_id, sigil.framework.event_id, sigil.framework.component_name, sigil.framework.retry_attempt

Provider resolver

Resolver order: explicit provider option -> callback payload -> model prefix inference -> custom.

Troubleshooting

Provide stable conversation_id via ctx.deps or ctx.metadata to avoid fragmented conversations.
If model aliases are custom, set explicit provider on the handler.
Always call client.shutdown() during teardown to flush buffered telemetry.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sigil_sdk_pydantic_ai-0.9.3.tar.gz (13.0 kB view details)

Uploaded Jul 13, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

sigil_sdk_pydantic_ai-0.9.3-py3-none-any.whl (9.0 kB view details)

Uploaded Jul 13, 2026 Python 3

File details

Details for the file sigil_sdk_pydantic_ai-0.9.3.tar.gz.

File metadata

Download URL: sigil_sdk_pydantic_ai-0.9.3.tar.gz
Upload date: Jul 13, 2026
Size: 13.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for sigil_sdk_pydantic_ai-0.9.3.tar.gz
Algorithm	Hash digest
SHA256	`93df3ce7c042f669387253363bdb352d8d0aad6354762857b1454719e3a82bf7`
MD5	`7a944b490cb07758f803565175ceed07`
BLAKE2b-256	`7a73690e0b5ee592abcee9125d36a52e110d16eb29fa374d459b7d4d9502b7f7`

See more details on using hashes here.

Provenance

The following attestation bundles were made for sigil_sdk_pydantic_ai-0.9.3.tar.gz:

Publisher: python-sdks-publish.yml on grafana/sigil-sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: sigil_sdk_pydantic_ai-0.9.3.tar.gz
- Subject digest: 93df3ce7c042f669387253363bdb352d8d0aad6354762857b1454719e3a82bf7
- Sigstore transparency entry: 2162889457
- Sigstore integration time: Jul 13, 2026
Source repository:
- Permalink: grafana/sigil-sdk@8e55285662dbc449c6eef239b02ade84e1edee9f
- Branch / Tag: refs/heads/main
- Owner: https://github.com/grafana
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-sdks-publish.yml@8e55285662dbc449c6eef239b02ade84e1edee9f
- Trigger Event: workflow_dispatch