amazon bedrock minecraft agent

Beta - Amazon Bedrock Minecraft Agent (TypeScript)

注意：该项目处于测试阶段，因此预计会发现故障并进行改进！为了响应人们对该项目的巨大兴趣，我们现在发布了此代码。谢谢您，请继续发送您的反馈和建议。

该项目是一个使用 Agents for Amazon Bedrock 框架构建的 Minecraft 机器人，以 TypeScript 编写。它演示了如何创建一个可以使用返回控制代理与 Minecraft 世界交互的代理。

介绍

Amazon Bedrock Minecraft 代理是代理的 TypeScript 实现，可用于自动执行 Minecraft 世界中的任务和交互。它利用 Mineflayer 库，该库提供了与 Minecraft 游戏引擎交互的高级接口。

正如所见

• AWS 开发人员直播：https://www.youtube.com/live/sn5cUf022ek?si=aukSxnQRbliT5jjS&t=8656

安装与使用

要在当前（测试版）状态下安装此解决方案，建议您了解以下知识：

• 亚马逊基岩
• AWS 云形成
• AWS 云开发套件 (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 堆栈输出的值。
• 使用npm run start:dev运行agent_ts/中的 TypeScript 代码
• 使用游戏内聊天功能，按t与游戏中的 Rocky 互动。尝试说“你好”、“到我这里来”和“挖一个 2 × 2 的洞”。在您运行的终端中观察调试输出。

安装和使用-云托管（ECS）

此存储库还包含一个 CDK 堆栈，该堆栈将代理客户端代码部署到 ECS 内的任务（容器）。仅当您熟悉该技术并运行 Minecraft 服务器时才应考虑使用此选项。仔细检查代码并至少注意：

• 安全风险：部署的《我的世界》服务器是可公开访问的，并且由于服务器不验证用户名，因此任何人都可以使用任何用户名加入，包括已被其他玩家使用的用户名。这可能会导致冒充和悲伤。
• 服务器控制：当前 RCON 端口在服务器上不可用，因此没有管理员访问权限。这将在未来得到解决。

部署步骤：

• 从cdk/文件夹中，打开终端，根据需要安装节点包npm install 。
• 使用上下文变量agentId和agentAliasId从cdk/部署 CDK 项目，例如：

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

用法：

• 启动《我的世界》v1.20.1。
• 选择Multiplayer并选择Add Server 。
• 输入 CDK 部署的网络负载均衡器的地址，使用端口:25565 。
• 使用游戏内聊天功能，按t与游戏中的 Rocky 互动。尝试说“你好”、“到我这里来”和“挖一个 2 × 2 的洞”。在您运行的终端中观察调试输出。

关于技术的一些知识

返回控制

“您可以选择通过在 InvokeAgent 响应中发送信息，将控制权返回给代理开发人员，而不是将代理从用户处获取的信息发送到 Lambda 函数来实现。”

夺雷者图书馆

Mineflayer 库是一个强大的工具，用于在游戏世界中构建 Minecraft 代理和自动化任务。它提供了一组类和函数，可以抽象出低级细节，从而更容易开发复杂的行为和交互。

免责声明

该项目是一个概念验证，不适用于生产用途。它作为如何使用 Amazon Bedrock 框架代理和 Mineflayer 库构建退货控制代理的示例提供。

安全

请参阅贡献以获取更多信息。

执照

该库根据 MIT-0 许可证获得许可。请参阅许可证文件。