AI SDK 하네스 레이어에서 ACP 호환 하네스 사용하기

Vercel AI SDK 하네스 레이어가 @ai-sdk/harness-acp 패키지를 통해 Agent Client Protocol(ACP) 호환 하네스를 범용적으로 지원하기 시작했다. 이 메타 어댑터는 특정 런타임이 아닌 ACP 프로토콜 자체를 래핑하는 방식으로 동작해, 직접 어댑터가 없어도 ACP를 지원하는 모든 하네스를 AI SDK와 통합할 수 있다.

핵심 포인트

기존 어댑터들이 특정 런타임(예: Claude Code, Codex)을 직접 래핑하는 것과 달리, @ai-sdk/harness-acp는 ACP 프로토콜 계층을 래핑해 범용성을 확보했다.
createACP 함수로 어댑터를 생성할 때 하네스 식별자, 패키지 소스, 실행 설정, 환경변수 전달, 권한 모드 매핑, 인증 설정을 구성한다.
생성된 어댑터는 HarnessAgent와 동일하게 동작해 기존 코드와의 호환성을 유지한다.
문서는 직접 어댑터(@ai-sdk/harness-claude-code 등)가 있을 경우 그쪽을 우선 사용하도록 권장한다 — 더 긴밀한 통합(tighter integration)을 제공하기 때문이다.
AI SDK 하네스 레이어가 프로토콜로부터 의도적으로 분리(decoupled)된 설계라 ACP 프로토콜의 한계도 그대로 전달된다.

왜 읽나직접 어댑터가 없는 ACP 호환 하네스를 AI SDK와 연동하려는 개발자나, AI SDK의 다층 어댑터 아키텍처와 설계 철학을 이해하고 싶은 개발자에게 유용하다.

Vercel Blog 블로그

원문은 여기서 이어서 읽을 수 있어요

원문 읽기

읽음 (0)

·takedown 요청