Skip to content

Commit 1e12ebe

Browse files
authored
Merge pull request #176 from UiPath/fix/google_adk_readme_samples
fix: add readme for google adk samples
2 parents caf1b40 + 52fa10c commit 1e12ebe

10 files changed

Lines changed: 154 additions & 9 deletions

File tree

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# UiPath Google ADK Samples
2+
3+
Sample agents built with [Google ADK](https://google.github.io/adk-docs/) and [UiPath LLM providers](../src/uipath_google_adk/chat/).
4+
5+
| Sample | Description |
6+
|--------|-------------|
7+
| [quickstart-agent](./quickstart-agent/) | Single agent with tool calling: fetches live weather data for any location |
8+
| [typed-agent](./typed-agent/) | Sequential agent with typed input/output: researches topics via Wikipedia and returns structured JSON |
9+
| [multi-agent](./multi-agent/) | Multi-agent pipeline: coordinates research, code generation, and report formatting with multiple sub-agents |
Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
# Multi-Agent
2+
3+
A three-stage sequential agent that coordinates research (Wikipedia + Tavily), code generation, and structured report formatting.
4+
5+
## Agent Graph
6+
7+
```mermaid
8+
flowchart TB
9+
__start__(__start__)
10+
pipeline(pipeline)
11+
coordinator(coordinator)
12+
research_agent(research_agent)
13+
research_agent_tools(tools)
14+
code_agent(code_agent)
15+
code_agent_tools(tools)
16+
formatter(formatter)
17+
__end__(__end__)
18+
research_agent --> research_agent_tools
19+
research_agent_tools --> research_agent
20+
coordinator --> research_agent
21+
research_agent --> coordinator
22+
code_agent --> code_agent_tools
23+
code_agent_tools --> code_agent
24+
coordinator --> code_agent
25+
code_agent --> coordinator
26+
pipeline --> coordinator
27+
coordinator --> pipeline
28+
pipeline --> formatter
29+
formatter --> pipeline
30+
__start__ --> |input|pipeline
31+
pipeline --> |output|__end__
32+
```
33+
34+
## Run
35+
36+
```
37+
uipath run agent '{"topic": "machine learning", "depth": "detailed"}'
38+
```
39+
40+
## Debug
41+
42+
```
43+
uipath dev web
44+
```

packages/uipath-google-adk/samples/multi-agent/agent.mermaid

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,15 @@ flowchart TB
55
research_agent(research_agent)
66
research_agent_tools(tools)
77
code_agent(code_agent)
8+
code_agent_tools(tools)
89
formatter(formatter)
910
__end__(__end__)
1011
research_agent --> research_agent_tools
1112
research_agent_tools --> research_agent
1213
coordinator --> research_agent
1314
research_agent --> coordinator
15+
code_agent --> code_agent_tools
16+
code_agent_tools --> code_agent
1417
coordinator --> code_agent
1518
code_agent --> coordinator
1619
pipeline --> coordinator

packages/uipath-google-adk/samples/multi-agent/pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@ description = "Google ADK multi-agent example with sub-agents and tools"
55
readme = "README.md"
66
requires-python = ">=3.11"
77
dependencies = [
8+
"uipath",
89
"uipath-google-adk",
910
"google-adk>=1.25.0",
10-
"uipath>=2.8.18, <2.9.0",
1111
]
1212

1313
[dependency-groups]
Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# Quickstart Agent
2+
3+
A simple weather assistant that fetches current weather data for any location using the Open-Meteo API. Uses LLMs through the UiPath LLM Gateway.
4+
5+
## Agent Graph
6+
7+
```mermaid
8+
flowchart TB
9+
__start__(__start__)
10+
weather_agent(weather_agent)
11+
weather_agent_tools(tools)
12+
__end__(__end__)
13+
weather_agent --> weather_agent_tools
14+
weather_agent_tools --> weather_agent
15+
__start__ --> |input|weather_agent
16+
weather_agent --> |output|__end__
17+
```
18+
19+
## Run
20+
21+
```
22+
uipath run agent "What's the weather in San Francisco?"
23+
```
24+
25+
## Debug
26+
27+
```
28+
uipath dev web
29+
```

packages/uipath-google-adk/samples/quickstart-agent/pyproject.toml

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@ description = "Quickstart Google ADK agent example"
55
readme = "README.md"
66
requires-python = ">=3.11"
77
dependencies = [
8-
"uipath-google-adk[anthropic]>=0.0.1, <0.1.0",
8+
"uipath",
9+
"uipath-google-adk[anthropic]",
910
"google-adk>=1.25.0",
10-
"uipath>=2.8.18, <2.9.0",
1111
]
1212

1313
[dependency-groups]
@@ -17,7 +17,3 @@ dev = [
1717

1818
[tool.uv]
1919
override-dependencies = ["opentelemetry-sdk>=1.39.0,<1.40.0"]
20-
21-
[tool.uv.sources]
22-
uipath-dev = { path = "../../../../../uipath-dev-python", editable = true }
23-
uipath-google-adk = { path = "../../", editable = true }
Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Typed Agent
2+
3+
A two-stage sequential agent that researches a topic via Wikipedia and produces structured JSON output using the formatter pattern.
4+
5+
## Agent Graph
6+
7+
```mermaid
8+
flowchart TB
9+
__start__(__start__)
10+
pipeline(pipeline)
11+
researcher(researcher)
12+
researcher_tools(tools)
13+
formatter(formatter)
14+
__end__(__end__)
15+
researcher --> researcher_tools
16+
researcher_tools --> researcher
17+
pipeline --> researcher
18+
researcher --> pipeline
19+
pipeline --> formatter
20+
formatter --> pipeline
21+
__start__ --> |input|pipeline
22+
pipeline --> |output|__end__
23+
```
24+
25+
## Run
26+
27+
```
28+
uipath run agent '{"topic": "artificial intelligence", "max_sources": 3, "language": "en"}'
29+
```
30+
31+
## Debug
32+
33+
```
34+
uipath dev web
35+
```
Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
flowchart TB
2+
__start__(__start__)
3+
pipeline(pipeline)
4+
researcher(researcher)
5+
researcher_tools(tools)
6+
formatter(formatter)
7+
__end__(__end__)
8+
researcher --> researcher_tools
9+
researcher_tools --> researcher
10+
pipeline --> researcher
11+
researcher --> pipeline
12+
pipeline --> formatter
13+
formatter --> pipeline
14+
__start__ --> |input|pipeline
15+
pipeline --> |output|__end__

packages/uipath-google-adk/samples/typed-agent/pyproject.toml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@ description = "Google ADK agent with strongly-typed input/output schemas"
55
readme = "README.md"
66
requires-python = ">=3.11"
77
dependencies = [
8-
"uipath-google-adk>=0.0.1, <0.1.0",
8+
"uipath",
9+
"uipath-google-adk",
910
"google-adk>=1.25.0",
10-
"uipath>=2.8.18, <2.9.0",
1111
]
1212

1313
[dependency-groups]
Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
{
2+
"$schema": "https://cloud.uipath.com/draft/2024-12/uipath",
3+
"runtimeOptions": {
4+
"isConversational": false
5+
},
6+
"packOptions": {
7+
"fileExtensionsIncluded": [],
8+
"filesIncluded": [],
9+
"filesExcluded": [],
10+
"directoriesExcluded": [],
11+
"includeUvLock": true
12+
},
13+
"functions": {}
14+
}

0 commit comments

Comments
 (0)