Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Mengimpor agen Google ADK — satu agen pada Gemini

Agent Config dari aplikasi yang dibangun di atas Agent Development Kit milik Google — satu agen pada Gemini, dengan alat Google Search yang disertakan ADK — dijadikan draf berkas Aggrega oleh aggrega import, dengan image aplikasi dijawab sekali dalam berkas jawaban, dan di-build untuk Docker Compose.

Mengimpor agen Google ADK membahasnya langkah demi langkah: perintahnya, apa yang ditanyakannya, berkas yang ditulisnya dan alasan setiap barisnya ada, build-nya, serta agen yang berjalan. Folder ini memuat setiap tahap dari panduan tersebut:

folder atau berkasisinya
source/konfigurasi agen, support_agent/root_agent.yaml, .aggrega-config.yaml yang menjadikan folder ini ruang kerja, dan support_agent/import-answers.yaml, nilai-nilai yang tidak dimuat oleh konfigurasi mana pun: image aplikasi, dan nama Secret Kubernetes tempat build untuk Kubernetes membaca kunci API Gemini
draft/berkas yang ditulis oleh aggrega import support_agent --target compose, tanpa diubah, termasuk release.lock, dan apa yang dicetaknya: stdout.txt pada keluaran standar, import.txt pada galat standar

Konfigurasi ini ditulis untuk contoh ini. Kode aplikasi dan berkas lingkungan yang ditulis oleh scaffold ADK bukan bagian dari contoh ini: impor tidak pernah membaca keduanya, dan Release menyebutkan image tempat aplikasi berjalan.

Dalam checkout repositori dokumentasi, check.sh menjalankan impor lagi, membandingkan apa yang ditulis dan dicetaknya dengan draft/, membandingkan blok yang dikutip panduan dengan berkas-berkas ini, serta memvalidasi dan mem-build apa yang ditulis oleh impor. Skrip ini memerlukan katalog pustaka standar (cara mendapatkannya) yang di-checkout di samping repositori ini, atau direktorinya disebutkan dalam AGGREGA_CATALOG_DIRS.

Membuat contoh

Anda dapat menjalankan impor contoh ini dengan perintah di bawah, atau meminta asisten AI Anda menjalankannya untuk Anda.

Tulis contoh ke folder baru yang dinamai sesuai contoh itu:

Terminal window
aggrega scaffold --example import-google-adk

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd import-google-adk

Build

Impor membuat draf berkas Aggrega di samping proyek, di source/. Impor menimbang proyek terhadap katalog pustaka standar, yang diterbitkan oleh registry default ruang kerja sebagai snapshot bertanda tangan: impor pertama mengambilnya, memverifikasinya, menyimpannya di cache konten ruang kerja, dan menyebutnya dengan digest-nya dalam catatan yang ditulisnya di samping draf. Ruang kerja yang menyebutkan folder katalognya sendiri — di AGGREGA_CATALOG_DIRS, atau di bawah workspace.catalog_dirs — mengimpor terhadap folder-folder itu sebagai gantinya. Impor membaca image dari support_agent/import-answers.yaml, lalu menarik apa yang menjadi dependensi Release hasil draf, sehingga build dapat langsung menyusul:

Terminal window
cd source
aggrega import support_agent --target compose
aggrega build --release release.yaml

Image yang disebutkan contoh ini mewakili image yang Anda build dari proyek Anda; cara mem-build-nya dan menjalankan stack-nya ada di panduan yang ditautkan di atas.

Dengan asisten AI

Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.

Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `import-google-adk`, panggil alat `scaffold` sekali dengan `example` diatur ke `import-google-adk` dan tanpa `dir`: alat itu menulis contoh ke folder `import-google-adk` yang baru, dengan folder `source` di dalamnya yang berisi apa yang diimpor contoh ini. Lalu panggil alat `import` dengan `workspace_root` diatur ke `import-google-adk/source`, `source` diatur ke `support_agent`, dan `target` diatur ke `compose`: alat itu membaca jawaban yang dibutuhkannya dari `import-answers.yaml` di dalam folder `support_agent`, menulis drafnya ke `import-google-adk/source`, dan menarik apa yang dibutuhkan draf tersebut. Lalu panggil alat `validate` dengan `workspace_root` diatur ke `import-google-adk/source` dan `release` diatur ke `release.yaml`, serta alat `build` dengan `workspace_root` diatur ke `import-google-adk/source`, `release` diatur ke `release.yaml`, dan `write` diatur ke true. Beri tahu saya berkas mana yang ditulis build; berkas tersebut berada di bawah `import-google-adk/source/dist/`.

Mengujinya

Dengan stack berjalan seperti yang dijalankan panduan, pada image yang dibangun oleh Dockerfile-nya, kirim pesan ke agen di port yang dipublikasikan Release:

Terminal window
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."}]}}'

Kunci Gemini pada eksekusi ini adalah placeholder, sehingga permintaan dijawab dengan HTTP 500, Internal Server Error, dan log layanan menyebutkan penolakan Gemini:

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]}}

Diimpor dengan --target helm, pada image yang didorong ke registry yang dibaca cluster, seperti yang ditunjukkan panduan, agen menjawab pesan yang sama di alamat yang sama setelah sebuah port lokal diteruskan ke Service-nya:

Terminal window
kubectl port-forward -n <namespace> svc/support-agent-default 8000:8000