- ADK — це фреймворк з відкритим кодом, який дозволяє інтегрувати складні агенти штучного інтелекту як у хмарі, так і локально на пристроях Android.
- Він підтримує багатоагентну архітектуру через ієрархії, послідовні потоки, цикли уточнення та паралельне виконання.
- Це дозволяє використовувати на пристроях моделі, такі як Gemini Nano, через ML Kit, щоб забезпечити конфіденційність та зменшити затримку без залежності від Інтернету.
- Він пропонує безперешкодну інтеграцію з Kotlin та Java, що спрощує створення власних інструментів та ефективне управління контекстом.
Якщо ви займаєтесь розробкою мобільних додатків, ви, мабуть, вже помітили, що штучний інтелект перетворився з простого інструменту для спілкування на рушій сучасних додатків. Саме тут на допомогу приходить Agent Development Kit (ADK) – бібліотека, спеціально розроблена для того, щоб розробники Android могли інтегрувати справді потужних агентів штучного інтелекту у свої додатки, не втрачаючи при цьому глузду.
Найкрутіше в ADK те, що він не прив'язує вас до одного способу роботи. Ви можете створювати агентів, які повністю працюють на пристрої , використовувати хмарні сервіси або навіть поєднувати обидва світи в гібридній системі. По суті, це фреймворк з відкритим кодом, який підтримує Kotlin та Java , що дозволяє нам перейти від простого прототипу до надскладних багатоагентних застосунків без необхідності писати тисячі рядків повторюваного коду.
Основні поняття для початку

Перш ніж заглиблюватися в код, необхідно чітко зрозуміти п'ять ключових стовпів. По-перше, є Агент – сутність, яка керує завданням. Потім є Модель (як Gemini) – мозок, який обробляє інформацію. Щоб агент міг виконувати реальні дії, ми використовуємо Інструменти – специфічні функції, які може виконувати ШІ. Також є Субагенти , необхідні для створення систем, де кілька агентів розподіляють робоче навантаження, і, нарешті, Виконавець та Сесія , які відповідають за виконання логіки та збереження пам'яті розмови.
Технічна конфігурація в Android Studio
Щоб розпочати, вам знадобиться Android Studio та SDK з compileSdk 34 або вищеМагія починається в архіві build.gradle.ktsкуди потрібно додати залежність google-adk-kotlin-core-android та процесор анотацій КСПВкрай важливо не змішувати версію для Android з версією для JVM, щоб уникнути конфліктів залежностей. Крім того, рекомендується використовувати jvmToolchain(17) щоб забезпечити сумісність проекту.
Визначення агентів та інструментів
Створення агента досить інтуїтивно зрозуміле. Використання анотацій, таких як @Tool y @ParamВи можете перетворити будь-яку функцію Kotlin на можливість, яку може використовувати ШІ. Наприклад, ви можете створити сервіс, який запитує час у місті та передає його агенту за допомогою generatedTools()При визначенні LlmAgent, ви вказуєте модель (наприклад gemini-flash-latest), поведінкові інструкції та доступні інструменти.
Критично важливим моментом тут є безпека: ніколи не вбудовуйте ключі API безпосередньо в код вашого додатка. Найрозумніший підхід — використовувати власний бекенд або логіку Firebase AI, щоб гарантувати, що ключі не будуть розкриті під час публікації вашого додатка в магазині.
Виконання та розгортання в додатку

Щоб запустити агента на Android, ви використовуєте InMemoryRunner разом із a InMemorySessionServiceОскільки ШІ працює асинхронно, все це керується через Корутини Kotlinзбираючи відповіді в потоці, який потім оновлює інтерфейс користувача. Якщо ви хочете вийти за рамки звичайного тексту, ADK пропонує протокол A2UI (агент-інтерфейс користувача), що дозволяє агенту повертати інтерактивні компоненти Реактивний ранець Compose and Material 3, наприклад, картки чи бланки.
Локальна потужність з Gemini Nano та ML Kit
Однією з його перлин є можливість запуску моделей на пристрої . Використовуючи GenaiPrompt та API ML Kit, ви можете інтегрувати Gemini Nano . Це означає, що ваш додаток може працювати офлайн , що не тільки зменшує затримку до неймовірних рівнів, але й гарантує, що конфіденційні дані ніколи не залишать телефон користувача.
Найцікавіше те, що ви можете поєднати це з хмарою. Наприклад, ви можете мати хмарний оркестратор , який керує загальною логікою та делегує приватні або прості завдання субагентам, що працюють локально на пристрої.
Багатоагентні системи та робочі процеси

Коли завдання занадто складне для одного запиту, ADK дозволяє створювати ієрархії агентів. root_agent Він діє як керівник, який вирішує, якому субагенту передати м'яч, на основі опису кожного з них або явних інструкцій. Для управління інформацією між ними використовується наступне: стан сеансущо дозволяє одному агенту зберігати дані, а іншому отримувати їх за допомогою ключових шаблонів, таких як {mi_variable?}.
Існує три типи автоматизованих агентів потоку, які є дивовижними:
- Послідовний агент: Виконує список агентів одного за одним. Ідеально підходить для конвеєрів, де крок B залежить від кроку A.
- Агент петлі: Створіть цикл уточнення. Один агент пише, інший критикує, і якщо результат незадовільний, цикл повторюється, доки не буде викликано нового агента.
exit_loopабо досягнуто ліміту ітерацій. - Паралельний агент: Він виконує кілька завдань одночасно (розподіл). Наприклад, поки один агент досліджує кастинг фільму, інший одночасно аналізує його касовий потенціал.
Сумісність з Java та професійне розгортання
Хоча Kotlin і є королем, ADK є... повністю сумісний з JavaВін надає інтерфейси на основі CompletableFuture y Publisher щоб уникнути необхідності розробників Java боротися з корутинами. Щодо розгортання, ADK є гнучким: ви можете використовувати контейнери на власній інфраструктурі або скористатися перевагами розгортання однією командою для Google Cloud (Cloud Run або GKE), успадковуючи таким чином безпеку та спостережуваність корпоративного рівня через Cloud Trace.
Для тих, хто віддає перевагу тестуванню перед програмуванням, існує ADK Dev Server , який налаштовує локальний веб-інтерфейс (у стилі Python) для тестування, налагодження та візуалізації графіка виконання агентів у режимі реального часу, що значно полегшує виявлення помилок у складних потоках.
Здатність ADK інтелектуально керувати контекстом, фільтруючи нерелевантні події та підсумовуючи старі черги, запобігає перевантаженню вікна токенів. Поєднуючи локальні моделі, розширену оркестрацію та нативні інструменти Android , розробники можуть створювати швидкі, конфіденційні та надзвичайно потужні інтерфейси штучного інтелекту, що трансформує нашу взаємодію з мобільними додатками.