View a markdown version of this page

Amazon Bedrock Agents Classic 유지 관리 모드 - Amazon Bedrock
마이그레이션 계획기능 비교마이그레이션 절차자주 묻는 질문(FAQ)추가 리소스

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon Bedrock Agents Classic 유지 관리 모드

Amazon Bedrock Agents(2023년 11월 출시)는 이제 Amazon Bedrock Agents Classic이며 2026년 7월 30일부터 신규 고객이 더 이상 이용할 수 없습니다. Amazon Bedrock Agents Classic과 유사한 기능을 보려면 Amazon Bedrock AgentCore를 살펴보세요. Amazon Bedrock은 계속 사용할 수 있지만 Agents Classic 서비스는 유지 관리 모드에 있습니다.

이 가이드에서는 Amazon Bedrock Agents Classic 고객의 유지 관리 모드 마이그레이션 옵션에 대한 정보를 제공합니다.

참고

Amazon Bedrock은 계속 완벽하게 지원됩니다. 2026년 7월 30일부터 신규 고객은 Amazon Bedrock Agents Classic 서비스만 더 이상 이용할 수 없습니다. 기존 Amazon Bedrock 모델, 지식 기반 및 가드레일은 영향을 받지 않습니다.

마이그레이션 계획

Amazon Bedrock Agents Classic 워크로드를 Amazon Bedrock AgentCore로 마이그레이션하는 것이 좋습니다. AgentCore는 AI 에이전트를 구축, 연결 및 최적화하는 플랫폼입니다. AgentCore의 관리형 하네스는 개발자가 에이전트의 모델, 도구 및 지침을 선언할 수 있는 구성 기반 시작점을 제공합니다. AgentCore는 환경, 컴퓨팅, 메모리, 자격 증명 및 관찰성을 처리합니다.

AgentCore의 관리형 에이전트 하네스(권장)

AgentCore의 관리형 하네스는 빌더가 에이전트의 모델, 도구 및 지침을 선언할 수 있는 구성 기반 시작점을 제공합니다. AgentCore는 컴퓨팅, 환경, 메모리, 자격 증명 및 관찰성을 처리합니다. 하네스는 다음을 지원합니다.

  • 도구 연결이 내장된 관리형 오케스트레이션 루프

  • AgentCore 게이트웨이를 통해 MCP 도구로 표시되는 작업 그룹(REST APIs, Lambda 함수 또는 코드 수준 @tools)

  • 게이트웨이 기반 지식 기반 통합

  • return-of-control 및 human-in-the-loop 패턴을 위한 인라인 함수 도구

  • 샌드박스 코드 실행을 위한 코드 인터프리터

  • 구성 가능한 전략이 포함된 단기 및 장기 메모리

  • AgentCore 게이트웨이를 통한 가드레일 적용

  • 모든 에이전트 작업에 대한 지속적인 end-to-end 추적

  • 전체 에이전트 동작을 위한 시스템 프롬프트 구성

AgentCore의 코드 정의 에이전트

하네스의 선언적 모델 이외의 기능이 필요한 워크로드의 경우 고객은 AgentCore에 직접 코드 정의 에이전트를 배포할 수 있습니다. 이 경로는 다음을 지원합니다.

  • 특정 오케스트레이션 단계에서 프롬프트 재정의

  • 다중 에이전트 공동 작업 및 감독자 패턴

  • 사용자 지정 오케스트레이션 로직

  • 더 광범위한 OpenAI 호환 엔드포인트

  • 모든 프레임워크(Strands, LangChain, OpenAI Agents SDK, Claude Agent SDK 또는 사용자 지정)

코드 정의 에이전트는 여전히 AgentCore의 관리형 인프라의 이점을 활용하는 동시에 개발자에게 에이전트 루프에 대한 완전한 제어 권한을 제공합니다.

루프를 직접 소유할 특별한 이유가 없는 한(예: 마이그레이션할 기존 에이전트 코드베이스 또는 하네스가 아직 표현하지 않은 고급 오케스트레이션) 하네스를 사용합니다. 또한 AgentCore CLI를 사용하여 기존 Bedrock Agents Classic 구성을 두 경로의 시작점으로 가져올 수 있습니다.

기능 비교

Bedrock Agents Classic AgentCore 동등
관리형 오케스트레이션 루프 AgentCore 하네스를 통해 out-of-the-box 지원
OpenAPI/함수 스키마를 통해 정의된 작업 그룹 + 관리형 에이전트에서 호출되는 선택적 Lambda 실행기 AgentCore 게이트웨이를 통해 REST APIs 및 Lambda 함수 또는 코드 수준 @tools를 래핑하는 MCP 도구로 표시되는 도구입니다.
RAG에 대한 에이전트 구성에 Bedrock 지식 기반 직접 연결 AgentCore의 게이트웨이 기반 지식 기반 통합. 코드 수준 검색 도구를 통해 액세스할 수 있는 지식 기반입니다.
전처리, 오케스트레이션, 작업 그룹 호출, KB 쿼리 및 관측end-to-end로 보여주는 추적 UI 및 APIs AgentCore는 모든 에이전트 작업에 대한 지속적인 end-to-end 추적을 제공합니다.
특정 단계의 프롬프트 재정의 구성(사전 처리, 오케스트레이션, KB 응답 생성, 사후 처리) 하네스의 시스템 프롬프트(--system-prompt)는 전체 에이전트 동작을 다룹니다. 단계별 프롬프트 재정의(사전 처리, KB 응답 생성, 사후 처리)는 직접 복제되지 않습니다. 동등한 동작을 달성하려면 시스템 프롬프트를 명령 실행 및 자체 관리형 스크립트와 결합해야 합니다.
오케스트레이션 중 자동 사용자 재프롬프팅 및 파라미터 유도를 위한 기본 제공 AMAZON.UserInput 도구 하네스의 인라인 함수 도구. 에이전트가 도구를 호출하고, harness가 tool_use를 일시 중지하고 클라이언트 코드에 반환합니다.이 코드는 사용자 상호 작용을 처리하고 결과를 다시 보냅니다. return-of-control에 해당합니다. 자동 유도 대신 명시적 도구 정의가 필요합니다.
샌드박스 코드 실행을 위한 기본 제공 AMAZON.CodeInterpreter 작업 그룹 AgentCore 코드 인터프리터
에이전트의 세션 및 메모리 구성(유휴 TTL, 메모리 유형, 교차 세션 메모리) 단기 및 장기용 AgentCore 메모리(메모리 전략이 다름)
에이전트에 선언적으로 연결되고 오케스트레이션 중에 적용되는 가드레일 및 에이전트 정책 AgentCore 게이트웨이에 정책이 적용되는 Bedrock의 가드레일 구성
다중 에이전트 공동 작업 역할 및 라우팅(예: 감독자 에이전트 및 오케스트레이션 역할) 제한. 감독자 패턴은 에이전트를 MCP 도구(agent-as-tool)로 노출하여 가능합니다. 다중 에이전트 라우팅 모드는 현재 간단하지 않습니다. 전체 다중 에이전트 공동 작업에는 사용자 지정 프레임워크 코드가 필요합니다.
사용자 지정 오케스트레이터 AgentCore 런타임을 통해 지원됩니다(사용자 지정 오케스트레이션 코드를 직접 배포). 하네스를 통해 사용할 수 없습니다.
제어 반환(외부 입력에 대한 에이전트 일시 중지) 하네스의 인라인 함수 도구. 에이전트가 일시 중지되고 tool_use를 클라이언트에 반환합니다.

마이그레이션 절차

AgentCore 하네스로 마이그레이션하기 위한 사전 조건

  • Node.js 20+ 및 AgentCore CLI 또는 Python 3.10+ with boto3

  • AWS AgentCore 하네스를 사용할 수 있는 리전의 자격 증명입니다. 자세한 내용은 AgentCore에 지원되는 AWS 리전을 참조하세요.

  • 필요한 권한이 있는 IAM 실행 역할

  • (선택 사항) GitHub 웹 사이트의 AWS용 에이전트 툴킷은 마이그레이션을 통해 AI 에이전트를 안내하는 전문 기술을 제공합니다.

에이전트 툴킷으로 마이그레이션 AWS (권장)

GitHub 웹 사이트의 AWS용 에이전트 툴킷에는 AI 에이전트(또는 코딩 어시스턴트)를 마이그레이션 end-to-end로 안내하는 amazon-bedrock 기술이 포함되어 있습니다. 기존 Bedrock Agent를 검사하고, 마이그레이션 자격을 확인하고, 각 구성 요소를 이에 상응하는 AgentCore 하네스에 매핑합니다. 그런 다음 스킬은 AgentCore CLI를 구동하여 하네스를 스캐폴드하고 배포합니다. 소스 에이전트를 수정하지 않습니다.

스킬을 사용하려면:

  1. AWS용 에이전트 툴킷을 설치합니다. 에이전트 툴킷 설치 및 스킬 활성화에 대한 지침은 GitHub 웹 사이트의 에이전트 툴킷 for AWS README를 참조하세요.

  2. 에이전트의 amazon-bedrock 스킬을 활성화합니다.

  3. (선택 사항) 간소화된 AWS 액세스를 위해 AWS MCP 서버를 구성합니다. 스킬은 AWS CLI 및 boto3에서도 작동합니다.

  4. AgentCore CLI의 최신 버전을 설치합니다. 스킬은 AgentCore CLI를 사용하여 하네스를 스캐폴드하고 배포합니다.

  5. 에이전트에게 “Bedrock 에이전트를 AgentCore 하네스로 마이그레이션할 수 있도록 도와주세요”라는 메시지를 표시합니다. 스킬이 요청할 때 리전 및 프로필과 AWS 함께 에이전트 ID, 이름 또는 ARN을 제공합니다.

  6. 각 체크포인트에서 계정, 리전 및 소스 에이전트를 확인합니다. 스킬은 구성 요소 인벤토리, 자격 평가 및 문서화된 마이그레이션 계획을 제공합니다. 배포하기 전에 승인을 위해 일시 중지됩니다.

또한 스킬을 사용하여 마이그레이션을 수행하지 않고도 마이그레이션 질문에 답할 수 있습니다. 에이전트가 검증된 하네스 경로가 없는 기능을 사용하는 경우 스킬이 중지되고 대안을 제안합니다.

수동으로 마이그레이션

스킬 없이 마이그레이션하려는 경우 또는 에이전트가 스킬 기반 경로에 적합하지 않은 경우 다음 단계에 따라 AgentCore CLI를 사용하여 하네스를 빌드합니다. 최신 버전의 AgentCore CLI를 사용합니다.

1단계: 생성 및 구성

agentcore create --name my-research-agent

복제하려는 기존 Bedrock 에이전트가 있는 경우 해당 구성(모델, 작업 그룹, KBs, 프롬프트 재정의)을 검토하고 각각 해당 하네스 파라미터에 매핑합니다.

  • model — --model-id

  • action groups - 게이트웨이 도구

  • KBs - 게이트웨이 또는 검색 도구

  • prompt — --system-prompt

도구 추가:

agentcore add tool --harness my-research-agent \
  --type agentcore_browser --name browser
agentcore add tool --harness my-research-agent \
  --type agentcore_code_interpreter --name code-interpreter

게이트웨이를 통해 기존 작업 그룹을 연결하려면:

agentcore add tool --harness my-research-agent \
  --type agentcore_gateway --name my-gateway \
  --gateway-arn arn:aws:bedrock-agentcore:us-west-2:123456789012:gateway/my-gw

2단계: 모델 및 시스템 프롬프트 구성

agentcore add harness \
  --name my-research-agent \
  --model-id us.anthropic.claude-sonnet-4-6-20250514-v1:0 \
  --system-prompt "You are a research assistant." \
  --tools agentcore-browser,code-interpreter

3단계: 배포 및 호출

agentcore deploy
agentcore invoke --harness my-research-agent \
  --session-id "$(uuidgen)" \
  "Research tropical vacation options under $3k"

다시 배포하지 않고 호출 시 모델을 재정의합니다.

agentcore invoke --harness my-research-agent \
  --model-id us.anthropic.claude-opus-4-5-20251101-v1:0 \
  "Summarize this research paper"
Memory

기본적으로 활성화됩니다. 메모리 범위를 개별 사용자로 지정하려면를 전달합니다--actor-id.

agentcore invoke --harness my-research-agent \
  --session-id "$(uuidgen)" --actor-id alice \
  "What did we discuss about the Portugal trip?"

각 액터는 격리된 메모리를 가져옵니다. 장기 전략은 추출된 지식의 범위를 액터 ID별로 지정합니다.

자주 묻는 질문(FAQ)

영향

기존 에이전트의 작동이 중지되나요?

아니요. 기존 에이전트는 계속 정상적으로 작동합니다. 모든 APIs(UpdateAgent, GetAgent, ListAgents, DeleteAgent, PrepareAgent, InvokeAgent, 작업 그룹 APIs, 지식 기반 APIs, 별칭 APIs 등)는 모든 고객이 계속 사용할 수 있습니다. CreateAgent 및 InvokeInlineAgent만 이전에 사용하지 않은 계정으로 제한됩니다.

내 계정이 영향을 받는지 어떻게 알 수 있나요?

계정에 지난 12개월 동안 Bedrock Agents 활동이 있는 경우 허용 목록에 등록되고 영향을 받지 않습니다. 이는 계정당 적용됩니다. 계정이 여러 개 있는 경우 이전 Bedrock Agents 사용량이 있는 AWS 계정만 허용 목록에 포함됩니다. 이전에 사용하지 않은 계정은 CreateAgent 또는 InvokeInlineAgent를 호출할 때 AccessDeniedException(HTTP 403)을 수신합니다.

내 계정이 허용 목록에 없는 경우 어떤 오류가 표시되나요?

오류 코드: AccessDeniedException(HTTP 403)

메시지: "Bedrock 에이전트가 유지 관리 모드입니다. 새 에이전트 생성은 이전 서비스 사용이 없는 계정에서는 사용할 수 없습니다. 자세한 내용은 Amazon Bedrock Agents Classic 유지 관리 모드를 참조하세요.”

조치를 취해야 하나요?

즉시는 아닙니다. 기존 워크로드는 영향을 받지 않습니다. 그러나 Bedrock Agents Classic에 새로운 기능이 추가되지 않으므로 새 에이전트 개발 및 향후 마이그레이션을 위해 AgentCore를 평가하는 것이 좋습니다.

7월 30일 이후에 새 계정의 Bedrock Agents에 예외를 요청할 수 있나요?

아니요. 예외 프로세스는 없습니다.는 계정에 지난 12개월 동안 Bedrock Agents 활동이 있었는지 여부에 따라 허용 목록을 AWS 자동으로 결정합니다. 새 계정에 에이전트 기능이 필요한 경우 동등하고 확장된 기능을 제공하는 Amazon Bedrock AgentCore를 사용합니다.

이름이 "Bedrock Agents Classic"으로 바뀌면 어떻게 되나요?

이는 이름 지정 업데이트일 뿐입니다. 사용자는 아무 작업도 수행할 필요가 없습니다. 기존 API 네임스페이스(bedrock-agent), SDK 클라이언트, CloudFormation 리소스 유형 및 IAM 작업 접두사는 변경되지 않습니다.

CloudFormation, CDK 또는 Terraform 템플릿이 계속 작동하나요?

예. Bedrock Agents를 생성하거나 관리하는 기존 IaC 템플릿은 허용 목록에 있는 계정에서 계속 작동합니다. 이전 Bedrock Agents 사용 없이 계정에서 새 환경을 프로비저닝하는 경우 템플릿에서 Amazon Bedrock AgentCore 리소스를 대신 사용합니다.

Bedrock Agents Classic에서 새 모델 버전을 사용할 수 있나요?

아니요. Bedrock Agents Classic에서 사용할 수 있는 모델 카탈로그는 유지 관리 모드 발효일(2026년 7월 30일)을 기준으로 동결됩니다. 해당 날짜 이후에 출시된 새 모델은 AgentCore를 통해 사용할 수 있습니다. Amazon Bedrock 자체(모델 추론, 지식 기반, 가드레일)는 계속해서 새 모델을 받습니다. 이 제한은 Bedrock Agents Classic 오케스트레이션 계층에만 적용됩니다.

Bedrock Agents Classic에 대한 요금이 변경되나요?

Bedrock Agents Classic 자체에는 요금이 부과되지 않습니다. 이전과 마찬가지로 기본 모델 추론 및 관련 리소스(지식 기반, Lambda 호출 등)에 대해서만 비용을 계속 지불합니다.

마이그레이션

권장되는 마이그레이션 경로는 무엇입니까?

AgentCore가 권장되는 플랫폼입니다. 두 가지 경로를 사용할 수 있습니다.

  • AgentCore 하네스 - Bedrock Agents Classic과 유사한 구성 기반 환경입니다. 모델, 도구 및 지침을 선언합니다. AgentCore는 컴퓨팅, 메모리, 자격 증명 및 관찰성을 처리합니다. 이는 Bedrock Agents 관리형 경험과 가장 가까운 아날로그입니다.

  • AgentCore의 코드 정의 에이전트 - 고급 오케스트레이션, 다중 에이전트 공동 작업 또는 사용자 지정 로직이 필요한 워크로드용입니다. AgentCore의 관리형 인프라에 프레임워크(스트랜드, LangChain, OpenAI Agents SDK, Claude Agent SDK 또는 사용자 지정)를 배포합니다.

자동 마이그레이션 도구가 있나요?

예. Bedrock Agents Classic을 AgentCore 하네스로 직접 마이그레이션하는 방법을 안내하는 에이전트 스킬은 GitHub 웹 사이트의 AWS용 에이전트 툴킷에서 사용할 수 있습니다. 스킬은 AWS MCP 서버를 통해서도 사용할 수 있습니다. 스킬 설치 및 사용에 대한 지침은 GitHub 웹 사이트의 에이전트 툴킷 for AWS README를 참조하세요. "Help me migration my Bedrock Agent to AgentCore harness" 프롬프트로 시작합니다.

마이그레이션에는 시간이 얼마나 걸리나요?

간단한 에이전트(모델 + 작업 그룹 + 지식 기반)의 경우 CLI 가져오기 또는 하네스 설정은 몇 시간이 걸립니다. 기본 작업에는 생성된 코드를 검토하거나 AgentCore 게이트웨이 뒤에 작업 그룹을 재배포하는 작업이 포함됩니다. 사용자 지정 오케스트레이터 또는 다중 에이전트 공동 작업을 사용하는 복잡한 에이전트에는 더 중요한 코드 작업이 필요합니다.

마이그레이션 기한이 있나요?

마이그레이션 기한은 없습니다. Bedrock Agents Classic은 계획된 end-of-life 날짜 없이 유지 관리 모드에서 기존 고객이 계속 사용할 수 있습니다. 그러나 새로운 기능은 계획되어 있지 않으므로 지속적인 혁신을 활용하려면 AgentCore로 마이그레이션하는 것이 좋습니다.

Bedrock 지식 기반은 어떻게 되나요?

지식 기반은 계속 작동하며 유지 관리 모드의 영향을 받지 않습니다. AgentCore로 마이그레이션할 때 AgentCore 게이트웨이를 통해 연결합니다. 기본 지식 기반 리소스는 변경되지 않습니다.

Bedrock Guardrails는 어떤가요?

Bedrock 모델에 구성된 가드레일은 모델이 AgentCore를 통해 호출될 때 계속 적용됩니다. 에이전트 수준 가드레일 적용은 AgentCore 게이트웨이 정책을 통해 사용할 수 있습니다.

동일한 모델을 계속 사용할 수 있나요?

예. AgentCore는 전체 Bedrock 모델 카탈로그와 추가 공급자(OpenAI, Gemini 및 OpenAI 호환 엔드포인트)를 지원합니다. 재배포 없이 세션 중간에 모델 공급자 간에 전환할 수 있습니다.

다중 에이전트 협업은 어떤가요?

지원되는 프레임워크를 사용하여 AgentCore 런타임에서 다중 에이전트 패턴을 빌드할 수 있습니다. 관리형 하네스는 더 간단한 다중 agent-as-tool 에이전트 패턴을 지원합니다.

인라인 에이전트는 어떻게 되나요?

지난 12개월 동안 InvokeInlineAgent를 사용한 계정은 인라인 에이전트를 계속 사용할 수 있습니다. 새로운 개발을 위해 AgentCore 관리형 하네스는 추가 기능(메모리, 상태 저장 세션, 게이트웨이를 통한 도구 연결)과 함께 동등한 임시 에이전트 기능을 제공합니다. 인라인 에이전트에 대한 마이그레이션 지침이 곧 제공될 예정입니다.

어떤 리전에서 AgentCore를 사용할 수 있나요?

이러한 리전에서는 AgentCore를 사용할 수 있습니다. Bedrock Agents Classic 워크로드가 아직 AgentCore를 사용할 수 없는 리전에서 실행되는 경우 해당 리전에서 Bedrock Agents Classic을 계속 사용하는 동시에 지원되는 리전에서 AgentCore로 새 개발을 마이그레이션할 수 있습니다.

요금 및 지원

AgentCore 비용은 얼마인가요?

AgentCore는 기능(런타임, 메모리, 게이트웨이) 전반에 걸쳐 소비 기반 요금을 사용합니다. 별도의 하네스 오케스트레이션 요금은 없습니다. AgentCore의 하네스는 Bedrock Agents Classic의 내부 프롬프트보다 토큰 효율적이므로 고객은 비슷하거나 더 낮은 모델 추론 비용을 볼 수 있습니다. 자세한 내용은 AgentCore 요금을 참조하세요.

추가 리소스