View a markdown version of this page

Amazon Bedrock AgentCore 사용에 사용할 수 있는 인터페이스 이해 - Amazon Bedrock AgentCore

Amazon Bedrock AgentCore 사용에 사용할 수 있는 인터페이스 이해

Amazon Bedrock AgentCore는 에이전트 코드를 개발하고 배포하기 위한 다양한 인터페이스를 지원합니다. 가장 간단한 방법은 AgentCore Python SDK를 사용하여 에이전트 코드를 생성하고 AgentCore CLI를 사용하여 에이전트를 배포하는 것입니다.

AgentCore CLI 및 AgentCore Python SDK는 AWS SDK가 제공하는 모든 AgentCore 작업을 지원하지 않습니다. 특정 AgentCore 작업을 지원하지 않는 경우 AWS SDK를 사용합니다.

AgentCore CLI

AgentCore CLI는 Amazon Bedrock AgentCore에서 에이전트를 생성, 구성, 배포 및 관리하기 위한 Node.js 명령줄 도구입니다. Node.js 20 이상이 필요합니다.

npm을 사용하여 AgentCore CLI를 전역적으로 설치합니다.

npm install -g @aws/agentcore

AgentCore CLI는 다음과 같은 키 명령을 제공합니다.

  • agentcore 생성: 선호하는 프레임워크 및 모델 공급자를 사용하여 새 에이전트 프로젝트 설정

  • agentcore 배포: AWS 인프라에 에이전트 배포

  • agentcore dev : 개발 및 테스트를 위해 로컬에서 에이전트 실행

  • agentcore 간접 호출: 테스트를 위해 배포된 에이전트 간접 호출

  • agentcore 상태: 배포된 에이전트의 상태 확인

구성은 프로젝트 agentcore/ 디렉터리의 JSON 파일을 통해 관리됩니다. 이러한 파일에는 agentcore.json 프로젝트 설정 및 AWS 배포 대상aws-targets.json에 대한가 포함됩니다.

후드 아래에서 AgentCore CLI는 @aws/agentcore-cdk 패키지의 AWS CDK 구문을 사용하여 AWS 리소스를 프로비저닝하고 관리합니다.

step-by-step 지침은 Amazon Bedrock AgentCore 시작하기를 참조하세요.

AgentCore Python SDK

AgentCore Python SDK는 에이전트 개발을 위한 Python 프리미티브와 다음에 대한 기본 지원을 제공합니다.

  • 런타임: 에이전트에 대한 Python 코드를 쉽게 작성할 수 있는 AWS SDK의 AgentCore 작업에 대한 경량 래퍼입니다.

  • 메모리: 대화 기록 및 에이전트 컨텍스트를 위한 영구 스토리지

  • 도구: 코드 해석 및 브라우저 자동화를 위한 기본 제공 클라이언트

  • 자격 증명: 보안 인증 및 액세스 관리

  • AgentCore 평가: 에이전트 성능을 측정하기 위한 자동 평가 도구

AgentCore Python SDK는 Strands 에이전트 및 LangGraph와 같은 여러 프레임워크를 지원합니다. 다른 AWS 서비스를 사용하는 경우 AgentCore Python AWS SDK 코드와 함께 SDK를 사용하여 해당 서비스를 에이전트에 통합해야 합니다.

Amazon Bedrock AgentCore MCP 서버

AgentCore 모델 컨텍스트 프로토콜(MCP) 서버를 사용하면 원하는 개발 환경에서 직접 AgentCore 호환 에이전트를 변환, 배포 및 테스트할 수 있습니다. 런타임 통합, 게이트웨이 연결 및 에이전트 수명 주기 관리를 기본적으로 지원하는 MCP 서버는 AgentCore 서비스의 로컬 개발에서 프로덕션 배포로의 이동을 간소화합니다.

MCP 서버는 Kiro, Cursor, Claude Code, Amazon Q CLI 등 널리 사용되는 MCP 클라이언트와 함께 작동하여 복잡한 에이전트 개발 워크플로를 자동화하는 대화형 명령을 제공합니다.

자세한 내용은 Amazon Bedrock AgentCore MCP Server: Vibe coding with your coding assistant를 참조하세요.

AWS SDK

AWS SDK를 사용하여 AgentCore Python SDK와 동일한 결과를 얻을 수 있을 뿐만 아니라 AgentCore Python SDK가 지원하지 않는 다른 작업도 수행할 수 있습니다. AWS Lambda 및 Amazon S3와 같은 다른 AWS 서비스와 상호 작용하려면 AWS SDK를 사용해야 합니다. Python을 코딩 언어로 사용하지 않는 경우에도 AWS SDK가 필요합니다.

에이전트를 구성하고 배포하려면 AgentCore 컨트롤 플레인 API를 사용합니다. 예를 들어 AgentCore 런타임을 생성하거나 AgentCore 메모리를 생성할 수 있습니다.

런타임 시 AgentCore 메모리에 메모리 이벤트를 추가하는 등의 작업에 AgentCore 데이터 영역 API를 사용합니다. AgentCore 에이전트를 호출하는 클라이언트 코드는 InvokeAgentRuntime 데이터 영역 작업을 사용하여 AgentCore 런타임에서 호스팅한 에이전트를 호출합니다.

Amazon Bedrock AgentCore 콘솔

AgentCore 콘솔을 사용하여 에이전트 코드에서 사용하는 AgentCore 서비스를 생성하고 관리할 수 있습니다. AgentCore 런타임에서 호스팅되는 에이전트를 호출하도록에 표시되는 코드 조각을 가져올 수 있습니다. 에이전트 샌드박스에서 에이전트를 테스트할 수도 있습니다. https://console.aws.amazon.com/bedrock-agentcore/home 콘솔을 엽니다.

AWS 명령줄 인터페이스

사용하는 AgentCore 서비스와 함께 AWS CLI를 사용할 수 있습니다. 컨트롤 플레인 API를 사용하여 서비스를 생성하고 관리합니다. 예를 들어 AgentCore 메모리를 생성하거나 AgentCore 런타임의 엔드포인트를 업데이트할 수 있습니다. 또한 에이전트를 테스트하는 데 유용할 수 있는 데이터 영역 API를 사용하여 런타임 작업을 수행할 수 있습니다.