ACP 에디터 통합

Hermes Agent는 ACP 서버로 실행할 수 있으며 ACP 호환 편집기는 Hermes와 stdio 및 렌더링을 통해 이야기합니다.

• 채팅 메시지
• 도구 활동
• 파일 diffs
• 터미널 명령
• 승인 절차
• 흐름 사고 / 응답 chunks

ACP는 독립 CLI 또는 메시징 봇 대신 편집자 고유 코딩 에이전트와 행동 할 때 좋은 적합입니다.

ACP 모드에서 어떤 Hermes 노출

Hermes는 편집기 워크플로우를 위해 설계된 선별된 hermes-acp 툴릿으로 실행됩니다. 다음을 포함합니다:

• 파일 도구: read_file, write_file, patch, search_files
• 끝 공구: terminal, process
• 웹/브라우저 도구
• Memory, todo, 세션 검색
• 주요 특징
• execute_code 및 delegate_task
• • 연혁

그것은 의도적으로 메시징 납품과 cronjob 관리와 같은 전형적인 편집기 UX에 적합하지 않는 것들을 제외.

설치하기

일반적으로 Hermes를 설치 한 다음 ACP를 추가하세요

pip install -e '.[acp]'

이것은 agent-client-protocol 의존성을 설치하고 활성화합니다

• hermes acp
• hermes-acp
• python -m acp_adapter

Zed 레지스트리 설치를 위해, Zed는 공식 ACP 레지스트리 입력을 통해 Hermes를 시작합니다. 해당 항목은 uvx 배포를 사용합니다

uvx --from 'hermes-agent[acp]==<version>' hermes-acp
``uv`는 레지스트리 설치 경로를 사용하기 전에 `PATH`에서 사용할 수 있습니다.

## ACP 서버 시작 \{#launching-the-acp-server}

다음은 ACP 모드에서 Hermes를 시작합니다

```bash
hermes acp
````bash
hermes-acp
````bash
python -m acp_adapter

Hermes는 ACP JSON-RPC 트래픽에 대해 stderr로 로그인합니다.

비동기적인 검사를 위해:

hermes acp --version
hermes acp --check

브라우저 도구 (옵션)

브라우저 도구 (browser_navigate, browser_click 등)는 위에 달려 있습니다 agent-browser npm 패키지와 Chromium, 파이썬의 일부가 아닌 바퀴. 설치:

hermes acp --setup-browser           # interactive (prompts before ~400 MB download)
hermes acp --setup-browser --yes     # accept the download non-interactively

독립 명령입니다. Zed 레지스트리의 단말 흐름 (hermes acp --setup)은 모델 선택 후의 후속 질문으로 브라우저 부츠 스트랩을 제공하므로 대부분의 사용자는 직접 --setup-browser을 실행할 필요가 없습니다.

그것은 무엇입니까:

• Node.js 22 LTS를 ~/.hermes/node/로 설치하면
• npm install -g agent-browser @askjo/camofox-browser 으로 그 접두사 (수도 필요 없음 — npm's --prefix 포인트에서 user-writable Hermes-managed Node)
• Playwright Chromium을 설치하거나 사용할 때 감지 된 시스템 크롬 / 크롬을 사용합니다

부트 스트랩은 idempotent - 다시 실행하는 것은 빠르고 건너뛰는 일이 이미 수행됩니다.

Editor 설정

VS 코드

ACP Client 확장을 설치합니다.

연결하기:

1. Activity Bar에서 ACP 클라이언트 패널을 엽니다.
2. SelectHermes Agent 내장 에이전트 목록에서.
3. 연결 및 시작 채팅.

Hermes를 수동으로 정의하려면 acp.agents의 VS Code 설정을 통해 추가하십시오

{
  "acp.agents": {
    "Hermes Agent": {
      "command": "hermes",
      "args": ["acp"]
    }
  }
}

사이트맵

Zed v0.221.x 및 newer는 공식 ACP Registry를 통해 외부 에이전트를 설치합니다.

1. 에이전트 패널을 엽니다.
2. ClickAdd Agent, 또는 zed: acp registry 명령어를 실행합니다.
3. ** 헤르메스 에이전트**.
4. 설치하고 새로운 Hermes 외부 시약 스레드를 시작합니다.

필수품:

• hermes model를 처음 접하시거나 ~/.hermes/.env / ...로 설정하십시오.
• uv를 설치하면 레지스트리 실행기는 uvx --from 'hermes-agent[acp]==<version>' hermes-acp를 실행할 수 있습니다.

레지스트리 항목 이전의 로컬 개발을 위해, Zed 설정에서 사용자 정의 에이전트 서버를 사용:

{
  "agent_servers": {
    "hermes-agent": {
      "type": "custom",
      "command": "hermes",
      "args": ["acp"]
    }
  }
}

제트볼트

ACP 호환 플러그인을 사용 하 여 포인트:

/path/to/hermes-agent/acp_registry

레지스트리

Hermes 공식 ACP Registry metadata의 소스 복사본은 다음과 같습니다

acp_registry/agent.json
acp_registry/icon.svg

업스트림 레지스트리 PR은 hermes-agent/ 디렉토리의 최상위 agentclientprotocol/registry에 해당 파일을 복사합니다.

레지스트리 항목은 uvx 배포를 사용하여 hermes-agent에 직접 점합니다. PyPI 방출:

uvx --from 'hermes-agent[acp]==<version>' hermes-acp

레지스트리 CI는 PyPI에 핀 버전이 존재한다는 것을 증명합니다, 그래서 현명한 version와 uvx package 핀은 항상 pyproject.toml와 일치해야 합니다. scripts/release.py는 lockstep에서 자동으로 유지한다.

구성 및 자격

ACP 모드는 CLI와 같은 헤르메스 구성을 사용합니다

• ~/.hermes/.env
• ~/.hermes/config.yaml
• ~/.hermes/skills/
• ~/.hermes/state.db

제공자 결정은 Hermes의 일반 런타임 resolver를 사용하므로, ACP는 현재 설정된 제공자와 credential을 그대로 상속합니다. 또한 Hermes는 최초 실행 registry client를 위해 터미널 인증 방식(--setup)을 노출합니다. 이 방식은 Hermes의 대화형 모델/제공자 설정 흐름을 엽니다.

세션 행동

ACP 세션은 서버가 실행되는 동안 ACP 어댑터의 메모리 세션 관리자에 의해 추적됩니다.

각 세션 스토어:

• 세션 ID
• 작업 디렉토리
• 선택된 모델
• 현재 대화 역사
• 공지사항

밑으로 AIAgent는 여전히 헤르메스의 정상적인 지속 / 로깅 경로를 사용하지만 ACP list/load/resume/fork는 현재 ACP 서버 프로세스를 실행하는 범위입니다.

작업 디렉토리 행동

ACP 세션은 Hermes 작업 ID에 대한 편집기의 cwd를 바인딩하여 파일 및 터미널 도구는 편집기 작업 공간과 상대를 실행하며 서버 프로세스가 cwd가 아닌 서버 프로세스입니다.

승인

위험한 터미널 명령은 편집기의 승인 프롬프트로 다시 보낼 수 있습니다. ACP 승인 옵션은 CLI 흐름보다 단순합니다.

• 한 번 허용
• 항상 허용
• 거부

timeout이나 오류가 발생하면 승인 브리지는 요청을 거부합니다.

문제 해결

ACP 에이전트는 편집기에서 나타나지 않습니다

체크인:

• Zed에서 zed: acp registry로 ACP Registry를 열고 Hermes Agent를 검색합니다.
• 수동/현지 개발을 위해 agent_servers 명령어를 hermes acp에 확인합니다.
• 헤르메스는 설치 및 PATH에.
• ACP는 설치됩니다 (pip install -e '.[acp]').
• uv는 공식 Zed 레지스트리 항목에서 시작하면 설치됩니다.

ACP 시작하지만 즉시 오류

이 체크를 시도:

hermes acp --version
hermes acp --check
hermes doctor
hermes status

연락처

ACP 모드는 Hermes의 기존 제공 업체 설정을 사용합니다. credentials 구성:

hermes model

또는 편집 ~/.hermes/.env. 레지스트리 클라이언트는 또한 헤르메스 터미널 auth 흐름을 트리거 할 수 있습니다, 이는 동일한 상호 작용하는 공급자 / 모델 설정 실행.

Zed 레지스트리 실행기는 uv를 찾을 수 없습니다

uv 를 공식 uv 설치 docs 에서 설치한 다음 Zed의 Hermes Agent 스레드를 재개합니다.

더 보기

• ACP 내부
• Provider Runtime Resolution
• 도구 실행 시간