Akka.NET에 LLM Agent 객체 만들기 — Akka.io Agent SDK를 액터 모델로 이식하기

🌐 English version: Building LLM Agents in Akka.NET — Porting Akka.io's Agent SDK to the Actor Model

수집일: 2026-05-16

대상 독자: .NET + 액터 모델 + LLM 통합에 관심 있는 IT 개발자

발행 매체: Notion AI-DOC 하위 (Type B*)

연관 메모리 (새창 열기):

한 줄 요약

Akka.io(JVM)의 Agent 컴포넌트는 LLM 호출 + 세션 메모리 + 도구 호출을 하나로 묶은 1급 추상화다. Akka.NET은 이 추상화를 아직 공식 제공하지 않지만, ReceiveActor + Behaviors 전이 + 자식 액터 감독 + 외부 LLM 클라이언트 조합으로 같은 모양을 만들 수 있다 — 그 설계와 동작 샘플을 정리한다.

배경 — 왜 Akka.NET에는 Agent가 없는가

측면 Akka.io (JVM/Java SDK) Akka.NET
:--- :--- :---
액터 모델 ✅ 1973 Hewitt 이론 기반 동일 ✅ Akka.io를 .NET으로 포팅, 동일
Agent 컴포넌트 ✅ 1급 시민 (Akka SDK 2024+) ❌ 없음 — 직접 조립 필요
Workflow / Entity / View ✅ 어노테이션 + SDK 런타임 ❌ 라이브러리 수준 (Persistence·Streams 등 별도)
메모리 관리 Event Sourced Entity 내장 Akka.Persistence (등가)
Tool calling 통합 LLM 응답 → 자동 dispatch 직접 구현 (Newtonsoft + reflection)

Akka.io의 Agent SDK는 Akka Agents 플랫폼 메모에서 다뤘듯 Context Gathering → Reasoning → Action Taking → Progress Evaluation 4단계 라이프사이클을 하나의 추상 클래스로 감싼다. .NET 측에서는 이 모양을 액터 + Behavior 전이로 직접 구현해야 한다.

1. Akka.io Agent 한 줄 분석

공식 Hello World 튜토리얼 기준 최소 형태: