amazon bedrock minecraft agent

เบต้า - ตัวแทน Amazon Bedrock Minecraft (TypeScript)

หมายเหตุ: โครงการนี้อยู่ในช่วงเบต้า ดังนั้นคาดว่าจะพบข้อผิดพลาดและการปรับปรุง! เราได้เผยแพร่โค้ดนี้แล้วเพื่อตอบสนองต่อความสนใจจำนวนมากในโครงการนี้ ขอขอบคุณและโปรดส่งข้อเสนอแนะและข้อเสนอแนะของคุณต่อไป

โปรเจ็กต์นี้เป็นบอต Minecraft ที่สร้างขึ้นโดยใช้เฟรมเวิร์ก Agents สำหรับ Amazon Bedrock ซึ่งเขียนด้วย TypeScript มันสาธิตวิธีการสร้างตัวแทนที่สามารถโต้ตอบกับโลก Minecraft โดยใช้ Return Control Agents

การแนะนำ

Amazon Bedrock Minecraft Agent คือการใช้งาน TypeScript ของเอเจนต์ที่สามารถใช้เพื่อทำงานและการโต้ตอบภายในโลก Minecraft โดยอัตโนมัติ มันใช้ประโยชน์จากไลบรารี Mineflayer ซึ่งมีอินเทอร์เฟซระดับสูงสำหรับการโต้ตอบกับเอ็นจิ้นเกม Minecraft

เท่าที่เห็น

• สตรีมสดของนักพัฒนา AWS: https://www.youtube.com/live/sn5cUf022ek?si=aukSxnQRbliT5jjS&t=8656

การติดตั้งและการใช้งาน

หากต้องการติดตั้งโซลูชันนี้ในสถานะปัจจุบัน (เบต้า) ขอแนะนำให้คุณมีความรู้เกี่ยวกับ:

• อเมซอน ข้อเท็จจริง
• AWS CloudFormation
• AWS Cloud Development Kit (CDK) - หากโฮสต์ใน ECS

นอกจากนี้ คุณจะต้องมีไคลเอนต์ Minecraft เวอร์ชัน 1.20.1 และบัญชีในการเล่น

ขั้นตอนในการปรับใช้:

• ทำงานที่ us-west-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 ลองพูดว่า "สวัสดี" "มาหาฉัน" และ "ขุดหลุมขนาด 2x2" ดูเอาต์พุตการดีบักในเทอร์มินัลที่คุณใช้งานอยู่

การติดตั้งและการใช้งาน - Cloud Hosted (ECS)

ที่เก็บนี้ยังประกอบด้วยสแต็ก CDK ที่จะปรับใช้โค้ดไคลเอ็นต์ตัวแทนกับงาน (คอนเทนเนอร์) ภายใน ECS คุณควรพิจารณาใช้สิ่งนี้เฉพาะเมื่อคุณคุ้นเคยกับเทคโนโลยีและใช้งานเซิร์ฟเวอร์ Minecraft เท่านั้น ตรวจสอบโค้ดอย่างรอบคอบและอย่างน้อยที่สุด:

• ความเสี่ยงด้านความปลอดภัย: เซิร์ฟเวอร์ Minecraft ที่ใช้งานนั้นสามารถเข้าถึงได้แบบสาธารณะ และเนื่องจากเซิร์ฟเวอร์ไม่ได้ยืนยันชื่อผู้ใช้ ทุกคนจึงสามารถเข้าร่วมด้วยชื่อผู้ใช้ใดก็ได้ รวมถึงชื่อผู้ใช้ที่ผู้เล่นอื่นใช้แล้ว สิ่งนี้สามารถนำไปสู่การแอบอ้างบุคคลอื่นและความโศกเศร้าได้
• การควบคุมเซิร์ฟเวอร์: ขณะนี้พอร์ต RCON ไม่พร้อมใช้งานบนเซิร์ฟเวอร์ ดังนั้นจึงไม่มีการเข้าถึงของผู้ดูแลระบบ สิ่งนี้จะได้รับการแก้ไขในอนาคต

ขั้นตอนในการปรับใช้:

• จากโฟลเดอร์ cdk/ ให้เปิดเทอร์มินัล ติดตั้งแพ็กเกจโหนดตามต้องการ npm install
• ปรับใช้โปรเจ็กต์ CDK จาก cdk/ โดยใช้ตัวแปรบริบท agentId และ agentAliasId เช่น:

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

การใช้งาน:

• เปิดตัว Minecraft v1.20.1
• เลือก Multiplayer และเลือก Add Server
• ป้อนที่อยู่ของ Network LoadBalancer ที่ CDK ปรับใช้ โดยใช้พอร์ต :25565
• โต้ตอบกับ Rocky ในเกมโดยใช้แชทในเกม กด t ลองพูดว่า "สวัสดี" "มาหาฉัน" และ "ขุดหลุมขนาด 2x2" ดูเอาต์พุตการดีบักในเทอร์มินัลที่คุณใช้งานอยู่

เล็กน้อยเกี่ยวกับเทคโนโลยี

การควบคุมการย้อนกลับ

"แทนที่จะส่งข้อมูลที่ตัวแทนของคุณดึงมาจากผู้ใช้ไปยังฟังก์ชัน Lambda เพื่อดำเนินการ คุณสามารถเลือกที่จะคืนการควบคุมให้กับนักพัฒนาตัวแทนแทนได้โดยการส่งข้อมูลในการตอบกลับ InvolvAgent"

ห้องสมุดไมน์เฟลเยอร์

ไลบรารี Mineflayer เป็นเครื่องมืออันทรงพลังสำหรับการสร้างตัวแทน Minecraft และทำงานอัตโนมัติภายในโลกของเกม โดยจัดเตรียมชุดของคลาสและฟังก์ชันที่จะสรุปรายละเอียดระดับต่ำ ทำให้ง่ายต่อการพัฒนาพฤติกรรมและการโต้ตอบที่ซับซ้อน

ข้อสงวนสิทธิ์

โปรเจ็กต์นี้เป็นการพิสูจน์แนวคิดและไม่ได้มีไว้สำหรับการใช้งานจริง โดยให้ไว้เป็นตัวอย่างของวิธีสร้างเอเจนต์การควบคุมการส่งคืนโดยใช้ Agent สำหรับเฟรมเวิร์ก Amazon Bedrock และไลบรารี Mineflayer

ความปลอดภัย

ดูการมีส่วนร่วมสำหรับข้อมูลเพิ่มเติม

ใบอนุญาต

ห้องสมุดนี้ได้รับอนุญาตภายใต้ใบอนุญาต MIT-0 ดูไฟล์ใบอนุญาต