Где взять

google/adk-js — открыть на GitHub

Открытая лицензия: Apache-2.0 · 1477 stars.

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

Что можно собрать

ADK позволяет создавать как простые задачи, так и сложные многоагентные системы. Основная идея заключается в «code-first» подходе: вы описываете логику агента, инструменты и сценарии оркестрации (последовательные, параллельные или циклические) прямо в TypeScript-файлах. Это обеспечивает строгую типизацию и позволяет использовать валидацию схем Zod для параметров инструментов.

Как начать

Для работы потребуется Node.js версии 20.19 или новее. Установка выполняется через npm или yarn:

npm install @google/adk
npm install -D @google/adk-devtools

После установки необходимо настроить аутентификацию. Вы можете использовать API-ключ Google AI Studio, добавив его в файл .env, либо настроить работу через Vertex AI, используя стандартные инструменты Google Cloud. Определение агента происходит в файле agent.ts, где вы задаете модель (например, gemini-flash-latest), инструкции и доступные инструменты, такие как Google Search или Google Maps.

Рабочий сценарий

Инструментарий включает CLI (интерфейс командной строки) и интерактивный веб-интерфейс для отладки. Команда npx @google/adk-devtools run agent.ts запускает агента локально, а npx @google/adk-devtools web открывает UI, где можно наблюдать за вызовами функций и тестировать поведение агента в реальном времени.

Кому это подходит

Инструмент ориентирован на разработчиков, работающих в экосистемах Node.js и браузеров, которым важен контроль над версионированием и отладкой AI-логики. ADK поддерживает работу с ESM, CommonJS и веб-рантаймами, что делает его гибким решением для различных сред исполнения.

Границы применимости

На текущий момент ADK требует Node.js 20.19+. Важно помнить, что при использовании CLI необходимо всегда указывать полное имя пакета, так как в противном случае возможна загрузка стороннего пакета с похожим названием из публичного реестра. Документация охватывает базовые сценарии, включая работу с инструментами и выполнение кода, однако специфические ограничения производительности или интеграции с закрытыми корпоративными системами в открытых данных не описаны.

Вердикт

Стоит попробовать, если вам нужно строго типизированное решение на TypeScript для управления AI-агентами с возможностью локальной отладки через UI.

Лучше выбрать другой путь, если ваш проект требует работы на более старых версиях Node.js или если вы ищете готовое облачное решение «под ключ» без необходимости написания кода для оркестрации агентов.

Похожие материалы