ACP 에이전트
ADHDev는 Agent Client Protocol (ACP) 어댑터의 광범위한 내장 인벤토리를 제공합니다.
WARNING
ACP 인벤토리는 광범위하지만, 모든 ACP 프로바이더는 호환성 문서에서 명시적으로 테스트되고 프로모션될 때까지 미검증으로 취급해야 합니다.
ACP란?
ACP는 구조화된 에이전트 프로토콜입니다. ADHDev 용어로, 에이전트가 터미널 세션보다 프로토콜 기반 채팅 프로세스처럼 동작할 때 사용하는 경로입니다.
이는 보통 ADHDev가 다음을 할 수 있다는 의미입니다:
- 에이전트 프로세스 실행
- 프롬프트를 구조화된 요청으로 전송
- 구조화된 응답을 대시보드로 스트리밍
- 프로바이더가 노출할 때 모델, 모드, 기타 설정 컨트롤 제공
ACP vs CLI
ACP 세션은 일반적으로 CLI 세션과 대조하여 이해하는 것이 가장 좋습니다:
| 표면 | ACP | CLI |
|---|---|---|
| 기본 렌더링 | 채팅 스타일 구조화 세션 | 터미널 우선 PTY 세션 |
| 가장 적합한 경우 | 프로토콜 네이티브 에이전트와 스키마 기반 컨트롤 | 셸 워크플로우, TUI, 원시 터미널 출력 |
| 일반적인 컨트롤 | 프로바이더가 노출할 때 모델/모드/설정 | 터미널 입력, 스크롤백, 세션-호스트 복구 |
| 복구 모델 | 프로세스/세션 수명 주기 | 호스팅 런타임과 세션-호스트 수명 주기 |
원시 터미널 동작을 원한다면 CLI 경로를 사용하세요. 구조화된 채팅 동작을 원한다면 ACP가 더 나은 선택인 경우가 많습니다.
대시보드에서 ACP 모습
ACP 세션은 터미널 패널이 아닌 채팅 스타일 대화로 대시보드에 나타납니다.
프로바이더에 따라 다음이 가능할 수 있습니다:
- 일반 채팅 입력에서 프롬프트 전송
- 구조화된 스트리밍 응답 읽기
- 대시보드에서 승인 처리
- 모델 또는 모드 전환
- 컨트롤 바를 통해 노출된 프로바이더별 설정 옵션 사용
ACP 세션 실행
ACP 프로바이더는 다른 세션 유형에 사용되는 동일한 머신/워크스페이스 시작 흐름에서 실행됩니다:
- 머신을 엽니다.
- 원하는 워크스페이스를 선택합니다.
- ACP 카테고리를 선택합니다.
- 프로바이더를 선택합니다.
- 대시보드로 세션을 실행합니다.
ACP 프로바이더가 나타나지 않으면 보통 선택한 머신에 사용 가능한 ACP 프로바이더가 설치되거나 구성되지 않았다는 의미입니다.
내장 ACP 인벤토리
ADHDev는 현재 35개의 내장 ACP 어댑터를 제공합니다. 인벤토리에서 더 잘 알려진 이름은 다음과 같습니다:
- Gemini CLI
- Codex
- Claude Agent
- Cursor
- Cline
- GitHub Copilot
- Goose
- Kimi CLI
- OpenCode
- Qwen Code
다시 말하지만, 내장 인벤토리는 포괄적인 지원을 의미하지 않습니다.
인증 및 주의사항
ACP 도구는 여전히 자체 인증과 업스트림 설정을 처리합니다.
일반적인 패턴:
- API 키는 여전히 업스트림 도구에 속합니다
- 인증 누락은 종종 실행 실패처럼 보입니다
- 일부 ACP 도구는 자체 도구에서 여전히 실험적으로 표시된 업스트림 기능에 의존합니다
- 프로바이더별 제어 깊이가 많이 다릅니다
이것이 ACP가 강력하지만 인벤토리 전체에서 고르지 않은 이유입니다.
ACP를 선호해야 할 때
ACP는 다음을 원할 때 적합합니다:
- 터미널 대신 구조화된 채팅 스타일 세션
- 대시보드에서 프로바이더가 노출하는 모델 및 모드 컨트롤
- ACP를 잘 지원하는 에이전트를 위한 더 깔끔한 프로토콜 표면
프로바이더가 더 터미널 네이티브라면 실제로 CLI 경로가 더 신뢰할 수 있을 수 있습니다.