🎯 AgentCore

에이전트를 프로덕션에 올리려면

만드는 것과 운영하는 것은 별개의 문제 — 로컬 3줄 코드 앞에 놓인 네 가지 갭

AgentCore = 통합 플랫폼

실행 · 연결 · 기억 · 통제 — 프로덕션 갭을 메우는 핵심 4축

프레임워크 자유

어떤 SDK로 만들었든 AgentCore에 배포 가능

5개 모듈 학습 지도

네 축의 정체성을 훑고, 상세는 전담 모듈에서

1. 1
   Runtime

   커스텀 에이전트 코드의 실행 환경 — MicroVM 세션 격리, 배포 파이프라인, 프로토콜(HTTP·MCP·A2A)과 운영을 전담 모듈에서 다룹니다.

2. 2
   Managed Harness

   코드 0줄 선언적 배포 — CreateHarness·InvokeHarness 2개 API, Per-invocation Override, Runtime과의 선택 기준을 전담 모듈에서 다룹니다.

3. 3
   Gateway

   도구 허브 — Target 유형별 구성, 빌트인 커넥터, Interceptor와 시맨틱 도구 검색, Inbound/Outbound 인증을 전담 모듈에서 다룹니다.

4. 4
   Memory

   STM/LTM 2계층 기억 — 추출 전략 4종의 동작, 네임스페이스, Strands 통합 코드를 전담 모듈에서 다룹니다.

Runtime

커스텀 에이전트 코드를 세션마다 격리된 MicroVM에서 실행하는 서버리스 환경

전용 MicroVM 격리

VM 수준 격리 + 서버리스 시작 속도

배포 방식 2가지

ZIP이냐 Container냐 — 의존성 복잡도로 결정

AgentCore CLI 배포 사이클

create → dev → deploy → invoke — 인프라 코드 0줄

에이전트 코드 — @app.entrypoint

배포 계약은 진입점 함수 하나 — 나머지는 평범한 에이전트 코드

핵심 포인트

BedrockAgentCoreApp

Runtime의 HTTP 서버 계약을 대신 구현 — 서버 코드 0줄

@app.entrypoint

사용자 요청이 라우팅되는 진입점 — 이 함수가 배포 계약

payload

호출 측이 보낸 JSON — invoke로 넘긴 프롬프트가 담김

반환값

JSON 직렬화 가능한 dict — 그대로 응답 본문이 됨

코드 (main.py)

from strands import Agent
from bedrock_agentcore import BedrockAgentCoreApp

app = BedrockAgentCoreApp()

# 배포 계약 — Runtime이 이 함수로 요청을 라우팅
@app.entrypoint
def my_agent(payload):
    agent = Agent(system_prompt="IT 헬프데스크 에이전트")
    result = agent(payload.get("prompt"))
    return {"result": result.message}

Managed Harness

코드 없이 선언 스펙만으로 에이전트를 만드는 관리형 배포 방식

Gateway

에이전트가 도구·에이전트·모델에 접근하는 단일 보안 진입점

Memory

단기(STM)와 장기(LTM) 2계층으로 에이전트의 기억을 관리형으로 제공

Identity & Policy

누가 에이전트를 호출하고, 에이전트가 무엇을 호출할 수 있는가 — 두 방향의 통제

인증 2방향

들어오는 호출은 authorizer가, 나가는 호출은 Credential Provider가 — 자격 증명은 방향별로 분리 관리

Outbound 주입 — @requires_access_token

토큰은 Token Vault가 관리 — 코드는 데코레이터 하나로 주입만

핵심 포인트

provider_name

사전 등록한 Credential Provider — OAuth 클라이언트 정보는 Vault에

auth_flow

M2M(머신 간) 또는 USER_FEDERATION(사용자 위임 3LO)

access_token 주입

데코레이터가 토큰을 받아 키워드 인자로 전달 — 코드에 시크릿 0

갱신 자동

만료·로테이션은 Identity 서비스가 처리 — 재배포 불필요

코드

from bedrock_agentcore.identity import requires_access_token

# 데코레이터가 Token Vault에서 토큰을 받아 주입
@requires_access_token(
    provider_name="github-provider",
    scopes=["repo", "read:user"],
    auth_flow="USER_FEDERATION",  # 사용자 위임 (3LO)
)
async def fetch_private_repos(*, access_token: str):
    # 주입된 토큰으로 인증 호출 — 시크릿 하드코딩 없음
    headers = {"Authorization": f"Bearer {access_token}"}
    ...

Cedar 정책

누가 어떤 도구를 사용할 수 있는지 — 프롬프트가 아니라 인프라 레벨에서 제어

핵심 포인트

permit / forbid

허용·거부 선언 — forbid가 permit보다 우선

principal · when

누가·어떤 조건에서 — when { context.input.필드 } 조건으로 제약

action · resource

action이 곧 도구(AgentCore::Action::"{Target}___{도구}"), resource는 Gateway ARN

LOG_ONLY / ENFORCE

Policy engine을 Gateway에 연결할 때의 모드 — 관찰만 또는 실제 차단

정책

// 허용 — restart_server 도구 호출 (action이 곧 Target___도구)
permit(
  principal,
  action == AgentCore::Action::"OpsTarget___restart_server",
  resource == AgentCore::Gateway::"<gateway-arn>"
);

// 차단 — delete_database 호출은 명시적으로 거부 (forbid 우선)
forbid(
  principal,
  action == AgentCore::Action::"OpsTarget___delete_database",
  resource == AgentCore::Gateway::"<gateway-arn>"
);

Guardrails 연동

AgentCore Policy에서 Bedrock Guardrails를 직접 부착