Quickstart

This quickstart guides you through installing the Agent Development Kit (ADK), setting up a basic agent with multiple tools, and running it locally either in the terminal or in the interactive, browser-based dev UI.

This quickstart assumes a local IDE (VS Code, PyCharm, etc.) with Python 3.9+ and terminal access. This method runs the application entirely on your machine and is recommended for internal development.

1. Setup Environment & Install ADK

Create & Activate Virtual Environment (Recommended):

# Create
python -m venv .venv
# Activate (each new terminal)
# macOS/Linux: source .venv/bin/activate
# Windows CMD: .venv\Scripts\activate.bat
# Windows PowerShell: .venv\Scripts\Activate.ps1

Install ADK:

pip install google-adk

2. Create Agent Project

Using the terminal, create the folder structure:

mkdir multi_tool_agent/
touch \
multi_tool_agent/__init__.py \
multi_tool_agent/agent.py \
multi_tool_agent/.env

Your structure:

parent_folder/
    multi_tool_agent/
        __init__.py
        agent.py
        .env

Copy paste the following code to the respective files:

--8<-- "examples/python/snippets/get-started/multi_tool_agent/__init__.py"

--8<-- "examples/python/snippets/get-started/multi_tool_agent/agent.py"

For .env below, just copy and paste the following code for now, as more instructions are describe in the next section on Setup the model.

--8<-- "examples/python/snippets/get-started/multi_tool_agent/.env"

3. Setup the model

Your agent's ability to understand user requests and generate responses is powered by a Large Language Model (LLM). Your agent needs to make secure calls to this external LLM service, which requires authentication credentials. Without valid authentication, the LLM service will deny the agent's requests, and the agent will be unable to function.

=== "Gemini - Google AI Studio" 1. Get an API key from Google AI Studio. 2. Open the .env file located inside (multi_tool_agent/) and copy-paste the following code. env title="multi_tool_agent/.env" GOOGLE_GENAI_USE_VERTEXAI=FALSE GOOGLE_API_KEY=PASTE_YOUR_ACTUAL_API_KEY_HERE 3. Replace GOOGLE_API_KEY with your actual API KEY.

=== "Gemini - Google Cloud Vertex AI" 1. You need an existing Google Cloud account and a project. * Set up a Google Cloud project * Set up the gcloud CLI * Authenticate to Google Cloud, from the terminal by running gcloud auth login. * Enable the Vertex AI API. 2. Open the .env file located inside (multi_tool_agent/). Copy-paste the following code and update the project ID and location. env title="multi_tool_agent/.env" GOOGLE_GENAI_USE_VERTEXAI=TRUE GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID GOOGLE_CLOUD_LOCATION=LOCATION

4. Run Your Agent

Using the terminal, navigate to the parent directory of your agent project (e.g. using cd ..):

parent_folder/      <-- navigate to this directory
    multi_tool_agent/
        __init__.py
        agent.py
        .env

=== "adk run"

Run the following command, to chat with your Google Search agent.

```
adk run multi_tool_agent
```
To exit, use Cmd/Ctrl+C.

=== "adk web (dev UI)" Run the following command to launch the dev UI.

```
adk web
```

Open the URL provided (usually `http://localhost:8000` or
`http://127.0.0.1:8000`) **directly in your browser**. This connection stays
entirely on your local machine. Select `multi_tool_agent` and interact with the agent.

!!!note
    
    If you do not see "my_sample_agent" in the dropdown menu, make sure you are running `adk web` in the **parent folder** of your agent folder (i.e. the parent folder of my_sample_agent).

1. In the top-left corner of the UI, you can select your agent in the dropdown. Select "my_sample_agent".
2. Now you can chat with your agent.

📝 Example prompts to try

What is the weather in New York?
What is the time in New York?
What is the weather in Paris?
What is the time in Paris?

🎉 Congratulations!

You've successfully created and interacted with your first agent using ADK!

🛣️ Next steps

Go to the tutorial: Learn how to add memory, session, state to your agent: tutorial.
Delve into advanced configuration: Explore the setup section for deeper dives into project structure, configuration, and other interfaces.
Understand Core Concepts: Learn about agents concepts.

5.3 KiB Raw Permalink Blame History