amazon bedrock minecraft agent

베타 - Amazon Bedrock Minecraft 에이전트(TypeScript)

참고: 이 프로젝트는 베타 버전이므로 결함이 발견되고 개선될 것으로 예상됩니다! 우리는 이 프로젝트에 대한 엄청난 관심에 부응하여 이 코드를 공개했습니다. 감사드리며 계속해서 피드백과 제안을 보내주시기 바랍니다.

이 프로젝트는 TypeScript로 작성된 Agents for Amazon Bedrock 프레임워크를 사용하여 구축된 Minecraft 봇입니다. 반품 제어 에이전트를 사용하여 Minecraft 세계와 상호 작용할 수 있는 에이전트를 만드는 방법을 보여줍니다.

소개

Amazon Bedrock Minecraft 에이전트는 Minecraft 세계 내에서 작업과 상호 작용을 자동화하는 데 사용할 수 있는 에이전트의 TypeScript 구현입니다. 이는 Minecraft 게임 엔진과 상호 작용하기 위한 높은 수준의 인터페이스를 제공하는 Mineflayer 라이브러리를 활용합니다.

본 바와 같이

• AWS 개발자 라이브 스트림: https://www.youtube.com/live/sn5cUf022ek?si=aukSxnQRbliT5jjS&t=8656

설치 및 사용법

이 솔루션을 현재(베타) 상태로 설치하려면 다음 사항에 대한 지식이 있는 것이 좋습니다.

• 아마존 기반암
• AWS 클라우드포메이션
• AWS 클라우드 개발 키트(CDK) - ECS에서 호스팅하는 경우.

또한 플레이하려면 버전 1.20.1 의 Minecraft 클라이언트와 계정이 필요합니다.

배포 단계:

• 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 x 2 구멍 파기"를 시도해 보세요. 실행 중인 터미널에서 디버그 출력을 살펴보세요.

설치 및 사용 - 클라우드 호스팅(ECS)

이 리포지토리에는 에이전트 클라이언트 코드를 ECS 내의 작업(컨테이너)에 배포하는 CDK 스택도 포함되어 있습니다. 기술에 익숙하고 Minecraft 서버를 실행하는 경우에만 이 사용을 고려해야 합니다. 코드를 주의 깊게 검토하고 최소한의 메모를 남겨두십시오.

• 보안 위험: 배포된 Minecraft 서버는 공개적으로 액세스할 수 있으며 서버는 사용자 이름을 확인하지 않으므로 다른 플레이어가 이미 사용 중인 사용자 이름을 포함하여 누구나 모든 사용자 이름으로 참여할 수 있습니다. 이는 명의 도용과 슬픔으로 이어질 수 있습니다.
• 서버 제어: 현재 RCON 포트는 서버에서 사용할 수 없으므로 관리자 액세스가 없습니다. 이 문제는 앞으로 해결될 것입니다.

배포 단계:

• cdk/ 폴더에서 터미널을 열고 필요한 npm install 노드 패키지를 설치합니다.
• 컨텍스트 변수 agentId 및 agentAliasId 사용하여 cdk/ 에서 CDK 프로젝트를 배포합니다. 예:

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

용법:

• Minecraft v1.20.1을 실행하세요.
• Multiplayer 선택하고 Add Server 선택합니다.
• 포트 :25565 를 사용하여 CDK에서 배포한 Network LoadBalancer의 주소를 입력합니다.
• 게임 내 채팅을 사용하고 t 눌러 게임 내에서 Rocky와 상호 작용하세요. "안녕하세요", "나에게 오세요", "2 x 2 구멍 파기"를 시도해 보세요. 실행 중인 터미널에서 디버그 출력을 살펴보세요.

기술에 대해 조금

반품 통제

"에이전트가 사용자로부터 유도한 정보를 이행을 위해 Lambda 함수로 보내는 대신 InvokeAgent 응답의 정보를 보내 에이전트 개발자에게 제어권을 반환하도록 선택할 수 있습니다."

지뢰밭 도서관

Mineflayer 라이브러리는 Minecraft 에이전트를 구축하고 게임 세계 내에서 작업을 자동화하기 위한 강력한 도구입니다. 낮은 수준의 세부 정보를 추상화하는 일련의 클래스와 함수를 제공하므로 복잡한 동작과 상호 작용을 더 쉽게 개발할 수 있습니다.

면책조항

이 프로젝트는 개념 증명이며 프로덕션 용도로 사용되지 않습니다. 이는 Agents for Amazon Bedrock 프레임워크 및 Mineflayer 라이브러리를 사용하여 반품 제어 에이전트를 구축하는 방법의 예로 제공됩니다.

보안

자세한 내용은 기여를 참조하세요.

특허

이 라이브러리는 MIT-0 라이선스에 따라 라이선스가 부여됩니다. 라이센스 파일을 참조하십시오.