了解 Valyu：AI‑Native Search 与加速实验的 CLI 工具

Source: Dev.to

请提供您希望翻译的正文内容，我将为您翻译成简体中文并保持原有的格式、Markdown 语法以及技术术语不变。

什么是 Valyu？

Valyu 是一个原生 AI 的搜索与检索平台，专为现代 AI 工作负载设计，例如：

• 检索增强生成（Retrieval‑Augmented Generation，RAG）
• AI 代理
• 研究自动化
• 基于数据的 LLM 应用

Valyu 不返回松散排序的链接，而是专注于 结构化、相关性优化的结果，使 AI 系统更容易消费和推理。

高层次能力

• 统一访问网页、学术、专有和结构化数据
• 为 LLM 上下文窗口优化的结果
• 丰富的元数据和内容抽取
• 单一 API 取代碎片化的搜索流水线

核心理念很简单：如果 AI 系统要进行准确推理，它们需要已经 结构化、过滤且具备相关性意识 的搜索结果。

为什么 Valyu 很重要

在今天构建 AI 系统时，开发者通常需要花费大量时间将以下组件拼接在一起：

• 网络搜索 API
• 爬虫
• 向量化（Embedding）流水线
• 排序和过滤逻辑

Valyu 通过充当 AI 的搜索抽象层 来降低这种复杂性。它针对下游推理进行优化，而非面向人类浏览，这使其在以下场景中特别有用：

• 构建 RAG 流水线
• 为自主代理提供动力
• 执行可重复的研究任务
• 实验依赖最新或外部知识的 AI 工作流

新用户可获得 $10 免费积分，这让你可以轻松尝试、测试想法，并在投入生产前了解平台的行为。

快速实验 valyu-cli

当你仍在探索平台时，为每个实验编写代码会很慢。为加快速度，我构建了一个 非官方命令行工具，名为 valyu-cli。

注意： 此 CLI 不是 Valyu 官方产品。它纯粹用于在探索、测试和本地工作流中简化与 Valyu 的交互。

安装

# 全局安装（npm 或 yarn）
npm install -g valyu-cli
# 或
yarn global add valyu-cli

# 直接运行，无需安装
npx valyu-cli search "your query"

要求： 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），这使得该工具在 shell 脚本或轻量级流水线中非常有用。

全局标志（每个命令均可使用）

何时使用 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

About Valyu

Valyu 解决了 AI 生态系统中的一个真实问题：为推理系统而非浏览器设计的搜索。
如果检索质量对您的应用至关重要，了解其工作原理是值得的。

valyu-cli 工具是一个小型的非官方补充，旨在加快此类探索。结合 Valyu 的免费积分，它降低了实际测试想法的门槛，而不仅仅是阅读文档。

• Valyu website:
• Valyu CLI repository: