모두가 AI 랍스터를 키우고 있다. 하지만 모두가 실행할 서버를 가지고 있는 것은 아니다.

Source: Dev.to

Agenvoy는 순수 Go 기반의 에이전시 백엔드입니다 — 프레임워크 오버헤드가 없고, 부풀어 오른 런타임도 없습니다. Raspberry Pi Zero 2W에서 단 512 MB RAM만으로 실행이 검증되었습니다.

다중 제공자 LLM 및 지능형 라우팅

Agenvoy는 GitHub Copilot, Claude, OpenAI, Gemini, Nvidia NIM, 그리고 모든 OpenAI‑호환 엔드포인트(Compat/Ollama)를 포함한 일곱 개의 AI 백엔드를 통합하여 단일 Agent 인터페이스 뒤에 배치합니다. 전용 플래너 LLM이 각 요청에 가장 적합한 제공자를 자동으로 선택하므로 모델을 수동으로 전환할 필요가 없습니다.

compat[{name}] 라는 이름의 인스턴스를 사용하면 여러 로컬 모델 엔드포인트가 동시에 존재할 수 있으며, 각각 독립적인 URL 및 자격 증명 구성을 가집니다.

Skill-Based Agentic Execution

Skills는 작업의 시스템 프롬프트와 도구 허용 목록을 정의하는 선언형 Markdown 파일(SKILL.md)입니다. 런타임 시, Selector LLM은 9개의 표준 스캔 경로에서 가장 일치하는 스킬을 선택하고, 작업이 완료될 때까지 최대 128회 반복되는 도구 호출 루프를 구동합니다. 반복 제한에 도달하면 엔진은 오류를 반환하는 대신 자동으로 요약을 트리거합니다. Skill 확장은 시작 시 SyncSkills를 통해 GitHub에서 자동으로 동기화됩니다.

25+ Built-in Tools Across Six Categories

The executor ships a comprehensive toolchain:

• Filesystem operations: read_file, write_file, patch_edit, glob_files, search_content
• Web access: search_web, fetch_page, download_page, fetch_google_rss
• Scheduling: add_task, add_cron, write_script
• Error memory: remember_error, search_errors, get_tool_error
• Math calculator
• Arbitrary HTTP requests

Every rm is redirected to .Trash and all writes use atomic tmp‑then‑rename to prevent partial file corruption.

JSON 기반 API 확장 아키텍처

외부 REST API는 extensions/apis/ 아래의 JSON 파일로 정의되며 API 어댑터를 통해 런타임에 로드됩니다 — Go 코드를 작성할 필요가 없습니다. 기본적으로 13개의 퍼블릭 도메인 API가 번들로 제공됩니다:

• 야후 파이낸스
• 코인게코
• 위키피디아
• 세계은행
• USGS 지진
• 노미나팀
• 오픈‑메테오
• 해커뉴스
• REST 국가
• TheMealDB
• IP‑API
• 환율

사용자 정의 엔드포인트도 동일한 스키마를 따르며, 재컴파일 없이 도구를 임의로 확장할 수 있게 합니다.

Discord Bot 모드와 작업 스케줄러

cmd/server는 지속적인 Discord 봇을 실행하여 직접 메시지와 슬래시 명령을 모두 처리하고, 채널별 세션 상태를 유지합니다. 통합된 스케줄러는 일회성 작업(+5m 또는 절대 타임스탬프 사용)과 반복적인 크론 작업(표준 5필드 표현식, go-scheduler에 의해 검증)을 지원합니다. 각 작업은 Discord 채널 ID와 연결되어 있어, 스크립트가 완료되면 플래너 에이전트가 stdout을 처리하고 결과를 원래 채널에 다시 게시합니다. schedule-task 스킬은 자연어 기반 타이밍 의도를 자동으로 스케줄러에 라우팅합니다.

Cross-Session Persistent Memory

각 턴이 끝날 때마다 에이전트는 구조화된 JSON 요약을 생성하고, 이를 필드 수준 중복 제거를 사용해 이전 세션 요약과 깊게 병합한 뒤 ~/.config/agenvoy/에 저장합니다. 이후 세션에서는 이 요약을 마지막 N개의 대화 턴과 함께 주입하여, 전체 히스토리를 다시 재생하지 않고도 에이전트가 결정, 제약 조건 및 결론을 기억할 수 있게 합니다. 도구‑실행 오류는 SHA‑256 키와 함께 지속되어 에이전트가 재시도하기 전에 과거의 근본 원인을 조회할 수 있습니다.

OS 키체인 자격 증명 관리

API 키는 일반 환경 변수 대신 OS‑네이티브 키체인(macOS Keychain, Linux Secret Service)에 저장됩니다. GitHub Copilot은 자동 토큰 갱신이 포함된 OAuth 디바이스 코드 흐름을 사용합니다. 인터랙티브 agenvoy add / agenvoy remove 명령은 6개 공급자 전반에 걸쳐 자격 증명을 관리하며, 가이드 선택을 위한 내장 모델 레지스트리를 제공합니다. 다중 레이어 경로 차단 목록은 SSH 키, 셸 설정, 클라우드 자격 증명(.aws, .gcloud, .docker), .env 파일 및 모든 파일·명령 도구에서 개인 키 형식에 대한 접근을 차단합니다.