Webagent: 웹 비즈니스 에이전트를 조립하고 통제하는 Go 하네스
AI 에이전트의 실용성은 모델 성능만으로 결정되지 않는다. 실제 서비스에서는 검색·메모리·채널 같은 기능을 어떻게 조합하고, 도구 실행을 어디에서 통제하며, 운영 환경의 변화에 얼마나 쉽게 대응할 수 있는지가 중요하다.
Agent-net이 오픈소스로 공개한 Webagent는 웹사이트를 공개형 비즈니스 에이전트로 구축하기 위한 Go 기반 하네스다.1 새로운 AI 모델이라기보다 에이전트의 구성 요소와 실행 규칙을 관리하는 운영 틀에 가깝다.
하나의 Brain, 교체 가능한 슬롯
Webagent의 에이전트는 하나의 Brain과 교체 가능한 슬롯 집합으로 구성된다. 슬롯은 다음과 같이 구분된다.2
검색
메모리
가드레일
채널
시크릿
프리젠터
모델
액션
관측성
각 슬롯에는 버전이 관리되는 서비스 제공자 인터페이스(SPI), 제공자 레지스트리, 기본 제공자가 있다. 사업자는 선언형 사양에서 슬롯별 제공자를 하나씩 선택할 수 있으며, 코어를 포크하지 않고도 커스텀 제공자를 등록할 수 있다.2
이 구조의 핵심은 모델과 운영 기능을 분리하는 데 있다. 모델, 메모리, 고객 채널이나 관측성 도구를 바꾸더라도 에이전트 전체를 다시 설계할 필요가 없다. 특정 공급자에 구성을 고정하기보다 필요한 기능을 슬롯 단위로 교체할 수 있다.
기본 제공자는 검색 live, 메모리 session, 가드레일 basic, 채널 a2a, 시크릿 env, 프리젠터 text, 모델 echo, 액션 none, 관측성 none으로 설정된다.2 특히 기본 구성은 자격 증명 없이 실행할 수 있도록 echo 모델과 네트워크를 사용하지 않는 도구 구성을 사용한다. 이를 통해 외부 서비스에 연결하기 전에 구조와 실행 흐름부터 확인할 수 있다.
도구 실행은 프롬프트가 아니라 코드로 통제한다
Webagent에서는 액션 제공자 또는 호스트가 주입한 모든 도구가 실행 전에 action.Guard를 거친다. 가드레일 검사가 프롬프트 지시에만 의존하지 않고 코드 경로에서 강제된다는 점이 중요하다.2
정보를 답변하는 챗봇과 외부 시스템에서 주문·결제·변경 같은 행동을 수행하는 에이전트는 위험 수준이 다르다. 에이전트에 실제 행동 권한을 부여할수록 안전 정책은 모델이 해석하는 자연어 지시가 아니라 실행 계층에서 일관되게 적용돼야 한다. Webagent의 가드 구조는 이 원칙을 구현한다.
CLI로 구성부터 자격 증명까지 점검한다
Webagent의 CLI는 다음과 같은 운영 기능을 제공한다.2
사용 가능한 제공자 목록 확인
선언형 사양 검증
에이전트 실행
API 키 저장·조회·삭제
따라서 도입 검토 단계에서는 기본 구성으로 에이전트를 실행한 뒤, 필요한 슬롯을 하나씩 교체하며 사양과 가드레일 동작을 확인할 수 있다. 실제 서비스에 적용할 때는 필요한 제공자가 준비돼 있는지, 커스텀 제공자를 구현해야 하는지, 각 액션에 적절한 실행 통제가 적용되는지를 우선 점검해야 한다.
Webagent를 평가할 때 볼 기준
Webagent의 가치는 특정 모델의 성능보다 교체 가능성과 실행 통제에 있다. 도입 여부를 판단할 때는 다음 질문이 유용하다.
모델이나 메모리, 채널을 코어 수정 없이 교체할 수 있는가?
외부 도구 실행이 예외 없이 가드레일을 통과하는가?
선언형 사양을 배포 전에 검증할 수 있는가?
필요한 슬롯에 적합한 기본 제공자나 커스텀 제공자가 있는가?
자격 증명 없이 안전하게 초기 구조를 시험할 수 있는가?
Agent-net은 AI 에이전트가 서로를 발견하고 신뢰하며 결제할 수 있는 에이전트 간 마켓플레이스를 개발하고 있다. 이런 환경에서는 에이전트가 무엇을 말하는지만큼 어떤 기능을 사용하고 행동을 어떻게 통제하는지가 중요하다. Webagent는 그 기반을 모델이 아닌 구성과 실행 규칙의 문제로 다룬다.
요약: Webagent는 웹사이트를 공개형 비즈니스 에이전트로 구축하기 위한 Go 하네스다. 슬롯 기반 제공자 구조로 기능을 교체하고, 모든 도구 실행에 코드 수준의 가드레일을 적용함으로써 AI 에이전트의 운영 가능성과 통제력을 높인다.
1Agent-net Open Sources Webagent: A Go Harness That Turns Any Website into a Guarded AI Agent
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.