amazon bedrock minecraft agent

Бета-версия — агент Amazon Bedrock Minecraft (TypeScript)

Примечание. Этот проект находится в стадии бета-тестирования, поэтому ожидайте, что будут обнаружены сбои и внесены улучшения! Мы выпустили этот код в ответ на огромный интерес к этому проекту. Благодарим вас и, пожалуйста, продолжайте присылать свои отзывы и предложения.

Этот проект представляет собой бот Minecraft, созданный с использованием платформы Agents for Amazon Bedrock, написанный на TypeScript. Он демонстрирует, как создать агент, который может взаимодействовать с миром Minecraft с помощью агентов контроля возврата.

Введение

Агент Amazon Bedrock Minecraft — это реализация агента на TypeScript, которую можно использовать для автоматизации задач и взаимодействий в мире Minecraft. Он использует библиотеку Mineflayer, которая обеспечивает высокоуровневый интерфейс для взаимодействия с игровым движком Minecraft.

Как видно

• Прямая трансляция для разработчиков AWS: https://www.youtube.com/live/sn5cUf022ek?si=aukSxnQRbliT5jjS&t=8656.

Установка и использование

Чтобы установить это решение в его текущем (бета-) состоянии, рекомендуется иметь некоторые знания:

• Амазонка
• AWS CloudFormation
• AWS Cloud Development Kit (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, запустите одиночную (локальную) игру и в игре используйте «Открыть в локальной сети» и установите порт 25565 .
• В папке agent_ts/ откройте терминал, установите необходимые пакеты узла npm install .
• Обновите конфигурацию, установив переменные среды, ИЛИ отредактировав agent_ts/.env ИЛИ отредактировав agent_ts/config.ts . Установите для agentId и agentAliasId значения, выводимые из стека агента CloudFormation.
• Запустите код TypeScript в agent_ts/ с помощью npm run start:dev
• Взаимодействуйте с Рокки в игре, используя игровой чат, нажав t . Попробуйте «привет», «иди ко мне» и «выкопай яму 2 на 2». Посмотрите вывод отладки в терминале, с которого вы работаете.

Установка и использование — облачный хостинг (ECS)

Этот репозиторий также содержит стек CDK, который развернет клиентский код агента в задаче (контейнере) в ECS. Вам следует рассматривать возможность использования этого только в том случае, если вы знакомы с технологией и используете сервер Minecraft. Внимательно просмотрите код и сделайте минимум примечаний:

• Риски безопасности: развернутый сервер Minecraft является общедоступным, и, поскольку сервер не проверяет имена пользователей, любой может присоединиться с любым именем пользователя, включая те, которые уже заняты другими игроками. Это может привести к выдаче себя за другое лицо и огорчению.
• Управление сервером: в настоящее время порт RCON недоступен на сервере, поэтому нет доступа администратора. Это будет решено в будущем.

Шаги по развертыванию:

• В папке cdk/ откройте терминал, установите необходимые пакеты узлов npm install .
• Разверните проект CDK из cdk/ используя контекстные переменные agentId и agentAliasId , например:

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

Использование:

• Запустите Майнкрафт v1.20.1.
• Выберите Multiplayer и выберите Add Server .
• Введите адрес Network LoadBalancer, развернутого CDK, используя порт :25565 .
• Взаимодействуйте с Рокки в игре, используя игровой чат, нажав t . Попробуйте «привет», «иди ко мне» и «выкопай яму 2 на 2». Посмотрите вывод отладки в терминале, с которого вы работаете.

Немного о технологии

Возвратный контроль

«Вместо того, чтобы отправлять информацию, которую ваш агент получил от пользователя, в функцию Lambda для выполнения, вы можете вместо этого вернуть управление разработчику агента, отправив информацию в ответе InvokeAgent».

Библиотека минных пожирателей

Библиотека Mineflayer — мощный инструмент для создания агентов Minecraft и автоматизации задач в игровом мире. Он предоставляет набор классов и функций, которые абстрагируют детали низкого уровня, упрощая разработку сложного поведения и взаимодействий.

Отказ от ответственности

Этот проект является подтверждением концепции и не предназначен для промышленного использования. Он представлен в качестве примера создания агентов контроля возврата с использованием платформы Agents for Amazon Bedrock и библиотеки Mineflayer.

Безопасность

См. ВКЛАД для получения дополнительной информации.

Лицензия

Эта библиотека лицензируется по лицензии MIT-0. См. файл ЛИЦЕНЗИИ.