Mengimpor agen deklaratif Microsoft Agent Framework — sebuah agen dan sebuah server MCP
Agen deklaratif Microsoft Agent Framework — satu agen pada model OpenAI, yang mencari dokumentasi melalui server MCP — dijadikan draf berkas Aggrega oleh aggrega import, dengan image aplikasi dijawab sekali dalam berkas jawaban, dan di-build untuk Docker Compose.
Mengimpor agen deklaratif Microsoft Agent Framework 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 berkas | isinya |
|---|---|
source/ | agen deklaratif, support-agent.yaml, .aggrega-config.yaml yang menjadikan folder ini ruang kerja, dan import-answers.yaml, nilai-nilai yang tidak dimuat oleh agen deklaratif mana pun: image aplikasi, dan nama Kubernetes Secret tempat build untuk Kubernetes membaca kunci OpenAI |
draft/ | berkas yang ditulis oleh aggrega import support-agent.yaml --target compose, tanpa diubah, termasuk release.lock, dan apa yang dicetaknya: stdout.txt pada keluaran standar, import.txt pada galat standar |
Agen deklaratif ini ditulis untuk contoh ini. Kode aplikasi, yang memuatnya, bukan bagian dari contoh ini: impor tidak pernah membacanya, 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:
aggrega scaffold --example import-agent-frameworkKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd import-agent-frameworkBuild
Impor membuat draf berkas Aggrega di samping agen deklaratif, di source/. Impor menimbang proyek terhadap katalog pustaka standar, yang diterbitkan oleh registry bawaan ruang kerja sebagai snapshot bertanda tangan: impor pertama mengambilnya, memverifikasinya, menyimpannya di cache konten ruang kerja, dan menyebutnya berdasarkan 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 import-answers.yaml, lalu menarik apa yang menjadi dependensi Release hasil draf, sehingga build dapat langsung menyusul:
cd sourceaggrega import support-agent.yaml --target composeaggrega build --release release.yamlImage 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-agent-framework`, panggil alat `scaffold` sekali dengan `example` diatur ke `import-agent-framework` dan tanpa `dir`: alat ini menulis contoh ke dalam folder `import-agent-framework` yang baru, dengan folder `source` di dalamnya yang berisi apa yang diimpor contoh ini. Lalu panggil alat `import` dengan `workspace_root` diatur ke `import-agent-framework/source`, `source` diatur ke `support-agent.yaml`, dan `target` diatur ke `compose`: alat ini membaca jawaban yang dibutuhkannya dari `import-answers.yaml` di samping `support-agent.yaml`, menulis drafnya ke `import-agent-framework/source`, dan menarik apa yang dibutuhkan draf tersebut. Lalu panggil alat `validate` dengan `workspace_root` diatur ke `import-agent-framework/source` dan `release` diatur ke `release.yaml`, serta alat `build` dengan `workspace_root` diatur ke `import-agent-framework/source`, `release` diatur ke `release.yaml`, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh build; file tersebut berada di bawah `import-agent-framework/source/dist/`.Mengujinya
Dengan stack berjalan seperti yang dijalankan panduan langkah demi langkah, satu permintaan mencapai agen. Rute di bawah adalah milik program panduan itu sendiri, sebuah server HTTP kecil di port 8000; program Anda sendiri menentukan rutenya sendiri. Release memublikasikan agen di 127.0.0.1:8000, sehingga permintaan dikirim dari mesin Anda:
curl -sS -X POST http://127.0.0.1:8000/ask -H 'Content-Type: application/json' \ -d '{"question": "In one short sentence: what is Azure Container Apps?"}'{"error": "the agent failed: ChatClientException: (\"<class 'agent_framework_openai._chat_client.OpenAIChatClient'> service failed to complete the prompt: Error code: 401 - Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key, and the same error repeated as the exception it wraps]"}Kunci pada run ini adalah placeholder, sehingga jawabannya adalah penolakan OpenAI terhadap kunci itu. Di Kubernetes, teruskan port lokal ke Deployment, yang tidak memiliki Service, lalu kirim permintaan yang sama ke sana dari terminal lain:
kubectl port-forward deploy/supportagent 8000:8000curl -sS -X POST http://127.0.0.1:8000/ask -H 'Content-Type: application/json' \ -d '{"question": "In one short sentence: what is Azure Container Apps?"}'Jawabannya sama.