Claude Managed Agents 완전 가이드 — 관리형 에이전트 인프라로 프로덕션 AI 에이전트 배포

SDK 업그레이드
pip install anthropic --upgrade

기본 Managed Agent 세션
import anthropic

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-opus-4-6",
    max_tokens=4096,
    system="당신은 코드 리뷰 에이전트입니다. PR을 분석하고 개선 사항을 제안합니다.",
    messages=[
        {"role": "user", "content": "이 Python 함수를 리뷰해줘: def add(a,b): return a+b"}
    ],
    tools=[
        {
            "name": "search_docs",
            "description": "공식 문서에서 관련 내용을 검색합니다",
            "input_schema": {
                "type": "object",
                "properties": {
                    "query": {"type": "string", "description": "검색 쿼리"}
                },
                "required": ["query"]
            }
        }
    ],
    extra_headers={
        "anthropic-beta": "managed-agents-2026-04-01"
    }
)

# 세션 ID 저장 — 이후 요청에서 재사용
session_id = response.session_id
print(response.content)

세션 이어서 사용하기
# 첫 번째 요청 — 세션 시작
response1 = client.beta.messages.create(
    model="claude-opus-4-6",
    max_tokens=2048,
    messages=[{"role": "user", "content": "Python 프로젝트 구조를 분석해줘"}],
    extra_headers={"anthropic-beta": "managed-agents-2026-04-01"}
)
session_id = response1.session_id

# 두 번째 요청 — 이전 대화를 messages에 넣지 않아도 됨
response2 = client.beta.messages.create(
    model="claude-opus-4-6",
    max_tokens=2048,
    messages=[{"role": "user", "content": "테스트 커버리지도 확인해줘"}],
    session_id=session_id,
    extra_headers={"anthropic-beta": "managed-agents-2026-04-01"}
)

SSE 스트리밍 처리
with client.beta.messages.stream(
    model="claude-opus-4-6",
    max_tokens=4096,
    messages=[{"role": "user", "content": "저장소 전체를 분석하고 리포트를 작성해줘"}],
    extra_headers={"anthropic-beta": "managed-agents-2026-04-01"}
) as stream:
    for event in stream:
        if event.type == "tool_use":
            print(f"[실행 중] {event.name}: {event.input}")
        elif event.type == "tool_result":
            print(f"[완료] {event.name}")
        elif event.type == "text":
            print(event.text, end="", flush=True)