dapr/dapr-agents

Build autonomous, resilient and observable AI agents with built-in workflow orchestration, security, statefulness and telemetry.

Dapr Agents – 프로덕션 수준의 AI 에이전트 시스템을 구축하기 위한 프레임워크

무엇인가요 – Dapr Agents는 오픈소스 Python SDK(및 관련 런타임)로, 대규모 언어 모델(LLM)을 사용해 추론, 행동, 협업하는 에이전트 기반 애플리케이션을 작성할 수 있게 해줍니다. Dapr의 검증된 구성 요소(확장성, 회복성, 관측성)에 의존함으로써 신뢰할 수 있는 분산 AI 에이전트 개발이 가능합니다.

왜 중요한가요 – 신뢰성 있는 분산 AI 에이전트를 구축하는 것은 어렵습니다: 상태 지속성, 재시도, 서비스 발견, 보안 통신, 다양한 데이터 소스와의 통합이 필요합니다. Dapr Agents는 이러한 복잡성을 숨깁니다. 각 에이전트는 Dapr의 액터(경량 상태 유지 컴퓨팅 단위)로 실행되며, Dapr의 내구성 있는 실행 엔진을 사용해 다단계 워크플로우를 오케스트레이션하므로, 크래시나 네트워크 장애 후에도 중단된 지점에서 계속 실행됩니다.

핵심 기능 (README에 설명됨)

기능	제공되는 기능
확장성 및 효율성	수천 개의 에이전트가 단일 CPU 코어를 공유 가능; Dapr이 클러스터 전체에 작업을 자동으로 분배합니다.
워크플로우 회복성	에이전트 작업의 모든 단계에 대해 자동 재시도 및 상태 복구가 가능합니다.
Kubernetes 네이티브	에이전트를 일반적인 Dapr 지원 서비스로 배포; 사이드카가 네트워킹, 시크릿, 스케일링을 처리합니다.
데이터 기반	50개 이상의 엔터프라이즈 데이터 소스(예: PDF, 데이터베이스, 메시지 큐)에 즉시 접근 가능한 내장 바인딩 및 상태 저장소 제공.
다중 에이전트 협업	보안적이고 관측 가능한 서비스 간 호출 및 Pub/Sub을 통해 에이전트 간 또는 외부 서비스와 소통 가능.
벤더 중립성	어떤 클라우드 또는 온프레미스 환경에서도 작동; 여러 LLM 제공업체를 지원합니다.
AI 전용 헬퍼	구조화된 출력, 도구 선택, 문맥 메모리, 유연한 프롬프팅, 설정 없이 MCPServer 도구 자동 탐지.
보안 및 신뢰성	mTLS 암호화, Dapr 회복성 정책(타임아웃, 재시도, 회로 차단기), 세밀한 접근 제어 범위.

일반적인 에이전트 예시 (README의 Python 코드)

from dapr_agents import DurableAgent

agent = DurableAgent(
    name="my-agent",
    role="다중 도구 어시스턴트",
    runtime=workflow_runtime,
)  # MCPServer 도구는 자동 탐지 – 추가 설정 필요 없음

에이전트가 시작되면 Dapr Agents는 로컬 Dapr 사이드카에서 로드된 MCPServer 리소스를 쿼리하고, 도구 정의를 가져와 워크플로우 단계로 등록합니다. 개발자는 비즈니스 로직만 작성하면 되며, 프레임워크가 도구 탐지, 상태 관리, 재시도를 처리합니다.

시작하기 (빠른 시작 체크리스트)

사전 요구 사항 설치 – Dapr CLI, Python ≥ 3.11, 그리고 uv 패키지 매니저.
Dapr 초기화 – dapr init으로 로컬에 사이드카 설정.
SDK 추가 – uv add dapr-agents (또는 pip install dapr-agents).
빠른 시작 실행 – 리포지토리는 단계별 튜토리얼을 제공하며, 간단한 에이전트 생성, 데이터 소스 연결, 확장 방법을 보여줍니다.
예제 탐색 – MCPServer 자동 탐지 포함 더 완전한 데모는 examples/ 폴더에 있습니다.

누구에게 적합한가요

플랫폼 팀 – Kubernetes 또는 온프레미스 클러스터에서 AI 에이전트를 대규모로 실행할 표준적인 방법이 필요한 경우.
개발자 – 다중 에이전트 워크플로우, 검색 기반 증강 생성 파이프라인, 여러 호출에 걸쳐 문맥을 유지해야 하는 자율 어시스턴트를 개발하는 경우.
기업 – 벤더 종속성을 피하고 AI 로직을 자체 보안 및 모니터링 스택 뒤에 유지하고 싶은 경우.

커뮤니티 및 기여

CNCF 프로젝트 – 클라우드 네이티브 컴퓨팅 재단(CNCF) 아래에서 운영.
Discord & YouTube – 도움과 공지사항을 위한 활발한 채널.
기여 방법 – 리포지토리의 코드 오브 콘덕트를 따르고, 개발에는 uv를 사용하며, 테스트 스위트를 실행(uv run pytest).
로드맵 – Python 지원은 2025년 Q4 안정 릴리스 예정; 다른 언어 바인딩도 계획 중.

TL;DR

Dapr Agents는 확장성, 장애 회복, 데이터베이스 및 다른 에이전트와의 통신, 보안 유지를 갖춘 프로덕션 수준의 AI 에이전트 개발 플랫폼을 제공합니다. 분산 시스템의 인프라(플러밍)에 신경 쓰지 않고, LLM 기반 로직에만 집중할 수 있습니다.