[AGE-3440] [Doc] Google ADK Observability Example and Docs

[CyrusNamjoo]

Hello Agenta team,

This PR adds an initial Google ADK observability example, including:

• a simple weather-agent workflow using the Google ADK Python SDK
• OpenInference instrumentation (GoogleADKInstrumentor)
• an async workflow wrapped with @ag.instrument()
• tracing demonstrated through a minimal runnable example

Before completing the full documentation page, I would appreciate your guidance on one point:

How should the spans from Google ADK ideally appear inside the Agenta observability UI? For example, I would like to confirm the expected parent/child span relationships between:

• the workflow span
• the ADK runtime / agent execution
• tool calls
• model responses

If there is a preferred or recommended structure that aligns with other integrations (e.g., LangChain, PydanticAI, LiteLLM), please let me know so I can adjust the example accordingly.

Thank you for you

[CLAassistant]

All committers have signed the CLA.

[vercel[bot]]

@CyrusNamjoo is attempting to deploy a commit to the agenta projects Team on Vercel.

A member of the Team first needs to authorize it.

[mmabrouk]

Hey @CyrusNamjoo

Thanks a lot for the PR!

Answering your question. The relationship is the following:

• The workflow span is the parent span (so basically you usually instrument the function that includes the entrypoint call to the Google ADK with @ag.instrument()
• The rest is auto-instrumented by the autoinstrumentation library in any case we cannot change the structure

If you would add screenshots of the trace as you see it in Agenta, what is the tree and what are the inputs/outputs of each span I can provide feedback if anything seems wrong.

[vercel[bot]]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
agenta-documentation	Ready	Preview	Comment	Nov 24, 2025 10:50am

[CyrusNamjoo]

Hi @mmabrouk Thanks again for your guidance so far. Actually Everything runs without errors and the model responds normally. However: I still do not see any traces appear in the Agenta UI (Observability). I checked all filters, time ranges, and environments. Could you please advise what might still be missing in this setup, or whether requires another configuration step for traces to appear?

Thanks a lot for your help, once I resolve this last part, I will finalize and update the documentation and also the notebook accordingly.

[CyrusNamjoo]

This is my agenta account.

[mmabrouk]

Can you please upgrade the SDK and try again. We had a bug in 0.62.8 that was fixed 0.62.9

[CyrusNamjoo]

Can you please upgrade the SDK and try again. We had a bug in 0.62.8 that was fixed 0.62.9

I think it works. Thank you!

[CyrusNamjoo]

Hello, I wanted to kindly check whether my pull request has been reviewed or if anything else is needed from my side. Thank you.

[mmabrouk]

Hey @CyrusNamjoo

Thanks a lot! I will try to review it the next couple of days!