amazon bedrock minecraft agent

Bêta - Agent Minecraft Amazon Bedrock (TypeScript)

Remarque : ce projet est en version bêta, alors attendez-vous à trouver des problèmes et à apporter des améliorations ! Nous avons publié ce code maintenant en réponse à l'énorme intérêt suscité par ce projet. Merci et continuez à envoyer vos commentaires et suggestions.

Ce projet est un bot Minecraft construit à l'aide du framework Agents for Amazon Bedrock, écrit en TypeScript. Il montre comment créer un agent capable d'interagir avec le monde Minecraft à l'aide des agents de contrôle de retour.

Introduction

L'agent Amazon Bedrock Minecraft est une implémentation TypeScript d'un agent qui peut être utilisé pour automatiser les tâches et les interactions dans le monde Minecraft. Il exploite la bibliothèque Mineflayer, qui fournit une interface de haut niveau pour interagir avec le moteur de jeu Minecraft.

Comme on le voit sur

• Diffusion en direct des développeurs AWS : https://www.youtube.com/live/sn5cUf022ek?si=aukSxnQRbliT5jjS&t=8656

Installation et utilisation

Pour installer cette solution dans son état actuel (bêta), il est recommandé d'avoir quelques connaissances sur :

• Socle amazonien
• AWS CloudFormation
• AWS Cloud Development Kit (CDK) – Si hébergement dans ECS.

De plus, vous aurez besoin d'un client Minecraft, avec la version 1.20.1 , et d'un compte pour jouer.

Étapes de déploiement :

• Travailler aux États-Unis-Ouest-2 (Oregon)
• Depuis la page de la console Amazon Bedrock, activez l'accès aux modèles Claude 3 Haiku et Sonnet.
• À l'aide d'AWS CloudFormation, déployez le modèle agent_cfn/amazon-bedrock-minecraft-agent-roc.yaml sur une pile.
• Notez les sorties de la pile déployée agentId et agentAliasId .

L'utilisation de l'agent est un développement et un test local :

Usage:

• Lancez Minecraft v1.20.1, démarrez une partie solo (locale) et dans le jeu, utilisez "Open to LAN" et définissez le port sur 25565 .
• À partir du dossier agent_ts/ , ouvrez un terminal, installez les packages de nœuds comme requis npm install .
• Mettez à jour la configuration, soit en définissant des variables d'environnement, OU en modifiant agent_ts/.env OU en modifiant agent_ts/config.ts . Définissez agentId et agentAliasId sur les valeurs sorties de la pile d'agent CloudFormation.
• Exécutez le code TypeScript dans agent_ts/ avec npm run start:dev
• Interagissez avec Rocky dans le jeu en utilisant le chat en jeu, en appuyant sur t . Essayez « bonjour », « viens à moi » et « creuse un trou de 2 par 2 ». Regardez la sortie de débogage dans le terminal à partir duquel vous exécutez.

Installation et utilisation – hébergé dans le cloud (ECS)

Ce référentiel contient également une pile CDK qui déploiera le code client de l'agent sur une tâche (conteneur) au sein d'ECS. Vous ne devriez envisager de l'utiliser que si vous êtes familier avec la technologie et que vous exécutez un serveur Minecraft. Lisez attentivement le code et notez au minimum :

• Risques de sécurité : le serveur Minecraft déployé est accessible au public et, comme le serveur ne vérifie pas les noms d'utilisateur, n'importe qui peut rejoindre n'importe quel nom d'utilisateur, y compris ceux déjà utilisés par d'autres joueurs. Cela peut conduire à l’usurpation d’identité et au deuil.
• Contrôle du serveur : actuellement, le port RCON n'est pas disponible sur le serveur, il n'y a donc pas d'accès administrateur. Ce problème sera abordé à l'avenir.

Étapes de déploiement :

• À partir du dossier cdk/ , ouvrez un terminal, installez les packages de nœuds comme requis npm install .
• Déployez le projet CDK depuis cdk/ en utilisant les variables contextuelles agentId et agentAliasId , par exemple :

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

Usage:

• Lancez Minecraft v1.20.1.
• Sélectionnez Multiplayer et sélectionnez Add Server .
• Entrez l'adresse du Network LoadBalancer déployé par CDK, à l'aide du port :25565 .
• Interagissez avec Rocky dans le jeu en utilisant le chat en jeu, en appuyant sur t . Essayez « bonjour », « viens à moi » et « creuse un trou de 2 par 2 ». Regardez la sortie de débogage dans le terminal à partir duquel vous exécutez.

Un peu sur la technologie

Contrôle des retours

"Plutôt que d'envoyer les informations que votre agent a obtenues de l'utilisateur à une fonction Lambda pour exécution, vous pouvez choisir de rendre le contrôle au développeur de l'agent en envoyant les informations dans la réponse InvokeAgent."

Bibliothèque d'écorcheur de mines

La bibliothèque Mineflayer est un outil puissant pour créer des agents Minecraft et automatiser des tâches dans le monde du jeu. Il fournit un ensemble de classes et de fonctions qui éliminent les détails de bas niveau, facilitant ainsi le développement de comportements et d'interactions complexes.

Avis de non-responsabilité

Ce projet est une preuve de concept et n'est pas destiné à une utilisation en production. Il est fourni à titre d'exemple sur la manière de créer des agents de contrôle des retours à l'aide du framework Agents for Amazon Bedrock et de la bibliothèque Mineflayer.

Sécurité

Voir CONTRIBUTION pour plus d'informations.

Licence

Cette bibliothèque est sous licence MIT-0. Voir le fichier LICENCE.