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

Mengimpor proyek CrewAI — kru berisi dua agen

Deklarasi agen dan tugas dari proyek CrewAI dalam tata letak klasik — dua agen pada satu model OpenAI, masing-masing dengan satu tugas — dijadikan draf berkas Aggrega oleh aggrega import, dengan image tempat program crew berjalan dijawab sekali dalam berkas jawaban, dan di-build untuk Docker Compose.

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

folder atau berkasisinya
source/deklarasi proyek, src/support_brief/config/agents.yaml dan tasks.yaml, .aggrega-config.yaml yang menjadikan folder ini ruang kerja, serta src/support_brief/import-answers.yaml, nilai-nilai yang tidak dimuat oleh deklarasi mana pun: image setiap agen, dan nama Secret Kubernetes tempat build untuk Kubernetes membaca kunci OpenAI
draft/berkas yang ditulis oleh aggrega import src/support_brief --target compose, tanpa diubah, termasuk release.lock, dan apa yang dicetaknya: stdout.txt pada keluaran standar, import.txt pada galat standar

Deklarasi ini ditulis untuk contoh ini. Program kru bukan bagian dari contoh ini: impor tidak pernah membaca program apa pun, dan Release menyebutkan image tempat program itu 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-crewai

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

Terminal window
cd import-crewai

Build

Impor menyusun draf berkas Aggrega di samping proyek, di source/. Impor menimbang proyek terhadap katalog pustaka standar, yang diterbitkan registry default ruang kerja sebagai snapshot bertanda tangan: impor pertama mengambilnya, memverifikasinya, menyimpannya di cache konten ruang kerja, dan menamainya 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 tersebut sebagai gantinya. Impor membaca image dari src/support_brief/import-answers.yaml, lalu menarik apa yang menjadi dependensi Release hasil draf, sehingga build dapat langsung menyusul:

Terminal window
cd source
aggrega import src/support_brief --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-crewai`, panggil alat `scaffold` sekali dengan `example` diatur ke `import-crewai` dan tanpa `dir`: alat itu menulis contoh ke folder `import-crewai` yang baru, dengan folder `source` di dalamnya yang berisi apa yang diimpor contoh ini. Lalu panggil alat `import` dengan `workspace_root` diatur ke `import-crewai/source`, `source` diatur ke `src/support_brief`, dan `target` diatur ke `compose`: alat itu membaca jawaban yang dibutuhkannya dari `import-answers.yaml` di dalam folder `src/support_brief`, menulis drafnya ke `import-crewai/source`, dan menarik apa yang dibutuhkan draf tersebut. Lalu panggil alat `validate` dengan `workspace_root` diatur ke `import-crewai/source` dan `release` diatur ke `release.yaml`, serta alat `build` dengan `workspace_root` diatur ke `import-crewai/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-crewai/source/dist/`.

Mengujinya

Dengan stack berjalan seperti yang dijalankan panduan, satu permintaan mencapai crew. Rute di bawah ini adalah milik program panduan itu sendiri, sebuah server HTTP kecil pada port 8000; program Anda sendiri menentukan rutenya sendiri. Release memublikasikan peneliti di 127.0.0.1:8000 dan penulis di 127.0.0.1:8001, sehingga permintaan dikirim ke peneliti dari mesin Anda:

Terminal window
curl -sS -X POST http://127.0.0.1:8000/kickoff -H 'Content-Type: application/json' \
-d '{"question": "Which support plan covers a weekend outage, and what does it cost?"}'
{
"error": "the crew failed: AuthenticationError: Error code: 401 - {'error': {'message': 'Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key, and the error's type and code]"
}

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:

Terminal window
kubectl port-forward deploy/researcher 8000:8000
Terminal window
curl -sS -X POST http://127.0.0.1:8000/kickoff -H 'Content-Type: application/json' \
-d '{"question": "Which support plan covers a weekend outage, and what does it cost?"}'

Jawabannya sama.