نظرة عامة على Google ADK

حزمة تطوير الوكلاء من Google، مع SDKs لـ Python وTypeScript وGo وJava وKotlin، وتقييمات مدمجة في المكوّن الأساسي. تعطي الأولوية لـ Gemini، لكنها تدعم نماذج أخرى عبر المحوّلات، ويمكن نشرها على Agent Runtime في Google Cloud.

الأنسب لـ: الفرق التي تعمل بلغات متعددة وتحتاج إلى وكلاء يركزون على Gemini، وتقييمات مدمجة، ومسار مباشر إلى Google Cloud.

معلومات أساسية

الجهة المسؤولة عن الصيانة

Google

اللغات

Python, TypeScript, Go, Java, Kotlin

الترخيص

Apache-2.0

أحدث إصدار

Python 2.10.0 · 25 سبتمبر 2026

المستودع

google/adk-python · 21,687 نجمة

خيار الاستضافة

Agent Runtime on Gemini Enterprise Agent Platform (formerly Vertex AI Agent Engine); also Cloud Run, GKE

كان Agent Runtime يُعرف سابقًا باسم Vertex AI Agent Engine؛ وما زال استدعاء النشر هو client.agent_engines.create(...).

البدء السريع

ثبّت الحزمة، واضبط بيانات الاعتماد، ثم شغّل أبسط وكيل وفقًا للوثائق الرسمية. معرّفات النماذج هي المعتمدة في الوثائق، وقد لا تكون مفعّلة في حسابك.

Python

pip install google-adk && adk create my_agent  (run with: adk run my_agent  or  adk web --port 8000)

يتطلب GOOGLE_API_KEY in my_agent/.env

from google.adk.agents.llm_agent import Agent

# Mock tool implementation
def get_current_time(city: str) -> dict:
    """Returns the current time in a specified city."""
    return {"status": "success", "city": city, "time": "10:30 AM"}

root_agent = Agent(
    model='gemini-flash-latest',
    name='root_agent',
    description="Tells the current time in a specified city.",
    instruction="You are a helpful assistant that tells the current time in cities. Use the 'get_current_time' tool for this purpose.",
    tools=[get_current_time],
)

مصدر البدء السريع

TypeScript

npm install @google/adk (inferred from package name; not copied from docs)

يتطلب GOOGLE_API_KEY

import { LlmAgent, GOOGLE_SEARCH } from '@google/adk';

const agent = new LlmAgent({
  name: 'researcher',
  model: 'gemini-flash-latest',
  instruction: 'You help users research topics thoroughly.',
  tools: [GOOGLE_SEARCH],
});

مصدر البدء السريع

الميزات

التغييرات الأخيرة

• أضاف ADK 2.0 سير عمل قائمًا على الرسوم البيانية.
• انضم Kotlin SDK إلى Python وTypeScript وGo وJava.
• انتقلت الوثائق إلى adk.dev.
• أُعيدت تسمية Vertex AI Agent Engine إلى Agent Runtime على Gemini Enterprise Agent Platform.

بدائل باللغة نفسها