דלגו לתוכן
גיליון 001·חי·20:20 IL
→ יומן/2026-10-27·8 דק׳

ADK ל-Kotlin: מה ה-README של גוגל אומר על Android, interop עם Java ושרת לא-מאומת

ה-Agent Development Kit של גוגל ל-Kotlin הוא toolkit ברישיון Apache 2.0 עם interop ל-Java, מודלים on-device באנדרואיד ושרת HTTP. מה ה-README אומר, איפה הוא סותר את עצמו על יציבות, ומה לבדוק קודם.

מאת Harel Asaf·בונה בינה מלאכותית·תל אביב

ל-Agent Development Kit (ADK) של גוגל יש עכשיו גרסת Kotlin, שפורסמה כקוד פתוח תחת Apache 2.0. ה-README שלה אומר שאפשר לבנות אותו סוכן מ-Kotlin או Java פשוטה, להריץ מודלים on-device באנדרואיד, ולהגיש סוכנים על HTTP. הוא גם אומר שני דברים שלא יושבים קל יחד: הפרויקט "now follows a stable release cycle" תחת semantic versioning, וסעיף סוגר אומר שהתכונה היא Pre-GA ו"available as is" עם תמיכה מוגבלת. אם אתם מתכננים לבנות עליו, התייחסו לפער הזה כדבר הראשון ליישר.

קראתי את דף המאגר וה-README בלבד. לא בניתי שום דבר, לא הרצתי את הדוגמאות, ולא קראתי את אתר התיעוד, הערות השחרור או המקור. כל מה שלמטה הוא מה שה-README אומר.

מה זה

ה-README קורא ל-ADK ל-Kotlin "an open-source, code-first Kotlin toolkit for building, evaluating, and deploying sophisticated AI agents". מגדירים התנהגות סוכן, תיאום ושימוש בכלים בקוד. הוא מקשר לגרסאות ה-Python וה-Java של ADK כאחים.

בדף המאגר ראיתי: Apache 2.0, נוצר 12 במאי 2026, כ-294 כוכבים, 43 issues פתוחים, ושפות כולל Kotlin, Java, Python, JavaScript ו-HTML. קטעי ההתקנה ב-README משתמשים בגרסה 1.4.0 של חפצי com.google.adk.

רשימת התכונות ב-README:

  • אקוסיסטם של כלים: כלים מוכנים מראש, פונקציות מותאמות אישית, מפרטי OpenAPI או כלים קיימים.
  • לוגיקת סוכן code-first שאפשר לבדוק ולנהל בגרסאות.
  • מערכות רב-סוכניות מורכבות כהיררכיות.
  • סוכנים on-device וענן באנדרואיד.
  • interop עם Java, כך שאפשר לבנות את אותם סוכנים מ-Java פשוטה.

המודולים

ה-README מפרט חפץ core (סוכנים, מודלים, כלים, סשנים, זיכרון, artifacts, runners) כתלות היחידה שרוב הפרויקטים צריכים. השאר אופציונליים:

  • processor: מעבד KSP שמייצר כלים מפונקציות מוערות @Tool.
  • webserver: הגשת HTTP, headless או עם ממשק הפיתוח.
  • integrations: Spring AI, Anthropic Claude (דרך ה-SDK הרשמי של Anthropic ל-Java), OpenAI ונקודות קצה תואמות Chat Completions, ופלאגין BigQuery שרושם אירועי הפעלת סוכן. ה-README מתייג את רובם כ-JVM בלבד.
  • a2a: תמיכת Agent2Agent לדבר עם סוכנים מרוחקים.
  • litertlm, firebase, mlkit: חלקי האנדרואיד וה-on-device.

סוכן הדוגמה ב-README משתמש ב-gemini-3.8-flash על Vertex AI עם Application Default Credentials ומשתנה GOOGLE_CLOUD_PROJECT. לא בדקתי את שם המודל ההוא מול שום דבר.

Interop עם Java

ה-README אומר שכל API בסגנון builder משקף את זה של Kotlin וש"coroutines stay out of the way". חבילת com.google.adk.kt.interop מחליפה פונקציות suspend ו-Flow ב-CompletableFuture ו-Publisher של Reactive Streams. הוא מזכיר wrappers ל-runners, שירותי session, artifact וזיכרון, מחלקות בסיס למימוש כלים, toolsets, פלאגינים ומודלים מ-Java, והערות @Tool ו-@Param שעובדות מ-Java. חלק אחד, BaseFutureLiveConnection, מתוייג כניסיוני.

אנדרואיד: שלושה backends, אחד מוגבל

ה-README נותן טבלה:

  • LiteRT-LM: on-device, עם קריאת כלים. הוא מריץ מודלים פתוחים כמו Gemma, ועל אנדרואיד וה-JVM של שולחן העבודה. הוא צריך JDK 21 ומעלה.
  • ML Kit (Gemini Nano): on-device, אנדרואיד בלבד, פורסם כ-pre-release עם סיומת -beta. ה-README אומר שקריאת כלים עוד לא נתמכת, ושחלקי functionCall ו-functionResponse נזרקים, אז זה לצ'אט ויצירה פשוטים לעת עתה.
  • Firebase AI: ענן, עם קריאת כלים. ה-README קורא לו הדרך המומלצת לקרוא ל-Gemini מאנדרואיד בלי להטמיע מפתח API.

הוא גם אומר שמודלי on-device וענן הם מימושי Model ניתנים להחלפה, כך שהיררכיית סוכנים אחת יכולה לערבב אותם: סוכן on-device לתורנויות offline או רגישות-פרטיות, מאציל משימות קשות לסוכן ענן. ה-README אומר שהוא תומך בעיצוב הזה. לא ניסיתי אותו.

פרט ששווה לשים לב: סוכן קורא-כלים על ML Kit היה מאבד בשקט את קריאות הכלים שלו, לפי הניסוח של ה-README עצמו. אם אתם מחליפים backends "in one line", בדקו אילו backends תומכים בכלים.

הגשת סוכנים על HTTP

ה-AdkApiServer של מודול ה-webserver מגיש גילוי אפליקציות, סשנים, artifacts, נקודות קצה run, health וגרסה. ה-README אומר שהוא מאזין על פורט 8080 וש-inMemory שומר מצב סשן ו-artifact בתהליך, אז זה מתאים להרצה מקומית.

הערת האבטחה היא החלק שהייתי קורא פעמיים. ה-README אומר שהשרת "binds loopback, because these endpoints are unauthenticated" ואומר לכם לשים אימות משלכם מלפניו לפני הרחבה. הדוגמה הבאה שלו מגדירה host = "0.0.0.0" בשורה אחת. הדוגמה ההיא שם כדי להראות את ההגדרה, וה-README לא מוסיף לה צעד אימות. אם תעתיקו אותה, תחשפו נקודות קצה לא-מאומתות של סשן ו-run על כל ממשק.

לממשק הפיתוח יש חוק קדימות

AdkDevServer מוסיף ממשק פיתוח ב-/dev-ui בתוספת נקודות קצה trace וגרף-סוכן. ה-README אומר ששלושה דברים מחליטים אם הממשק ממופה, מהגבוה ביותר:

1. תכונת המערכת adk.web.ui.enabled.

2. שדה ה-webUiEnabled על AdkServerConfig.

3. מחלקת השרת: AdkApiServer משאיר אותו כבוי, AdkDevServer מדליק אותו.

אז -Dadk.web.ui.enabled=true תועה בסביבת ההשקה מדליק את הממשק גם אם הקונפיג שלכם אומר כבוי. ה-README אומר שזה בכוונה, כדי ש-deployment שלא יכול לשנות קוד עדיין יכול לכבות אותו. לסקריפט השקה של ייצור, בדקו את תכונות המערכת שאתם מעבירים.

פער היציבות

שתי קביעות באותו README:

  • "ADK for Kotlin now follows a stable release cycle, with regular releases published to Maven Central under semantic versioning."
  • סעיף "Preview" סוגר: התכונה "is subject to the 'Pre-GA Offerings Terms'", ותכונות Pre-GA זמינות "as is" ו"might have limited support".

ה-README לא אומר אילו חלקים הקביעה השנייה מכסה. זה יכול להיות boilerplate שחל על הכל, או רק על מודולים מסוימים כמו זה של ML Kit בבטא. לא הצלחתי לדעת. אם אתם צריכים תנאי תמיכה, קראו את התנאים המקושרים ושאלו את גוגל.

מה הייתי בודק

אלה הצעות שלא בדקתי, לא תוצאות.

1. סטטוס תמיכה. קראו את תנאי ה-Pre-GA שה-README מקשר אליהם, והחליטו אם "as is" מקובל לשימוש שלכם.

2. אימות מלפני השרת. לפני שאתם מגדירים host = "0.0.0.0", שימו אימות אמיתי וחוק רשת מלפניו.

3. תכונות מערכת. בכל deployment, פרטו את דגלי ה-JVM ואשרו שממשק הפיתוח כבוי.

4. תמיכת כלים ב-backend. הריצו סוכן קורא-כלים אחד על כל backend אנדרואיד, ואשרו שקריאות כלים מגיעות.

5. גרסת JDK. מודול ה-LiteRT-LM צריך JDK 21 ומעלה. בדקו את זה מול ה-build שלכם.

6. לנעול את הגרסה. ה-README מראה 1.4.0. נעלו אותה וקראו את הערות השחרור כשאתם זזים.

מה לא הייתי מסיק

  • שהוא מוכן לייצור. ה-README אומר גם "stable release cycle" וגם "Pre-GA, as is".
  • שסוכני on-device עובדים עם כלים על כל backend. ML Kit עוד לא, לפי ה-README.
  • שהשרת בטוח לחשיפה. ה-README אומר שהוא לא-מאומת.
  • שהדוגמאות רצות ככתובן. לא הרצתי אותן.

שאלות נפוצות

מהו ADK ל-Kotlin?

Toolkit בקוד פתוח ל-Kotlin מגוגל לבנייה, הערכה ופריסה של סוכני AI, תחת Apache 2.0. הוא בא אחרי ה-ADKs של Python ו-Java.

האם אפשר להשתמש בו מ-Java?

ה-README אומר כן. הוא מתאר ממשקי builder פונים-Java וחבילת interop מבוססת CompletableFuture ו-Publisher של Reactive Streams.

האם הוא מריץ מודלים על המכשיר?

באנדרואיד, כן, דרך LiteRT-LM או ML Kit. לפי ה-README, LiteRT-LM תומך בקריאת כלים ו-ML Kit עוד לא.

באילו מודלים הוא יכול להשתמש?

ה-README מראה Gemini על Vertex AI, ומפרט אינטגרציות למודלי Spring AI, Anthropic Claude, ו-OpenAI או נקודות קצה תואמות. לא בדקתי אף אחד מהם.

האם שרת ה-HTTP מאובטח?

ה-README אומר שנקודות הקצה לא-מאומתות ושהשרת מבצע bind ל-loopback כברירת מחדל. שימו אימות מלפניו לפני הרחבה.

האם הוא יציב?

ה-README אומר שהוא עוקב אחרי מחזור שחרור יציב עם semantic versioning, וגם נושא הודעת Pre-GA, "as is". הוא לא מיישר בין השניים.

איך מתקינים אותו?

מוסיפים את חפץ ה-core של com.google.adk, גרסה 1.4.0 ב-README, דרך Maven או Gradle. ה-README נותן קטעים לשניהם.

מקורות

כל העמודים נקראו ב-27 באוקטובר 2026.

  • google/adk-kotlin repository and README: תיאור, מודולים, backends של אנדרואיד, interop עם Java, התנהגות שרת וממשק פיתוח, תנאי preview, סטטיסטיקות מאגר.

לא נקראו: אתר התיעוד של Kotlin ADK, הערות שחרור, קוד מקור, ותנאי ה-Pre-GA המקושרים.

קריאה נוספת

יומן הבנייה

לעקוב אחרי העבודה.

מאמרים ואבטיפוסים חדשים, ישר לקורא ה-RSS שלכם. מנויי המייל בהשהיה זמנית, עד שאחבר שירות משלוח עובד. לא נאסף כאן אימייל.

עקבו ב-RSS