Bir Google ADK ajanını içe aktarma — Gemini üzerinde tek bir ajan
Google’ın Agent Development Kit’i üzerine kurulmuş bir uygulamanın Agent Config’i — ADK ile gelen Google Search aracıyla Gemini üzerinde tek bir ajan — aggrega import ile Aggrega dosyalarına taslak olarak aktarılmış, uygulamanın imajı bir yanıt dosyasında bir kez belirtilmiş ve Docker Compose için derlenmiş.
Bir Google ADK ajanını içe aktarma bunu adım adım anlatır: komutu, ne sorduğunu, yazdığı dosyaları ve her satırın neden orada olduğunu, derlemeyi ve çalışan ajanı. Bu klasör, o adım adım anlatımın her aşamasını içerir:
| klasör veya dosya | içeriği |
|---|---|
source/ | ajanın yapılandırması, support_agent/root_agent.yaml, klasörü bir çalışma alanı yapan .aggrega-config.yaml ve hiçbir yapılandırmanın tutmadığı değerleri içeren support_agent/import-answers.yaml: uygulamanın imajı ve Kubernetes için bir derlemenin Gemini API anahtarını okuduğu Kubernetes Secret’ının adı |
draft/ | aggrega import support_agent --target compose komutunun yazdığı dosyalar, release.lock dahil, değiştirilmemiş haliyle, ve komutun yazdırdıkları: standart çıktıya stdout.txt, standart hataya import.txt |
Yapılandırma bu örnek için yazılmıştır. Uygulamanın kodu ve ADK iskeletinin yazdığı ortam dosyası örneğin parçası değildir: içe aktarma ikisini de hiçbir zaman okumaz ve uygulamanın çalıştığı imajı Release belirtir.
Belge deposunun bir checkout’unda check.sh, içe aktarmayı yeniden çalıştırır, yazdıklarını ve yazdırdıklarını draft/ ile karşılaştırır, adım adım anlatımın alıntıladığı blokları bu dosyalarla karşılaştırır ve içe aktarmanın yazdıklarını doğrulayıp derler. Standart kütüphane kataloğunun (nereden edinilir) bu deponun yanında checkout edilmiş olmasına ya da dizininin AGGREGA_CATALOG_DIRS içinde belirtilmesine ihtiyaç duyar.
Örneği oluşturun
Bu örneğin içe aktarmasını aşağıdaki komutlarla çalıştırabilir ya da yapay zekâ asistanınıza sizin yerinize çalıştırtabilirsiniz.
Örneği, adını taşıyan yeni bir klasöre yazın:
aggrega scaffold --example import-google-adkArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd import-google-adkDerleme
İçe aktarma, Aggrega dosyalarını projenin yanında, source/ içinde taslak olarak oluşturur. Projeyi, çalışma alanının varsayılan kayıt defterinin imzalı bir anlık görüntü olarak yayımladığı standart kütüphane kataloğuyla karşılaştırır: ilk içe aktarma onu getirir, doğrular, çalışma alanının içerik önbelleğinde tutar ve taslakların yanına yazdığı kayıtta onu özetiyle (digest) adlandırır. Kendi katalog klasörlerini — AGGREGA_CATALOG_DIRS içinde veya workspace.catalog_dirs altında — adlandıran bir çalışma alanı ise bunun yerine bu klasörlere göre içe aktarır. İçe aktarma, imajı support_agent/import-answers.yaml dosyasından okur, ardından taslağı oluşturulan Release’in bağımlı olduklarını çeker; böylece derleme hemen ardından gelir:
cd sourceaggrega import support_agent --target composeaggrega build --release release.yamlÖrneğin belirttiği imaj, projenizden derlediğiniz bir imajın yerini tutar; onu derlemek ve yığını çalıştırmak yukarıda bağlantısı verilen adım adım anlatımda yer alır.
Bir yapay zekâ asistanıyla
Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.
Yalnızca Aggrega araçlarını kullanın ve kendiniz hiçbir klasör oluşturmayın. Çalışma alanı klasöründe henüz bir `import-google-adk` klasörü yoksa `scaffold` aracını `example` değeri `import-google-adk` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `import-google-adk` klasörüne yazar; bu klasörün içindeki `source` klasörü, bu örneğin içe aktardığı şeyleri içerir. Ardından `import` aracını `workspace_root` değeri `import-google-adk/source`, `source` değeri `support_agent` ve `target` değeri `compose` olacak şekilde çağırın: araç ihtiyaç duyduğu yanıtları `support_agent` klasörünün içindeki `import-answers.yaml` dosyasından okur, taslaklarını `import-google-adk/source` içine yazar ve taslakların ihtiyaç duyduklarını çeker. Ardından `validate` aracını `workspace_root` değeri `import-google-adk/source` ve `release` değeri `release.yaml` olacak şekilde, `build` aracını da `workspace_root` değeri `import-google-adk/source`, `release` değeri `release.yaml` ve `write` değeri true olacak şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; bunlar `import-google-adk/source/dist/` altındadır.Test edin
Yığın, kılavuzun çalıştırdığı gibi, kendi Dockerfile dosyasının derlediği imaj üzerinde çalışırken, Release’in yayımladığı porttan ajana bir mesaj gönderin:
curl -sS -X POST http://127.0.0.1:8000/run -H 'Content-Type: application/json' \ -d '{"app_name": "support_agent", "user_id": "u1", "session_id": "s1", "new_message": {"role": "user", "parts": [{"text": "Where is my order 1234? Answer in one short sentence."}]}}'Çalıştırmanın Gemini anahtarı bir yer tutucuydu, bu nedenle istek HTTP 500, Internal Server Error ile yanıtlandı ve servisin günlüğü Gemini’ın reddini belirtiyor:
google.genai.errors.ClientError: 400 INVALID_ARGUMENT. {'error': {'code': 400, 'message': 'API key not valid. Please pass a valid API key.', 'status': 'INVALID_ARGUMENT', [… omitted: the error's details]}}--target helm ile içe aktarılıp, kılavuzun gösterdiği gibi kümenin okuduğu bir registry’ye gönderilmiş imaj üzerinde çalıştırıldığında, yerel bir port Service’ine yönlendirildiği anda ajan aynı adreste aynı mesaja yanıt verir:
kubectl port-forward -n <namespace> svc/support-agent-default 8000:8000