ADK: инструмент на Python для создания ИИ-агентов

Agent Development Kit (ADK) — это открытый фреймворк на Python, предназначенный для создания, оценки и развертывания искусственных интеллект-агентов. Он предлагает модульный и гибкий подход к разработке агентов, позволяя строить от простых задач до сложных систем. Основная цель ADK — упростить процесс создания и координации рабочих процессов агентов, при этом поддерживая совместимость с различными моделями и фреймворками.

Ключевые возможности

• Рабочий процесс исполнения: графовая система для создания детерминированных потоков выполнения, поддерживающая управление состоянием, динамические узлы и человеческое участие в процессе.
• API задач: структурированная делегация задач между агентами с поддержкой взаимодействия на несколько раундов.
• Модульные многопроцессорные системы: возможность комбинировать несколько специализированных агентов в гибкие и масштабируемые иерархии.
• Экосистема инструментов: использование предустановленных инструментов и возможность интеграции с существующими решениями для улучшения функциональности агентов.
• Разработка через код: написание логики агентов и оркестрации непосредственно на Python для максимальной гибкости.
• Безкодовая конфигурация агентов: возможность создания агентов без написания кода через специальный интерфейс.

Установка

Рекомендуется установить последнюю стабильную версию ADK с помощью следующей команды:

pip install google-adk

Необходимая версия Python — 3.10 и выше. Также рекомендую использовать файлы зависимостей для защиты от конфликтов:

curl -o constraints-3.10.txt https://raw.githubusercontent.com/google/adk-python/main/constraints-3.10.txt
pip install google-adk -c constraints-3.10.txt
rm constraints-3.10.txt

Для установки дополнительных интеграций можно воспользоваться такой командой:

pip install "google-adk[extensions]"

Быстрый старт

Приложения ADK строятся на основе двух основных классов: Agent (определяет поведение и инструкции ИИ) и Workflow (организует работу агентов). Вот пример создания агента:

from google.adk import Agent

root_agent = Agent(
    name="greeting_agent",
    model="gemini-2.5-flash",
    instruction="You are a helpful assistant. Greet the user warmly.",
)

Для запуска агента локально можно использовать команду:

adk run path/to/my_agent

Либо запустить веб-интерфейс:

adk web path/to/agents_dir

Ограничения

В новой версии ADK 2.0 произошли изменения, которые несовместимы с предыдущими версиями 1.x. Сессии, созданные в ADK 2.0, могут быть прочитаны только в версиях 1.28+, но не поддерживаются старыми версиями 1.x. Также используется графовая модель для управления рабочими процессами, что требует определенного понимания ее структуры при разработке.

Для получения дополнительной информации, руководств и примеров, ты можешь обратиться к документации проекта на сайте: Документация ADK.