ACP 코딩 에이전트

Agent Client Protocol은 코딩 인터페이스를 코딩 에이전트에 연결합니다. 인터페이스는 편집기, 데스크톱 애플리케이션, CLI, 또는 다른 ADK-Rust 에이전트일 수 있습니다. 코딩 에이전트는 프로젝트를 추론하고 공유 세션을 통해 작업 결과를 보고하는 별도의 프로세스입니다.

ADK-Rust는 안정적인 ACP 프로토콜 버전 1의 양쪽을 모두 구현합니다:

외부 ACP 코딩 에이전트를 ADK-Rust 애플리케이션에서 사용하기;
편집기가 시작할 수 있는 ACP 프로세스로 ADK-Rust 에이전트를 노출하기.

구현은 공식 agent-client-protocol Rust SDK를 사용합니다. SDK 크레이트 버전과 ACP 와이어 버전은 서로 분리되어 있습니다: ADK-Rust는 현재 initialize 중에 프로토콜 버전 1을 협상하는 동안 SDK 1.2를 사용합니다.

이 섹션을 읽어보세요

아키텍처와 개념은 두 가지 역할과 전체 요청 흐름을 설명합니다.
ACP 클라이언트 또는 호스트 빌드는 단발 위임, 지속 세션, 스트리밍, 취소, 권한, 파일, 터미널, 그리고 세션 MCP 서버를 다룹니다.
ADK-Rust ACP 에이전트 노출는 서버 구성, 수명 주기 매핑, 이벤트 스트리밍, 세션 지속성, 그리고 배포를 다룹니다.
테스트 및 지원 매트릭스는 검증된 동작과 ADK-Rust가 의도적으로 광고하지 않는 기능을 나열합니다.

어떤 프로토콜을 사용해야 하나요?

경계	용도
ACP	프로젝트 세션 내에서 코딩 에이전트와 함께 작동하는 대화형 코딩 인터페이스
A2A	원격 작업과 아티팩트를 교환하는 독립적으로 배포된 비즈니스 에이전트
MCP	에이전트 뒤에서 사용할 수 있도록 제공되는 도구, 프롬프트, 리소스

ACP는 코딩 세션이 열릴 때 MCP 서버 구성을 전달할 수 있습니다. 그렇다고 해서 ACP과 MCP가 서로 호환된다는 뜻은 아닙니다: ACP는 코딩 에이전트 대화를 소유하고; MCP는 그 대화 중에 사용되는 도구와 리소스를 제공합니다.

예제

예시	증명하는 것
`examples/acp_client_host`	스트리밍 클라이언트 UI, 비동기 권한, 그리고 작업공간에 제한된 읽기 전용 파일 시스템
`examples/acp_kiro`	직접 위임, ACP 에이전트를 ADK 도구로, 영속 세션, 환경 구성, 그리고 동시 취소
`examples/acp_server`	편집기에 ACP v1을 통해 노출되는 도구를 사용하는 ADK-Rust LLM 에이전트
`examples/acp_full_protocol`	전체 Phase 2 서버 표면(embedded-resource + 이미지/오디오 프롬프트, 권한 브리지, `session/load` 재생, 사용량/도구 호출 업데이트)을 검증 테스트와 함께 수행하는, 프로세스 내의 API-키 없는 `Runner`-기반 참조 구현

이전: ← Benchmarking | 다음: Retry & Reflect →