amazon bedrock minecraft agent

Beta - Agen Minecraft Batuan Dasar Amazon (TypeScript)

Catatan: Proyek ini masih dalam versi beta, jadi harap ditemukan gangguan dan perbaikan dapat dilakukan! Kami telah merilis kode ini sekarang sebagai tanggapan atas besarnya minat terhadap proyek ini. Terima kasih dan silakan terus mengirimkan masukan dan saran Anda.

Proyek ini adalah bot Minecraft yang dibuat menggunakan kerangka Agen untuk Amazon Bedrock, yang ditulis dalam TypeScript. Ini menunjukkan cara membuat agen yang dapat berinteraksi dengan dunia Minecraft menggunakan Agen Kontrol Pengembalian.

Perkenalan

Agen Amazon Bedrock Minecraft adalah implementasi TypeScript dari agen yang dapat digunakan untuk mengotomatiskan tugas dan interaksi dalam dunia Minecraft. Ini memanfaatkan perpustakaan Mineflayer, yang menyediakan antarmuka tingkat tinggi untuk berinteraksi dengan mesin game Minecraft.

Seperti yang Terlihat Pada

• Streaming Langsung Pengembang AWS: https://www.youtube.com/live/sn5cUf022ek?si=aukSxnQRbliT5jjS&t=8656

Instalasi dan Penggunaan

Untuk menginstal solusi ini dalam keadaan saat ini (beta), Anda disarankan untuk memiliki pengetahuan tentang:

• Batuan Dasar Amazon
• AWS CloudFormation
• AWS Cloud Development Kit (CDK) - Jika dihosting di ECS.

Selain itu, Anda memerlukan klien Minecraft, dengan versi 1.20.1 , dan akun untuk bermain.

Langkah-langkah untuk menerapkan:

• Bekerja di us-west-2 (Oregon)
• Dari halaman konsol Amazon Bedrock, aktifkan akses ke model Claude 3 Haiku dan Sonnet.
• Menggunakan AWS CloudFormation, terapkan templat agent_cfn/amazon-bedrock-minecraft-agent-roc.yaml ke tumpukan.
• Catat output dari tumpukan yang disebarkan agentId dan agentAliasId .

Menggunakan agen adalah pengembangan dan pengujian lokal:

Penggunaan:

• Luncurkan Minecraft v1.20.1, mulai game pemain tunggal (lokal) dan di dalam game, gunakan "Buka ke LAN" dan atur port ke 25565 .
• Dari folder agent_ts/ , buka terminal, instal paket node sesuai kebutuhan npm install .
• Perbarui konfigurasi, baik dengan menyetel variabel lingkungan, ATAU mengedit agent_ts/.env ATAU dengan mengedit agent_ts/config.ts . Atur agentId dan agentAliasId ke nilai output dari tumpukan agen CloudFormation.
• Jalankan kode TypeScript di agent_ts/ dengan npm run start:dev
• Berinteraksi dengan Rocky di dalam game menggunakan obrolan dalam game, tekan t . Coba "halo", "datang padaku" dan "gali lubang 2 kali 2". Perhatikan keluaran debug di terminal tempat Anda menjalankan.

Instalasi dan Penggunaan - Cloud Hosted (ECS)

Repo ini juga berisi tumpukan CDK yang akan menyebarkan kode klien agen ke tugas (kontainer) dalam ECS. Anda sebaiknya hanya mempertimbangkan untuk menggunakan ini jika Anda terbiasa dengan teknologi dan menjalankan server Minecraft. Tinjau kode dengan hati-hati dan dengan catatan minimal:

• Risiko Keamanan: Server Minecraft yang digunakan dapat diakses publik, dan karena server tidak memverifikasi nama pengguna, siapa pun dapat bergabung dengan nama pengguna apa pun, termasuk nama pengguna yang sudah digunakan oleh pemain lain. Hal ini dapat menyebabkan peniruan identitas dan kesedihan.
• Kontrol Server: Saat ini port RCON tidak tersedia di server, sehingga tidak ada akses admin. Hal ini akan diatasi di masa depan.

Langkah-langkah untuk menerapkan:

• Dari folder cdk/ , buka terminal, instal paket node sesuai kebutuhan npm install .
• Terapkan proyek CDK dari cdk/ menggunakan variabel konteks agentId dan agentAliasId , misalnya:

 > cdk deploy --context agentAliasID=ABC123 --context agentID=XYZ321

Penggunaan:

• Luncurkan Minecraft v1.20.1.
• Pilih Multiplayer dan pilih Add Server .
• Masukkan alamat Network LoadBalancer yang disebarkan oleh CDK, menggunakan port :25565 .
• Berinteraksi dengan Rocky di dalam game menggunakan obrolan dalam game, tekan t . Coba "halo", "datang padaku" dan "gali lubang 2 kali 2". Perhatikan keluaran debug di terminal tempat Anda menjalankan.

Sedikit tentang Teknologi

Kontrol Pengembalian

"Daripada mengirimkan informasi yang diperoleh agen Anda dari pengguna ke fungsi Lambda untuk pemenuhan, Anda dapat memilih untuk mengembalikan kontrol ke pengembang agen dengan mengirimkan informasi dalam respons InvokeAgent."

Perpustakaan Mineflayer

Pustaka Mineflayer adalah alat yang ampuh untuk membangun agen Minecraft dan mengotomatisasi tugas dalam dunia game. Ini menyediakan serangkaian kelas dan fungsi yang mengabstraksikan detail tingkat rendah, membuatnya lebih mudah untuk mengembangkan perilaku dan interaksi yang kompleks.

Penafian

Proyek ini adalah bukti konsep dan tidak dimaksudkan untuk penggunaan produksi. Ini diberikan sebagai contoh cara membangun agen kontrol pengembalian menggunakan kerangka kerja Agen untuk Amazon Bedrock dan perpustakaan Mineflayer.

Keamanan

Lihat KONTRIBUSI untuk informasi lebih lanjut.

Lisensi

Perpustakaan ini dilisensikan di bawah Lisensi MIT-0. Lihat file LISENSI.