This repository provides a collection of pre-built, functional agent samples utilizing the Agent Development Kit (ADK). It's designed for developers and researchers looking to accelerate the creation of AI agents for various use cases, from simple chatbots to complex multi-agent workflows, by offering customizable starting points.

How It Works

The sample agents are functional starting points, each pre-packaged with core logic relevant to specific applications. They demonstrate different agent functionalities, tool integrations, evaluation methods, and human-in-the-loop processes. While functional, they are intended to be customized for specific needs and integration with external systems, with each agent providing tailored instructions for modification.

Quick Start & Requirements

• Install: Clone the repository: git clone https://github.com/google/adk-samples.git
• Prerequisites: Agent Development Kit (ADK) installed and configured. Environment variables (API keys, Google Cloud project IDs, location) must be set via .env files in each agent's directory.
• Recommended: A configured Google Cloud project leveraging services like Vertex AI and BigQuery.
• Setup: Follow ADK Installation Guide and ADK Quickstart for detailed setup. Navigate to agents/ and follow individual agent READMEs for specific dependencies (e.g., poetry install) and running instructions.

Highlighted Details

• Agents are built and tested using Google models on Vertex AI, with tutorials available for using other models.
• Demonstrates core logic for different agents using various tools, evaluation, and human-in-the-loop workflows.
• Each agent sample includes specific README.md files with detailed instructions for customization and execution.

Maintenance & Community

• Contributions are welcomed via GitHub issues for bug reports, feature requests, and code contributions.
• Community support and issue reporting are handled through GitHub issues.

Licensing & Compatibility

• Licensed under the Apache 2.0 License.
• Intended for demonstration purposes only; not an officially supported Google product and not eligible for the Google Open Source Software Vulnerability Rewards Program. Not intended for production environments.

Limitations & Caveats

This project is intended for demonstration purposes only and is not suitable for production environments. It is not an officially supported Google product.