Skip to main content

Lab 1 Challenge: Your First Interaction

Goal​

The goal of this first lab is to familiarize yourself with the available resources for learning and using the Google Agent Development Kit (ADK). You won't be writing any code yet; instead, you'll be exploring the official documentation and code repositories to understand where to find information and inspiration.

Step 1: Navigate the Official Documentation​

The official ADK documentation is the most important resource you will use. It's your primary source for tutorials, guides, and API references.

  1. Open the Documentation: In your web browser, go to the main page of this documentation site.
  2. Explore the "Get Started" Section: On the left sidebar, find the "Get started" section. Click through the pages like About, Installation, and Quickstart. Skim through these pages to get a high-level overview of what the ADK is and how to set it up.
  3. Browse the "Agents" Section: Look at the "Agents" section in the sidebar. Notice the modern Agent class which replaces the legacy LlmAgent.
  4. Explore the "Workflows" Section: This is the heart of ADK 2.0. Look at how you can build graphs using Workflow and Edges.

Key Takeaway: The documentation is your best friend. Ensure you are looking at the ADK 2.0+ sections to follow the modern best practices.

Step 2: Discover the Official Code Repositories​

The ADK is an open-source project with repositories on GitHub. These repositories contain the source code, issue trackers, and, most importantly, a wealth of examples.

  1. Find the ADK Python Repository: Search on Google or GitHub for "Google ADK Python".
  2. Verify the Version: Check the latest releases. You should see references to ADK 2.0 GA or higher.
  3. Explore the examples directory: Look for samples that use the Workflow class. Navigating into contributing/samples/hello_world is still a great starting point, but notice how it now uses the App and Runner pattern.
  4. Examine the Code: Click on the Python files (agent.py and main.py). Read through the code and the comments. Try to connect what you see in the code with the concepts you skimmed in the documentation (e.g., creating an Agent).

Scavenger Hunt!

Find the hello_world example and identify the name of the main function used to run the agent.

Key Takeaway: The official examples are the best place to find working code that you can learn from and adapt for your own projects.

Step 3: Understand the Community and Support Channels​

  1. Issues Tab: On the GitHub repository, click on the "Issues" tab. This is where developers report bugs and request new features. Browsing through the issues can give you insight into the current state of the project and common problems users face.
  2. Discussions Tab: If available, the "Discussions" tab is a place for community conversations, questions, and sharing ideas.

Lab Summary​

Congratulations, you've completed your first lab! You now know:

  • How to navigate the official ADK documentation to find guides and references.
  • Where to find official, working code examples in the GitHub repository.
  • Where to look for community support and project updates.

In the next module, you will use this knowledge to set up your own local development environment and prepare for building your first agent.

Self-Reflection Questions​

  • Why is it important to have official documentation and code examples for a framework like the ADK?
  • Based on the file names in the examples directory, what are some of the advanced capabilities you think the ADK might have?
  • How can community support channels like GitHub Issues and Discussions accelerate your learning process?

🕵️ Hidden Solution 🕵️​

Looking for the solution? Here's a hint (Base64 decode me): L2RvYy1hZGstdHJhaW5pbmcvbW9kdWxlMDEtaW50cm8tdG8tYWktYWdlbnRzL2xhYi1zb2x1dGlvbg==

The direct link is: Lab Solution