amazon bedrock minecraft agent

Beta - Agente Amazon Bedrock Minecraft (TypeScript)

Nota: Este projeto está em beta, então espere que falhas sejam encontradas e melhorias sejam feitas! Lançamos este código agora em resposta ao enorme interesse neste projeto. Obrigado e continue enviando seus comentários e sugestões.

Este projeto é um bot do Minecraft construído usando a estrutura Agents for Amazon Bedrock, escrita em TypeScript. Ele demonstra como criar um agente que pode interagir com o mundo do Minecraft usando os Agentes de Controle de Retorno.

Introdução

O Amazon Bedrock Minecraft Agent é uma implementação TypeScript de um agente que pode ser usado para automatizar tarefas e interações no mundo do Minecraft. Ele aproveita a biblioteca Mineflayer, que fornece uma interface de alto nível para interagir com o mecanismo de jogo Minecraft.

Como visto em

• Transmissão ao vivo para desenvolvedores da AWS: https://www.youtube.com/live/sn5cUf022ek?si=aukSxnQRbliT5jjS&t=8656

Instalação e uso

Para instalar esta solução em seu estado atual (beta), é recomendável que você tenha algum conhecimento sobre:

• Base Amazônica
• AWS CloudFormation
• AWS Cloud Development Kit (CDK) – se estiver hospedando no ECS.

Além disso, você precisará de um cliente Minecraft, com versão 1.20.1 , e de uma conta para jogar.

Etapas para implantar:

• Trabalhando em us-west-2 (Oregon)
• Na página do console Amazon Bedrock, habilite o acesso aos modelos Claude 3 Haiku e Sonnet.
• Usando o AWS CloudFormation, implante o modelo agent_cfn/amazon-bedrock-minecraft-agent-roc.yaml em uma pilha.
• Observe as saídas da pilha implementada agentId e agentAliasId .

Usar o agente é desenvolvimento e teste local:

Uso:

• Inicie o Minecraft v1.20.1, inicie um jogo para um único jogador (local) e no jogo, use "Open to LAN" e defina a porta para 25565 .
• Na pasta agent_ts/ , abra um terminal, instale os pacotes de nós conforme necessário npm install .
• Atualize a configuração definindo variáveis ​​de ambiente OU editando agent_ts/.env OU editando agent_ts/config.ts . Defina agentId e agentAliasId como valores de saída da pilha do agente CloudFormation.
• Execute o código TypeScript em agent_ts/ com npm run start:dev
• Interaja com Rocky no jogo usando o chat do jogo, pressionando t . Experimente “olá”, “venha até mim” e “cavar um buraco 2 por 2”. Observe a saída de depuração no terminal a partir do qual você está executando.

Instalação e uso - hospedado em nuvem (ECS)

Este repositório também contém uma pilha CDK que implantará o código do cliente do agente em uma tarefa (contêiner) no ECS. Você só deve considerar usar isso se estiver familiarizado com a tecnologia e executando um servidor Minecraft. Revise o código cuidadosamente e com uma nota mínima:

• Riscos de segurança: O servidor Minecraft implantado é acessível publicamente e, como o servidor não verifica nomes de usuário, qualquer pessoa pode entrar com qualquer nome de usuário, incluindo aqueles que já estejam em uso por outros jogadores. Isso pode levar à personificação e ao luto.
• Controle de Servidor: Atualmente a porta RCON não está disponível no servidor, portanto não há acesso de administrador. Isto será abordado no futuro.

Etapas para implantar:

• Na pasta cdk/ , abra um terminal, instale os pacotes do nó conforme necessário npm install .
• Implante o projeto CDK de cdk/ usando variáveis ​​de contexto agentId e agentAliasId , por exemplo:

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

Uso:

• Inicie o Minecraft v1.20.1.
• Selecione Multiplayer e selecione Add Server .
• Insira o endereço do Network LoadBalancer que foi implementado pelo CDK, usando a porta :25565 .
• Interaja com Rocky no jogo usando o chat do jogo, pressionando t . Experimente “olá”, “venha até mim” e “cavar um buraco 2 por 2”. Observe a saída de depuração no terminal a partir do qual você está executando.

Um pouco sobre a tecnologia

Controle de retorno

“Em vez de enviar as informações que seu agente obteve do usuário para uma função Lambda para cumprimento, você pode optar por devolver o controle ao desenvolvedor do agente, enviando as informações na resposta do InvokeAgent.”

Biblioteca Mineflayer

A biblioteca Mineflayer é uma ferramenta poderosa para construir agentes do Minecraft e automatizar tarefas no mundo do jogo. Ele fornece um conjunto de classes e funções que abstraem detalhes de baixo nível, facilitando o desenvolvimento de comportamentos e interações complexas.

Isenções de responsabilidade

Este projeto é uma prova de conceito e não se destina ao uso em produção. Ele é fornecido como um exemplo de como criar agentes de controle de devolução usando a estrutura Agents for Amazon Bedrock e a biblioteca Mineflayer.

Segurança

Consulte CONTRIBUINDO para obter mais informações.

Licença

Esta biblioteca está licenciada sob a licença MIT-0. Veja o arquivo LICENÇA.