a2aproject/a2a-js

해결하는 문제

AI 에이전트가 통신하고 상호 운용할 수 있는 표준화된 방법을 제공합니다. Agent2Agent (A2A) 프로토콜을 구현함으로써, 개발자는 기본 전송 방식에 관계없이 다양한 클라이언트에 의해 발견, 구동 및 관리될 수 있는 에이전트를 구축할 수 있습니다.

작동 원리

이 SDK를 통해 개발자는 A2A servers (기능을 노출하는 에이전트)와 A2A clients (해당 에이전트와 상호 작용하는 애플리케이션)를 생성할 수 있습니다. JSON-RPC, HTTP+JSON/REST, gRPC 등 세 가지 전송 방식을 지원하여 통신 계층을 추상화합니다.

서버 측에서는 AgentExecutor가 비즈니스 로직을 처리하고, DefaultRequestHandler가 라우팅, 작업 저장소 및 푸시 알림을 관리합니다. 클라이언트 측에서는 ClientFactory가 에이전트의 광고된 기능(「에이전트 카드」)을 기반으로 최적의 전송 방식을 자동으로 선택합니다.

대상 사용자

에이전트 애플리케이션을 구축 중이며, 에이전트 간 또는 클라이언트-에이전트 간 통신을 위한 일관된 프로토콜이 필요한 개발자(특히 TypeScript 또는 JavaScript 환경에서 작업하는 개발자).

주요 특징

• 멀티 전송 지원: JSON-RPC, REST, gRPC에 대한 네이티브 지원.
• 작업 수명 주기 관리: 작업 제출, 스트리밍 업데이트 및 사용자 시작 취소 기능 내장.
• 영구 저장소: PostgreSQL, MySQL, SQLite 및 Cloudflare D1을 지원하여 재시작 후에도 작업 및 알림 설정 유지.
• 푸시 알림: 지속적인 연결을 유지할 수 없는 장기 실행 작업을 위한 Webhook 기반 업데이트 제공.
• 하위 호환성: v1.0 배포가 v0.3 피어와 상호 운용될 수 있도록 하는 옵트인 계층 제공.