Valyu 이해하기: AI-Native Search와 실험을 더 빠르게 하는 CLI 툴

Source: Dev.to

What is Valyu?

Valyu는 다음과 같은 최신 AI 워크로드를 위해 특별히 설계된 AI‑네이티브 검색 및 검색 플랫폼입니다:

• Retrieval‑Augmented Generation (RAG)
• AI 에이전트
• 연구 자동화
• 데이터 기반 LLM 애플리케이션

느슨하게 순위가 매겨진 링크를 반환하는 대신, Valyu는 AI 시스템이 보다 쉽게 활용하고 추론할 수 있도록 구조화되고 관련성 최적화된 결과에 중점을 둡니다.

High‑level capabilities

• 웹, 학술, 사유 및 구조화된 데이터에 대한 통합 접근
• LLM 컨텍스트 윈도우에 최적화된 결과
• 풍부한 메타데이터 및 콘텐츠 추출
• 분산된 검색 파이프라인을 대체하는 단일 API

핵심 아이디어는 간단합니다: AI 시스템이 정확하게 추론하려면 구조화되고, 필터링되며, 관련성을 고려한 검색 결과가 필요합니다.

왜 Valyu가 중요한가

오늘날 AI 시스템을 구축할 때, 개발자들은 종종 다음을 연결하는 데 많은 시간을 소비합니다:

• 웹 검색 API
• 스크래퍼
• 임베딩 파이프라인
• 랭킹 및 필터링 로직

Valyu는 AI를 위한 검색 추상화 레이어 역할을 함으로써 그 복잡성을 줄여줍니다. 인간이 브라우징하는 것이 아니라 하위 추론에 최적화되어, 특히 다음과 같은 경우에 유용합니다:

• RAG 파이프라인 구축
• 자율 에이전트 구동
• 반복 가능한 연구 작업 실행
• 최신 또는 외부 지식에 의존하는 AI 워크플로 실험

새로운 Valyu 사용자는 $10 무료 크레딧을 받으며, 이를 통해 실험하고 아이디어를 테스트하며, 프로덕션에 도입하기 전에 플랫폼이 어떻게 동작하는지 쉽게 이해할 수 있습니다.

Source: …

valyu-cli 빠른 실험

플랫폼을 아직 탐색 중일 때, 매 실험마다 코드를 작성하는 것은 느릴 수 있습니다. 이를 빠르게 하기 위해 비공식 명령줄 도구인 **valyu-cli**를 만들었습니다.

Note: 이 CLI는 공식 Valyu 제품이 아닙니다. 탐색, 테스트 및 로컬 워크플로 중 Valyu와의 상호작용을 단순화하기 위해 존재합니다.

설치

# 전역 설치 (npm 또는 yarn)
npm install -g valyu-cli
# 또는
yarn global add valyu-cli

# 설치 없이 실행
npx valyu-cli search "your query"

Requirements: Node.js 18+

인증

CLI는 환경 변수(권장) 또는 설정 파일에서 API 키를 읽습니다.

# 환경 변수
export VALYU_API_KEY="your-api-key"

또는 설정 파일을 생성합니다:

~/.valyu/config      # 또는 프로젝트 내 .valyu/config
apiKey=your-api-key

명령마다 키를 오버라이드할 수도 있습니다:

valyu -k "your-api-key" search "your query"

빠른 시작

# 검색
valyu search "machine learning transformers" --max 5

# URL에서 내용 추출 (요약 포함)
valyu contents https://example.com --summary

# DeepResearch 작업 생성 및 결과 대기
valyu deep-research create "AI safety research summary" --wait

더 고급 예시

맞춤 검색 (소스, 필터링, JSON 출력)

valyu search "transformer architecture improvements" \
  --type proprietary \
  --sources valyu/valyu-arxiv \
  --relevance 0.7 \
  --max 10 \
  --json --save search.json

커스텀 요약 프롬프트를 사용한 콘텐츠 추출

valyu contents https://example.com \
  --summary-prompt "Provide 5 key takeaways as bullet points." \
  --length medium

특정 모델 및 출력 형식을 지정한 DeepResearch

valyu deep-research create "AI safety research summary" \
  --model heavy \
  --format markdown,pdf \
  --wait

나중에 DeepResearch 작업 상태 확인

valyu deep-research status

모든 명령은 원시 JSON(--json)을 출력할 수 있어 셸 스크립트나 가벼운 파이프라인에서 유용합니다.

전역 플래그 (모든 명령에서 사용 가능)

CLI와 SDK를 언제 사용할까

• CLI – 빠르고 일회성 실험, 프로토타이핑, 전체 코드베이스 없이 스크립팅에 이상적입니다.
• SDKs – 프로덕션 수준 통합, 맞춤 파이프라인, 더 강력한 타입 안전성이나 성능이 필요할 때 권장됩니다.

마무리 생각

인프라 도구를 평가할 때 속도는 중요합니다. 명령을 실행하고, 출력물을 검토하고, 쿼리를 조정한 뒤 다시 실행할 수 있으면 플랫폼이 사용 사례에 맞는지 판단하기가 훨씬 쉬워집니다.

valyu-cli는 순전히 탐색 단계 지원을 위해 존재합니다. 프로덕션에서 Valyu를 도입하기로 결정한다면 공식 SDK가 구축할 올바른 위치입니다. 그때까지는 CLI가 간단하고 빠르게 유지됩니다.

즐거운 탐색 되세요!

명령줄 옵션

검색 플래그

• -t, --type
• -n, --max
• --sources / --exclude-sources
• --relevance
• --max-price
• --start-date / --end-date
• --length

콘텐츠 플래그

• --summary / --summary-prompt ""
• --effort
• --length
• --max-price (USD)

DeepResearch 플래그

• -m, --model
• --format markdown,pdf
• --wait
• --poll-interval

Valyu 소개

Valyu는 AI 생태계에서 실제 문제를 해결합니다: 브라우저가 아니라 추론 시스템을 위해 설계된 검색.
검색 품질이 애플리케이션에 중요하다면, 그 작동 방식을 이해하는 것이 가치 있습니다.

valyu-cli 도구는 탐색을 더 빠르게 할 수 있도록 만든 작고 비공식적인 추가 기능입니다. Valyu의 무료 크레딧과 결합하면, 문서를 읽는 데서 그치지 않고 실제로 아이디어를 테스트하는 장벽을 낮출 수 있습니다.

• Valyu 웹사이트:
• Valyu CLI 저장소: