amazon bedrock minecraft agent

النسخة التجريبية - وكيل Amazon Bedrock Minecraft (TypeScript)

ملحوظة: هذا المشروع في مرحلة تجريبية، لذا توقع العثور على مواطن الخلل وإجراء التحسينات! لقد أصدرنا هذا الكود الآن استجابة للقدر الهائل من الاهتمام بهذا المشروع. شكرًا لك، ويرجى الاستمرار في إرسال ملاحظاتك واقتراحاتك.

هذا المشروع عبارة عن روبوت Minecraft تم إنشاؤه باستخدام إطار عمل Agents for Amazon Bedrock، المكتوب بلغة TypeScript. يوضح كيفية إنشاء وكيل يمكنه التفاعل مع عالم Minecraft باستخدام وكلاء التحكم في الإرجاع.

مقدمة

Amazon Bedrock Minecraft Agent هو تطبيق TypeScript لوكيل يمكن استخدامه لأتمتة المهام والتفاعلات داخل عالم Minecraft. فهو يستفيد من مكتبة Mineflayer، التي توفر واجهة عالية المستوى للتفاعل مع محرك لعبة Minecraft.

كما رأينا في

• البث المباشر لمطوري AWS: https://www.youtube.com/live/sn5cUf022ek?si=aukSxnQRbliT5jjS&t=8656

التثبيت والاستخدام

لتثبيت هذا الحل في حالته الحالية (التجريبية)، يوصى بأن تكون لديك بعض المعرفة بما يلي:

• أمازون بيدروك
• AWS كلاودفورميشن
• AWS Cloud Development Kit (CDK) - في حالة الاستضافة في ECS.

بالإضافة إلى ذلك، ستحتاج إلى عميل Minecraft بالإصدار 1.20.1 وحساب للعب.

خطوات النشر:

• العمل في غرب الولايات المتحدة 2 (أوريغون)
• من صفحة وحدة تحكم Amazon Bedrock، قم بتمكين الوصول إلى نماذج Claude 3 Haiku وSonnet.
• باستخدام AWS CloudFormation، انشر القالب agent_cfn/amazon-bedrock-minecraft-agent-roc.yaml إلى المكدس.
• لاحظ المخرجات من agentId المكدس المنشور و agentAliasId .

استخدام الوكيل هو التطوير والاختبار المحلي:

الاستخدام:

• قم بتشغيل Minecraft v1.20.1، وابدأ لعبة لاعب واحد (محلي)، وفي اللعبة، استخدم "Open to LAN" واضبط المنفذ على 25565 .
• من المجلد agent_ts/ ، افتح الوحدة الطرفية، وقم بتثبيت حزم العقدة كما هو مطلوب npm install .
• قم بتحديث التكوين، إما عن طريق تعيين متغيرات البيئة، أو تحرير agent_ts/.env أو عن طريق تحرير agent_ts/config.ts . قم بتعيين agentId و agentAliasId على إخراج القيم من مكدس CloudFormation للوكيل.
• قم بتشغيل كود TypeScript في agent_ts/ مع npm run start:dev
• تفاعل مع Rocky داخل اللعبة باستخدام الدردشة داخل اللعبة، بالضغط على t . جرب "مرحبًا" و"تعال إلي" و"احفر حفرة 2 × 2". شاهد إخراج التصحيح في الجهاز الذي تعمل منه.

التثبيت والاستخدام - السحابة المستضافة (ECS)

يحتوي هذا الريبو أيضًا على مكدس CDK الذي سينشر رمز عميل الوكيل إلى مهمة (حاوية) داخل ECS. يجب أن تفكر في استخدام هذا فقط إذا كنت معتادًا على التكنولوجيا وتقوم بتشغيل خادم Minecraft. قم بمراجعة الكود بعناية وبأقل ملاحظة:

• المخاطر الأمنية: يمكن الوصول إلى خادم Minecraft المنشور بشكل عام، وبما أن الخادم لا يتحقق من أسماء المستخدمين، فيمكن لأي شخص الانضمام بأي اسم مستخدم، بما في ذلك الأسماء التي تم أخذها بالفعل من قبل لاعبين آخرين. هذا يمكن أن يؤدي إلى انتحال الشخصية والحزن.
• التحكم في الخادم: لا يتوفر حاليًا منفذ RCON على الخادم، لذلك لا يوجد وصول إداري. سيتم معالجة هذا في المستقبل.

خطوات النشر:

• من المجلد cdk/ ، افتح الوحدة الطرفية، ثم قم بتثبيت حزم العقدة كما هو مطلوب npm install .
• انشر مشروع CDK من cdk/ باستخدام متغيرات السياق agentId و agentAliasId ، على سبيل المثال:

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

الاستخدام:

• قم بتشغيل ماين كرافت v1.20.1.
• حدد Multiplayer وحدد Add Server .
• أدخل عنوان Network LoadBalancer الذي تم نشره بواسطة CDK، باستخدام المنفذ :25565 .
• تفاعل مع Rocky داخل اللعبة باستخدام الدردشة داخل اللعبة، بالضغط على t . جرب "مرحبًا" و"تعال إلي" و"احفر حفرة 2 × 2". شاهد إخراج التصحيح في الجهاز الذي تعمل منه.

قليلا عن التكنولوجيا

التحكم في العودة

"بدلاً من إرسال المعلومات التي حصل عليها وكيلك من المستخدم إلى وظيفة Lambda للوفاء بها، يمكنك بدلاً من ذلك اختيار إعادة التحكم إلى مطور الوكيل عن طريق إرسال المعلومات في استجابة InvocAgent."

مكتبة ماين فلاير

تعد مكتبة Mineflayer أداة قوية لبناء وكلاء Minecraft وأتمتة المهام داخل عالم اللعبة. فهو يوفر مجموعة من الفئات والوظائف التي تلخص التفاصيل ذات المستوى المنخفض، مما يسهل تطوير السلوكيات والتفاعلات المعقدة.

إخلاء المسؤولية

هذا المشروع هو دليل على المفهوم وليس مخصصًا للاستخدام الإنتاجي. يتم تقديمه كمثال لكيفية إنشاء وكلاء التحكم في الإرجاع باستخدام إطار عمل Agents for Amazon Bedrock ومكتبة Mineflayer.

حماية

انظر المساهمة لمزيد من المعلومات.

رخصة

هذه المكتبة مرخصة بموجب ترخيص MIT-0. انظر ملف الترخيص.