5. 자율 에이전트 (Autonomous Agents)¶

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

프로바이더¶

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

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

자율 에이전트 프로바이더는 데스크톱 앱에서만 사용할 수 있습니다. 각 프로바이더는 로컬 컨테이너 게이트웨이를 구동하고 네이티브 데스크톱 이벤트 브리지를 연결하는데, 독립형 헤드리스 서버는 이 둘 중 어느 것도 호스팅하지 않습니다.

프로바이더	데스크톱 앱	헤드리스 서버
Hermes	지원	사용 불가 (데스크톱 전용)
Claw (레거시)	지원	사용 불가 (데스크톱 전용)

WebUI가 헤드리스 서버에 연결되면 자율 에이전트 페이지는 동작할 수 없는 설정·실행 흐름을 노출하는 대신 각 프로바이더를 사용 불가 상태로 명확한 사유와 함께 표시합니다. 이를 명시적으로 드러내는 두 가지 경로가 있습니다.

GET /api/v1/autonomous/availability는 프로바이더별 가용성 보고서와 기능 수준의 빈 상태 사유를 반환합니다. 프로바이더는 실행 중인 프로세스에 등록되어 있을 때만 available이며, 헤드리스 서버는 데스크톱 전용 프로바이더를 등록하지 않으므로 각 항목은 available: false와 unavailableReason을 보고합니다.
GET /api/v1/autonomous/providers는 계속 등록된 프로바이더만 나열하므로 헤드리스 서버에서는 빈 배열을 반환하며, 이는 가용성 보고서와 일치합니다.

데스크톱 런타임이 필요 없는 향후 프로바이더는 헤드리스 서버에도 등록되어 자동으로 available: true를 보고하게 됩니다. 현재 프로바이더를 설정하고 운영하려면 데스크톱 앱을 실행하세요.

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

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