agentclientprotocol/python-sdk

해결하는 문제

이 프로젝트는 Agent Client Protocol (ACP)용 Python SDK를 제공하여 개발자가 표준화된 프로토콜을 사용해 통신할 수 있는 에이전트와 클라이언트를 구축할 수 있도록 합니다. 개발자가 수동으로 트랜스포트 계층, 스키마 검증, 이벤트 스트림 사용성 등을 구현할 필요가 없으며, 이는 일반적으로 다양한 AI 에이전트 프레임워크 간에 분산되어 있습니다.

작동 방식

SDK는 최신 ACP 스키마에 따라 유효한 페이로드를 보장하는 생성된 Pydantic 모델을 제공합니다. asyncio 트랜스포트와 stdio JSON-RPC 플러밍을 사용하여 에이전트와 클라이언트 간의 통신을 처리합니다. 또한 사용자 정의 에이전트를 생성하기 위해 필요한 부가 코드를 줄이기 위한 기본 클래스와 라이프사이클 헬퍼도 포함되어 있습니다.

대상 사용자

• 에이전트 작성자: 타입 지정된 모델과 이벤트 스트림 지원을 갖춘 ACP 호환 어시스턴트를 만들고 싶은 사람.
• 클라이언트 통합자: Python 애플리케이션에 ACP 에이전트를 내장하거나 stdio를 통해 기존 CLI를 래핑하고 싶은 사람.
• 도구 팀: 권한 흐름, 스트리밍 UX, 또는 Gemini 브리지에 대한 실험을 진행하는 사람.

주요 특징

• 사양 일치: 상류 ACP 스키마에서 자동으로 생성된 Pydantic 모델을 통해 일관성을 유지합니다.
• asyncio 지원: 효율적인 통신을 위한 내장된 비동기 기본 클래스와 JSON-RPC 플러밍.
• 즉시 사용 가능한 예제: 스트리밍, 권한, Gemini 브리지에 대한 데모 포함.
• 기여용 유틸리티: 세션 누적기와 도구 호출 추적기 제공으로 실제 배포를 간소화합니다.