amazon bedrock minecraft agent

Beta – Amazon Bedrock Minecraft Agent (TypeScript)

Hinweis: Dieses Projekt befindet sich in der Betaphase. Sie können also damit rechnen, dass Fehler gefunden und Verbesserungen vorgenommen werden! Als Reaktion auf das große Interesse an diesem Projekt haben wir diesen Code jetzt veröffentlicht. Vielen Dank und bitte senden Sie uns weiterhin Ihr Feedback und Ihre Vorschläge.

Bei diesem Projekt handelt es sich um einen Minecraft-Bot, der mit dem Agents for Amazon Bedrock-Framework erstellt und in TypeScript geschrieben wurde. Es zeigt, wie man mithilfe der Return Control Agents einen Agenten erstellt, der mit der Minecraft-Welt interagieren kann.

Einführung

Der Amazon Bedrock Minecraft Agent ist eine TypeScript-Implementierung eines Agenten, der zur Automatisierung von Aufgaben und Interaktionen innerhalb der Minecraft-Welt verwendet werden kann. Es nutzt die Mineflayer-Bibliothek, die eine High-Level-Schnittstelle für die Interaktion mit der Minecraft-Spiel-Engine bietet.

Wie gesehen auf

• AWS-Entwickler-Livestream: https://www.youtube.com/live/sn5cUf022ek?si=aukSxnQRbliT5jjS&t=8656

Installation und Nutzung

Um diese Lösung im aktuellen (Beta-)Zustand zu installieren, wird empfohlen, dass Sie über einige Kenntnisse verfügen über:

• Amazonas-Grundgestein
• AWS CloudFormation
• AWS Cloud Development Kit (CDK) – Beim Hosten in ECS.

Darüber hinaus benötigen Sie zum Spielen einen Minecraft-Client mit der Version 1.20.1 und ein Konto.

Schritte zur Bereitstellung:

• Arbeiten in us-west-2 (Oregon)
• Aktivieren Sie auf der Konsolenseite von Amazon Bedrock den Zugriff auf die Modelle Claude 3 Haiku und Sonnet.
• Stellen Sie mithilfe von AWS CloudFormation die Vorlage agent_cfn/amazon-bedrock-minecraft-agent-roc.yaml in einem Stack bereit.
• Beachten Sie die Ausgaben des bereitgestellten Stacks agentId und agentAliasId .

Die Verwendung des Agenten erfolgt lokal für Entwicklung und Test:

Verwendung:

• Starten Sie Minecraft v1.20.1, starten Sie ein Einzelspieler-Spiel (lokal) und verwenden Sie im Spiel „Open to LAN“ und stellen Sie den Port auf 25565 ein.
• Öffnen Sie im Ordner agent_ts/ ein Terminal und installieren Sie die Knotenpakete nach Bedarf npm install .
• Aktualisieren Sie die Konfiguration, entweder durch Festlegen von Umgebungsvariablen ODER durch Bearbeiten von agent_ts/.env ODER durch Bearbeiten von agent_ts/config.ts . Legen Sie die agentId und die agentAliasId auf Werte fest, die vom CloudFormation-Stack des Agenten ausgegeben werden.
• Führen Sie den TypeScript-Code in agent_ts/ mit npm run start:dev aus
• Interagiere mit Rocky im Spiel, indem du den In-Game-Chat verwendest und t drückst. Versuchen Sie es mit „Hallo“, „Komm zu mir“ und „Grabe ein 2 x 2 großes Loch“. Sehen Sie sich die Debug-Ausgabe im Terminal an, von dem aus Sie ausgeführt werden.

Installation und Nutzung – Cloud Hosted (ECS)

Dieses Repo enthält auch einen CDK-Stack, der den Agent-Client-Code für eine Aufgabe (Container) innerhalb von ECS bereitstellt. Sie sollten dies nur in Betracht ziehen, wenn Sie mit der Technologie vertraut sind und einen Minecraft-Server betreiben. Überprüfen Sie den Code sorgfältig und beachten Sie mindestens Folgendes:

• Sicherheitsrisiken: Der bereitgestellte Minecraft-Server ist öffentlich zugänglich, und da der Server keine Benutzernamen überprüft, kann jeder mit jedem Benutzernamen beitreten, auch mit solchen, die bereits von anderen Spielern verwendet werden. Dies kann zu Nachahmung und Trauer führen.
• Serversteuerung: Derzeit ist der RCON-Port auf dem Server nicht verfügbar, daher besteht kein Administratorzugriff. Dies wird in Zukunft behoben.

Schritte zur Bereitstellung:

• Öffnen Sie im Ordner cdk/ ein Terminal und installieren Sie die Knotenpakete nach Bedarf npm install .
• Stellen Sie das CDK-Projekt über cdk/ mithilfe der Kontextvariablen agentId und agentAliasId bereit, z. B.:

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

Verwendung:

• Starten Sie Minecraft v1.20.1.
• Wählen Sie Multiplayer und dann Add Server .
• Geben Sie die Adresse des Netzwerk-LoadBalancers ein, der von CDK bereitgestellt wurde, unter Verwendung von Port :25565 .
• Interagiere mit Rocky im Spiel, indem du den In-Game-Chat verwendest und t drückst. Versuchen Sie es mit „Hallo“, „Komm zu mir“ und „Grabe ein 2 x 2 großes Loch“. Sehen Sie sich die Debug-Ausgabe im Terminal an, von dem aus Sie ausgeführt werden.

Ein bisschen über die Technologie

Rückgabekontrolle

„Anstatt die Informationen, die Ihr Agent vom Benutzer erhalten hat, zur Erfüllung an eine Lambda-Funktion zu senden, können Sie stattdessen die Kontrolle an den Agentenentwickler zurückgeben, indem Sie die Informationen in der InvokeAgent-Antwort senden.“

Mineflayer-Bibliothek

Die Mineflayer-Bibliothek ist ein leistungsstarkes Tool zum Erstellen von Minecraft-Agenten und zum Automatisieren von Aufgaben innerhalb der Spielwelt. Es bietet eine Reihe von Klassen und Funktionen, die Details auf niedriger Ebene abstrahieren und so die Entwicklung komplexer Verhaltensweisen und Interaktionen erleichtern.

Haftungsausschluss

Bei diesem Projekt handelt es sich um einen Machbarkeitsnachweis und es ist nicht für den Produktionseinsatz vorgesehen. Es wird als Beispiel dafür bereitgestellt, wie Rückgabekontrollagenten mithilfe des Agents for Amazon Bedrock-Frameworks und der Mineflayer-Bibliothek erstellt werden.

Sicherheit

Weitere Informationen finden Sie unter BEITRAGEN.

Lizenz

Diese Bibliothek ist unter der MIT-0-Lizenz lizenziert. Siehe die LICENSE-Datei.