콘텐츠로 이동

자율 에이전트 (Autonomous Agents)

Backend.AI GO에는 로컬 머신에서 완전히 격리된 환경으로 AI 에이전트를 실행할 수 있는 자율 에이전트 플랫폼이 포함되어 있습니다.

개발 빌드 전용 경로

/autonomous-agents 사이드바 목적지는 현재 개발 빌드에서만 등록됩니다. 프로덕션 데스크톱 빌드에서는 아직 이 경로가 노출되지 않지만, 이 문서는 예정된 표면과 프로바이더 모델을 설명합니다.

프로바이더

프로바이더 설명 플랫폼
Hermes 컨테이너 기반 에이전트 런타임 (Epic #2962) macOS, Linux, Windows
Claw (레거시) OpenClaw 어댑터 macOS, Linux

Hermes는 새로운 설정에 권장되는 프로바이더입니다. 컨테이너 내에서만 실행되므로 문제가 발생하더라도 호스트 시스템이 깨끗하게 유지됩니다.

런타임 지원 (데스크톱 vs 헤드리스)

Hermes는 데스크톱 앱과 독립형 헤드리스 서버에서 모두 사용할 수 있습니다. 헤드리스 모드에서 aigo-server는 Hermes 프로바이더를 등록하고, Hermes 자격 증명을 암호화된 헤드리스 credential backend에 저장하며, 프로바이더 이벤트를 SSE 이벤트 버스로 전달합니다. Hermes 게이트웨이를 시작하려면 여전히 동작하는 로컬 컨테이너 런타임과 Hermes 이미지 접근 권한이 필요합니다.

Claw는 레거시 프로바이더이며, 프로바이더 브리지가 데스크톱 런타임 배선에 묶여 있으므로 계속 데스크톱 전용입니다.

프로바이더 데스크톱 앱 헤드리스 서버
Hermes 지원 지원, 게이트웨이 시작에는 Docker 또는 Apple Container 필요
Claw (레거시) 지원 사용 불가 (데스크톱 전용)

WebUI가 헤드리스 서버에 연결되면 자율 에이전트 페이지는 Hermes를 등록된 프로바이더로 표시하고, Claw는 명확한 사유와 함께 사용 불가로 표시합니다. 이를 명시적으로 드러내는 두 가지 경로가 있습니다.

  • GET /api/v1/autonomous/availability는 프로바이더별 가용성 보고서를 반환합니다. 프로바이더는 실행 중인 프로세스에 등록되어 있을 때 available입니다. 헤드리스는 Hermes를 available: true로 보고하고, Claw는 unavailableReason과 함께 available: false로 유지합니다.
  • GET /api/v1/autonomous/providers는 등록된 프로바이더를 나열합니다. 헤드리스 서버에서는 Hermes를 포함하고 Claw를 제외합니다.

설치 또는 게이트웨이 시작 전에 GET /api/v1/autonomous/providers/hermes/environment를 사용하세요. Docker 또는 Apple Container가 없거나 접근할 수 없으면 Hermes는 등록 상태를 유지하지만 환경 보고서는 container_runtime_not_found 같은 issue를 반환합니다. 해당 issue가 해소되기 전까지 install과 gateway start는 실제 runtime 검증을 의미하지 않습니다.

사전 요구 사항

자율 에이전트를 사용하기 전에 지원되는 컨테이너 런타임이 필요합니다.

  • Docker Desktop (macOS, Windows, Linux) — 가장 일반적인 선택
  • Apple Container (macOS arm64 전용) — Apple의 Containerization 프레임워크를 사용하는 경량 대안

시작하기