volcengine/SearchCLI

SearchCLI – Volcengine AI Search용 명령줄 인터페이스

무엇인가요 – SearchCLI는 Volcengine의 AI Search 서비스를 래핑한 CLI입니다. 개발자와 AI 에이전트 시스템이 데이터셋, 애플리케이션을 관리하고 터미널에서 검색, 추천, 채팅형 검색 작업을 수행할 수 있습니다.

누구를 위한가요 –

• 비즈니스 백엔드에 AI 기반 검색 또는 추천 기능을 통합해야 하는 엔지니어.
• 데이터를 수집하고 검색 앱을 설정하며 결과를 반복 가능하고 검토 가능한 방식으로 검증해야 하는 자율 에이전트를 개발하는 팀.
• 프로덕션에 변경 사항을 적용하기 전에 안전한 "드라이런" 워크플로를 원하는 운영자.

핵심 기능

영역	CLI 명령어 (접두사 vs)	기능
인증 및 상태 점검	vs auth, vs doctor	Volcengine 자격 증명 로드, 연결 상태 확인
LLM 통합	vs llm	관련성 판단 또는 쿼리 생성용 OpenAI 호환 LLM 등록
데이터셋 처리	vs dataset, vs data	파일 가져오기, 스키마 추론, 레코드 쓰기
애플리케이션 관리	vs app	검색 앱 생성, 데이터셋 연결
검색 / 추천 / 채팅	vs search run, vs recommend run, vs chat run	실시간 쿼리 실행, 순위 매겨진 결과 얻기, 대화형 검색 실행
튜닝	`vs search tune query-generate	plan
확장성	Viking skills (npx skills add …로 설치)	에이전트가 프로그래밍적으로 호출할 수 있는 재사용 가능한 명령어 세트 패키지

일반 사용자 워크플로우

1. 리포지토리 복제 후 bash ./scripts/install.sh 실행 (Node 20+ 및 git 필요).
2. Volcengine Access Key/Secret Key로 인증 (vs auth login 또는 환경 변수에서 가져오기).
3. (선택 사항) 관련성 판단용 LLM 등록 (vs llm login).
4. JSONL 데이터 파일을 가져오고, 서비스가 스키마를 추론하고, 데이터를 쓰며, 앱을 생성하고 데이터셋을 연결 – vs dataset … 및 vs app … 명령어 몇 개로 완료.
5. vs search run, vs recommend run, 또는 vs chat run을 실행하여 서비스를 확인하거나, 튜닝 명령어를 사용해 관련성 향상.

에이전트 중심 워크플로우

• CLI를 한 번 설치.
• 사전 패키지된 Viking skills 추가 (npx skills add …). 이들은 외부 AI 에이전트가 호출할 수 있는 함수로 동일한 명령어 그룹을 노출.
• 에이전트는 인증하고 스킬 패키지를 검증한 후, 자동화된 파이프라인에서 vs search tune … 또는 vs chat run …을 호출할 수 있으며, 안전을 위해 내장된 드라이런 및 확인 단계가 있음.

설치 및 사전 요구 사항

• Node.js 20+ 및 git.
• AI Search 권한이 있는 AK/SK를 가진 Volcengine 계정.
• (선택 사항) 관련성 판단용 OpenAI 호환 LLM 엔드포인트 접근 권한.

문서 및 커뮤니티

• 다국어 README 링크 (영어, 중국어, 일본어 등).
• 자세한 에이전트 빠른 시작 가이드 (docs/agent-quick-start.md).
• 실시간 지원을 위한 WeChat 사용자 그룹 (리포지토리에 QR 코드 포함).
• 표준 오픈소스 기여 파일 (CLA, 코드 오브 콘덕트, 보안 정책).

라이선스 – Apache‑2.0.

---

결론 – SearchCLI는 프로덕션 수준의 CLI 중심 도구로, Volcengine의 AI Search 플랫폼과 인간 운영자 및 자율 에이전트를 연결하며, 검색 가능, 추천 가능, 대화형 검색 기능을 제공하고 안전하며 스크립트 가능한 워크플로우를 갖추고 있습니다.