amazon bedrock minecraft agent

Beta - Agente de Minecraft de Amazon Bedrock (TypeScript)

Nota: Este proyecto está en versión beta, así que espere que se encuentren fallos y se realicen mejoras. Hemos publicado este código ahora en respuesta a la gran cantidad de interés en este proyecto. Gracias y por favor continúe enviando sus comentarios y sugerencias.

Este proyecto es un bot de Minecraft creado utilizando el marco Agents for Amazon Bedrock, escrito en TypeScript. Demuestra cómo crear un agente que pueda interactuar con el mundo de Minecraft utilizando los agentes de control de retorno.

Introducción

El agente de Minecraft de Amazon Bedrock es una implementación TypeScript de un agente que se puede utilizar para automatizar tareas e interacciones dentro del mundo de Minecraft. Aprovecha la biblioteca Mineflayer, que proporciona una interfaz de alto nivel para interactuar con el motor del juego Minecraft.

Como se ve en

• Transmisión en vivo para desarrolladores de AWS: https://www.youtube.com/live/sn5cUf022ek?si=aukSxnQRbliT5jjS&t=8656

Instalación y uso

Para instalar esta solución en su estado actual (beta), se recomienda tener algunos conocimientos de:

• Roca Amazónica
• Formación en la nube de AWS
• Kit de desarrollo de nube de AWS (CDK): si se aloja en ECS.

Además necesitarás un cliente de Minecraft, con la versión 1.20.1 , y una cuenta para jugar.

Pasos para implementar:

• Trabajando en us-west-2 (Oregón)
• Desde la página de la consola Amazon Bedrock, habilite el acceso a los modelos Claude 3 Haiku y Sonnet.
• Con AWS CloudFormation, implemente la plantilla agent_cfn/amazon-bedrock-minecraft-agent-roc.yaml en una pila.
• Tenga en cuenta los resultados de la pila implementada agentId y agentAliasId .

El uso del agente es desarrollo y prueba local:

Uso:

• Inicie Minecraft v1.20.1, inicie un juego para un solo jugador (local) y, en el juego, use "Abrir en LAN" y configure el puerto en 25565 .
• Desde la carpeta agent_ts/ , abra una terminal, instale los paquetes de nodo según sea necesario npm install .
• Actualice la configuración, ya sea configurando variables de entorno O editando agent_ts/.env O editando agent_ts/config.ts . Establezca agentId y agentAliasId en los valores generados desde la pila de CloudFormation del agente.
• Ejecute el código TypeScript en agent_ts/ con npm run start:dev
• Interactúa con Rocky en el juego usando el chat del juego, presionando t . Prueba "hola", "ven a mí" y "cava un hoyo de 2 por 2". Mire la salida de depuración en la terminal desde la que está ejecutando.

Instalación y uso: alojado en la nube (ECS)

Este repositorio también contiene una pila CDK que implementará el código del cliente del agente en una tarea (contenedor) dentro de ECS. Sólo deberías considerar usar esto si estás familiarizado con la tecnología y ejecutas un servidor de Minecraft. Revise el código detenidamente y como mínimo:

• Riesgos de seguridad: el servidor de Minecraft implementado es de acceso público y, dado que el servidor no verifica los nombres de usuario, cualquiera puede unirse con cualquier nombre de usuario, incluidos los que ya tienen otros jugadores. Esto puede llevar a la suplantación y al duelo.
• Control del servidor: actualmente el puerto RCON no está disponible en el servidor, por lo que no hay acceso de administrador. Esto se abordará en el futuro.

Pasos para implementar:

• Desde la carpeta cdk/ , abra una terminal, instale los paquetes de nodo según sea necesario npm install .
• Implemente el proyecto CDK desde cdk/ usando las variables de contexto agentId y agentAliasId , por ejemplo:

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

Uso:

• Inicie Minecraft v1.20.1.
• Seleccione Multiplayer y seleccione Add Server .
• Ingrese la dirección del Network LoadBalancer que implementó CDK, usando el puerto :25565 .
• Interactúa con Rocky en el juego usando el chat del juego, presionando t . Prueba "hola", "ven a mí" y "cava un hoyo de 2 por 2". Mire la salida de depuración en la terminal desde la que está ejecutando.

Un poco sobre la tecnología

Control de devolución

"En lugar de enviar la información que su agente ha obtenido del usuario a una función Lambda para su cumplimiento, puede optar por devolver el control al desarrollador del agente enviando la información en la respuesta de InvokeAgent".

Biblioteca de cazadores de minas

La biblioteca Mineflayer es una herramienta poderosa para crear agentes de Minecraft y automatizar tareas dentro del mundo del juego. Proporciona un conjunto de clases y funciones que abstraen detalles de bajo nivel, lo que facilita el desarrollo de comportamientos e interacciones complejos.

Descargos de responsabilidad

Este proyecto es una prueba de concepto y no está diseñado para uso en producción. Se proporciona como un ejemplo de cómo crear agentes de control de devoluciones utilizando el marco de Agents for Amazon Bedrock y la biblioteca Mineflayer.

Seguridad

Consulte CONTRIBUCIÓN para obtener más información.

Licencia

Esta biblioteca tiene la licencia MIT-0. Ver el archivo de LICENCIA.