Skip to content

Commit 27460d2

Browse files
committed
docs: Update to model versions and Makefile targets
1 parent 44cd530 commit 27460d2

File tree

3 files changed

+31
-10
lines changed

3 files changed

+31
-10
lines changed

README.md

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,10 @@ Run an Agent framework script e.g.:
3838
- `uv run agents_mcp_usage/basic_mcp/basic_mcp_use/oai-agent_mcp.py`
3939
- Requires `OPENAI_API_KEY` by default
4040

41-
Check console or Logfire for output
41+
- Launch the ADK web UI for visual interaction with the agents:
42+
- `make adk_basic_ui`
43+
44+
Check console, Logfire, or the ADK web UI for output
4245

4346
## Project Overview
4447

@@ -55,7 +58,7 @@ This project aims to teach:
5558

5659
- **[agents_mcp_usage/basic_mcp/](agents_mcp_usage/basic_mcp/)** - Single MCP server integration examples
5760
- **basic_mcp_use/** - Contains basic examples of single MCP usage:
58-
- `adk_mcp.py` - Example of using MCP with Google's Agent Development Kit (ADK)
61+
- `adk_mcp.py` - Example of using MCP with Google's Agent Development Kit (ADK 1.3.0)
5962
- `langgraph_mcp.py` - Example of using MCP with LangGraph
6063
- `oai-agent_mcp.py` - Example of using MCP with OpenAI Agents
6164
- `pydantic_mcp.py` - Example of using MCP with Pydantic-AI
@@ -154,6 +157,9 @@ uv run agents_mcp_usage/basic_mcp/basic_mcp_use/oai-agent_mcp.py
154157

155158
# Pydantic-AI example
156159
uv run agents_mcp_usage/basic_mcp/basic_mcp_use/pydantic_mcp.py
160+
161+
# Launch ADK web UI for visual interaction
162+
make adk_basic_ui
157163
```
158164

159165
More details on basic MCP implementation can be found in the [basic_mcp README](agents_mcp_usage/basic_mcp/README.md).
@@ -218,7 +224,7 @@ uv run agents_mcp_usage/multi_mcp/multi_mcp_use/pydantic_mcp.py
218224
uv run agents_mcp_usage/multi_mcp/eval_multi_mcp/evals_pydantic_mcp.py
219225

220226
# Run multi-model benchmarking
221-
uv run agents_mcp_usage/multi_mcp/eval_multi_mcp/run_multi_evals.py --models "gemini-2.5-pro,gemini-2.0-flash" --runs 5 --parallel
227+
uv run agents_mcp_usage/multi_mcp/eval_multi_mcp/run_multi_evals.py --models "gemini-2.5-pro-preview-06-05,gemini-2.0-flash" --runs 5 --parallel
222228

223229
# Launch the evaluation dashboard
224230
uv run streamlit run agents_mcp_usage/multi_mcp/eval_multi_mcp/merbench_ui.py
@@ -258,7 +264,7 @@ uv run agents_mcp_usage/multi_mcp/eval_multi_mcp/evals_pydantic_mcp.py
258264

259265
# Multi-model parallel benchmarking
260266
uv run agents_mcp_usage/multi_mcp/eval_multi_mcp/run_multi_evals.py \
261-
--models "gemini-2.5-pro,gemini-2.0-flash,gemini-2.5-flash-preview-04-17" \
267+
--models "gemini-2.5-pro-preview-06-05,gemini-2.0-flash,gemini-2.5-flash" \
262268
--runs 5 \
263269
--parallel \
264270
--output-dir ./results
@@ -288,6 +294,11 @@ A key advantage highlighted is flexibility; MCP allows developers to more easily
288294
```bash
289295
make install
290296
```
297+
298+
To use the ADK web UI, run:
299+
```bash
300+
make adk_basic_ui
301+
```
291302
3. Set up your environment variables in a `.env` file:
292303
```
293304
LOGFIRE_TOKEN=your_logfire_token

agents_mcp_usage/basic_mcp/README.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,9 @@ Each script demonstrates how to connect to a single local MCP server and use it
2121

2222
# Run the Google ADK example
2323
uv run agents_mcp_usage/basic_mcp/basic_mcp_use/adk_mcp.py
24+
25+
## Launch ADK web UI for visual interaction
26+
make adk_basic_ui
2427
```
2528

2629
4. Check the console output or Logfire for results.
@@ -155,18 +158,25 @@ The sequence diagram illustrates the temporal flow of interactions between the u
155158

156159
**File:** `adk_mcp.py`
157160

158-
This example demonstrates how to use MCP with Google's Agent Development Kit (ADK).
161+
This example demonstrates how to use MCP with Google's Agent Development Kit (ADK 1.3.0).
159162

160163
```bash
161164
uv run agents_mcp_usage/basic_mcp/basic_mcp_use/adk_mcp.py
162165
```
163166

164167
Key features:
165-
- Uses `MCPToolset` for connecting to the MCP server
168+
- Uses `MCPToolset` with `StdioConnectionParams` for MCP server connection
166169
- Configures a Gemini model using ADK's `LlmAgent`
167170
- Sets up session handling and runner for agent execution
171+
- Implements proper resource management for MCP connections
172+
- Supports ADK web UI through module exports
168173
- Includes Logfire instrumentation for tracing
169174

175+
To run with the ADK web UI:
176+
```bash
177+
make adk_basic_ui
178+
```
179+
170180
### LangGraph
171181

172182
**File:** `langgraph_mcp.py`

agents_mcp_usage/multi_mcp/eval_multi_mcp/README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -167,7 +167,7 @@ Results are exported to CSV files with the following columns:
167167
uv run agents_mcp_usage/multi_mcp/eval_multi_mcp/evals_pydantic_mcp.py
168168

169169
# Customize model and judge
170-
AGENT_MODEL="gemini-2.5-pro" JUDGE_MODEL="gemini-2.0-flash" \
170+
AGENT_MODEL="gemini-2.5-pro-preview-06-05" JUDGE_MODEL="gemini-2.0-flash" \
171171
uv run agents_mcp_usage/multi_mcp/eval_multi_mcp/evals_pydantic_mcp.py
172172
```
173173

@@ -176,18 +176,18 @@ uv run agents_mcp_usage/multi_mcp/eval_multi_mcp/evals_pydantic_mcp.py
176176
```bash
177177
# Run evaluation across multiple models
178178
uv run agents_mcp_usage/multi_mcp/eval_multi_mcp/run_multi_evals.py \
179-
--models "gemini-2.5-pro,gemini-2.0-flash" \
179+
--models "gemini-2.5-pro-preview-06-05,gemini-2.0-flash" \
180180
--runs 5 \
181181
--parallel \
182182
--timeout 600 \
183183
--output-dir ./results
184184

185185
# Sequential execution with custom judge
186186
uv run agents_mcp_usage/multi_mcp/eval_multi_mcp/run_multi_evals.py \
187-
--models "gemini-2.5-pro,claude-3-opus" \
187+
--models "gemini-2.5-pro-preview-06-05,claude-3-opus" \
188188
--runs 3 \
189189
--sequential \
190-
--judge-model "gemini-2.5-pro" \
190+
--judge-model "gemini-2.5-pro-preview-06-05" \
191191
--output-dir ./eval_results
192192
```
193193

0 commit comments

Comments
 (0)