diff --git a/sources/platform/integrations/ai/google-adk.md b/sources/platform/integrations/ai/google-adk.md new file mode 100644 index 000000000..a4f144c25 --- /dev/null +++ b/sources/platform/integrations/ai/google-adk.md @@ -0,0 +1,102 @@ +--- +title: 🇬 Google ADK integration +sidebar_label: Google ADK +description: Learn how to integrate Apify Actors as tools for AI with 🇬 Google ADK. +sidebar_position: 2 +slug: /integrations/google-adk +--- + +**Learn how to integrate Apify Actors as tools for AI with Google ADK.** + +--- + +## What is Google ADK + +[Google Agent Development Kit (ADK)](https://github.com/google/adk-python) is a flexible and modular framework for developing and deploying AI agents. + +:::note Explore Google ADK + +For more in-depth details, check out [Google ADK documentation](https://google.github.io/adk-docs/). + +::: + +## How to use Apify with Google ADK + +Apify is a marketplace of ready-to-use web scraping and automation tools, AI agents, and MCP servers that you can equip your own AI with. This guide demonstrates how to use Apify tools with a simple AI agent built with Google ADK. + + +### Prerequisites + +- _Apify API token_: To use Apify Actors in Google ADK, you need an Apify API token. To obtain your token check [Apify documentation](https://docs.apify.com/platform/integrations/api). +- _Python packages_: Install the following Python packages: + + ```bash + pip install google-adk + ``` + +### Building a simple pub search AI agent using Apify Google Maps scraper + +First, create an agent project: + +```bash +adk create pub_search_agent +``` + +Create and configure the agent to use the Apify MCP server tools: + +:::warning Required setup + +Make sure to set the `APIFY_TOKEN` environment variable in the `.env` file with your Apify API token before running the code. + +::: + +```python +from google.adk.agents import Agent +from google.adk.tools.mcp_tool import McpToolset +from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams +import os + +root_agent = Agent( + model="gemini-2.5-flash", + name="pub_search_agent", + instruction="You are a pub search agent that helps users find a great pub to visit based on their preferences. Use Apify tools to accomplish this.", + tools=[ + McpToolset( + connection_params=StreamableHTTPServerParams( + # Configure Apify MCP Server URL with desired tools + url="https://mcp.apify.com?tools=compass/crawler-google-places", + headers={ + "Authorization": f"Bearer {os.getenv('APIFY_TOKEN')}", + }, + ), + ) + ], +) +``` + +Run the agent via the web interface: + +```bash +adk web +``` + +Or run the agent via command-line interface: + +```bash +adk run pub_search_agent +``` + +Prompt the agent to find a pub in San Francisco: + +```text +Find a pub near the Ferry Building in San Francisco. +``` + +## Resources + +- [Apify Actors](https://docs.apify.com/platform/actors) +- [Google ADK documentation](https://google.github.io/adk-docs/get-started/) +- [What are AI agents?](https://blog.apify.com/what-are-ai-agents/) +- [Apify MCP Server](https://mcp.apify.com) +- [Apify MCP Server documentation](https://docs.apify.com/platform/integrations/mcp) +- [Apify OpenRouter proxy](https://apify.com/apify/openrouter)