Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/assets/adk-web-dev-ui-audio.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/adk-web-dev-ui-chat.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/adk-web-dev-ui-function-call.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/agent-interaction.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/deploy/agent-engine.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ Use `reasoning_engines.AdkApp()` to wrap your agent to make it deployable to Age
from vertexai.preview import reasoning_engines

app = reasoning_engines.AdkApp(
agent_engine=root_agent,
agent=root_agent,
enable_tracing=True,
)
```
Expand Down
46 changes: 32 additions & 14 deletions docs/get-started/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -113,32 +113,50 @@ parent_folder/ <-- navigate to this directory
.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.
There are multiple ways to interact with your agent:

![agent-interaction.png](../assets/agent-interaction.png)
=== "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.
**Step 1:** Open the URL provided (usually `http://localhost:8000` or `http://127.0.0.1:8000`) directly in your browser.

**Step 2.** In the top-left corner of the UI, you can select your agent in the dropdown. Select "my_sample_agent".

!!!note
!!!note "Troubleshooting"

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.
**Step 3.** Now you can chat with your agent using the textbox:

![adk-web-dev-ui-chat.png](../assets/adk-web-dev-ui-chat.png)

**Step 4.** You can also inspect individual function calls, responses and model responses by clicking on the actions:

![adk-web-dev-ui-function-call.png](../assets/adk-web-dev-ui-function-call.png)

**Step 5.** You can also enable your microphone and talk to your agent:

![adk-web-dev-ui-audio.png](../assets/adk-web-dev-ui-audio.png)

!!!note "Model support"

Currently only `gemini-2.0-flash-exp` supports talking to your agent via audio/video. For more information, see the [documentation on the Live API on Vertex AI](https://cloud.google.com/vertex-ai/generative-ai/docs/multimodal-live-api)


=== "adk run"

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

```
adk run multi_tool_agent
```

To exit, use Cmd/Ctrl+C.

### 📝 Example prompts to try

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@

root_agent = Agent(
# A unique name for the agent.
name="basic_search_agent",
name="google_search_agent",
# The Large Language Model (LLM) that agent will use.
model="gemini-2.0-flash-exp",
# A short description of the agent's purpose.
Expand Down