Getting started with adk

[andycandy]

Related Issue

Closes #708

Description

This PR adds the first ADK example notebook (Getting_started_with_ADK.ipynb) to the examples/google-adk/ directory set up in #709.

Purpose

• Introduces basic ADK usage for stateful workflows involving Gemini.
• Demonstrates core components (Agent, Tool, State, Runner) in action.
• Serves as the initial example for the google-adk section.

What's in the notebook (Getting_started_with_ADK.ipynb)

It walks through a simple 'Stateful Echo Agent'. The agent echoes input but uses an ADK FunctionTool (and ToolContext) to update its status (START -> PROCESSING -> END) in the SessionState. So, it shows the core LlmAgent (with Gemini), Tool, State, and Runner working together in a basic way.

When reviewing, could you check if:

• The basic ADK setup and the state-tracking workflow make sense?
• Is it clear enough for someone new to ADK?
• Does it fit the general style of the cookbook examples?

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[andycandy]

@Giom-V Could you please review this?

[Giom-V]

Hello @andycandy. Thanks for this guide as I'm curious about ADK but did not have the time to actually try it yet.

I think it's a good intro to ADK, but TBH I think the main issue is that it's not clear what ADK brings that classic function calling cannot do. But it's not an easy question to answer so we can keep it as it is now.

[Giom-V]

I'm not sure you really need dotenv in this case. What does it bring you?

[andycandy]

Sorry I didn't explain what it does, the adk as you can see, can access the gemini models, right? But if you pay attention we never gave it any API keys, it's not a mistake, but it's just how ADK is supposed to work, you load your API in the environment with a specific variable name, and ADK picks up API key from there. TBH I wasn't also a fan of this, google-genai handles this much more gracefully

[Giom-V]

You should also add a link in the examples/ README

[andycandy]

Hello @andycandy. Thanks for this guide as I'm curious about ADK but did not have the time to actually try it yet.

I think it's a good intro to ADK, but TBH I think the main issue is that it's not clear what ADK brings that classic function calling cannot do. But it's not an easy question to answer so we can keep it as it is now.

Hey @Giom-V, really glad you came to check this. A few days ago, I proposed a notebook (#715) that focuses specifically on demonstrating how ADK improves on classic function calling.

While there are many advantages, the core idea I wanted to highlight in that proposal was ADK's ability to handle actions asynchronously. The workflow I outlined shows how ADK can orchestrate multiple tool calls without blocking, making it especially powerful in more dynamic or multi-step application flows.
Here is the copy of workflow image I drafted

[Giom-V]

Hey @Giom-V, really glad you came to check this. A few days ago, I proposed a notebook (#715) that focuses specifically on demonstrating how ADK improves on classic function calling.

Nice, I'll check it tomorrow!