Moss

这个 Agent 能做什么，适合哪些场景？

Moss 是一个把检索和嵌入直接跑在应用进程内的搜索运行时。它由三部分组成：Moss Cloud 负责文档摄取、嵌入、存储与分发；Index 是把文档与向量打包成的单一产物；Runtime 嵌入在你的 Python、TypeScript、Elixir 或 C 应用中，通过 HTTPS 拉取索引并在本地内存中应答查询。SDK 提供 create_index、load_index、query 等接口，支持语义加关键词的混合检索、内置嵌入模型、元数据过滤（$eq、$and、$in、$near），另有 WebAssembly 版本 @moss-dev/moss-web 可完全在浏览器端运行。官方基准显示 10 万文档上端到端 P50 为 3.1 毫秒，明显快于远程向量库的数百毫秒往返。仓库同时提供 CLI、多种数据库连接器以及 LangChain、LlamaIndex、Pipecat、LiveKit、Vapi、ElevenLabs 等框架集成示例，采用 BSD-2-Clause 许可。

使用 Moss 的典型流程是：先在 moss.dev 注册获得 project_id 与 project_key，然后用 MossClient 的 create_index 方法写入带 id 与 text 的文档，Moss Cloud 负责生成嵌入并打包成可分发索引。客户端调用 load_index 通过 HTTPS 把索引拉到本地内存，随后 query 在本进程内完成嵌入与检索，返回 docs 列表以及 time_taken_ms，单次查询延迟在个位数毫秒。查询支持 QueryOptions(top_k=...) 或 { topK } 指定返回条数，并通过元数据操作符做条件过滤。浏览器场景改用 @moss-dev/moss-web 这个 WebAssembly 构建，索引下载后完全在客户端查询，无需服务端。仓库还包含 packages/moss-cli 的命令行工具、packages/moss-data-connector 的 SQLite/MongoDB/MySQL/Supabase 摄取连接器，以及 examples 与 apps 下可直接运行的语言、语音智能体和框架集成样例。

1. 语音客服或实时对话智能体开发者：需要把检索延迟压到 10 毫秒以内，否则会打断对话节奏。
2. 要构建 RAG 的后端团队：希望避免自建与管理向量数据库集群，直接用 SDK 在进程内查询索引。
3. 做静态站点或浏览器扩展的前端团队：需要客户端语义搜索，使用 @moss-dev/moss-web 在浏览器内离线查询。
4. 已在用 LangChain、LlamaIndex、DSPy 或 CrewAI 的团队：想给现有检索链换成低延迟运行时。
5. 搭 Pipecat、LiveKit、Vapi、ElevenLabs 语音管线的团队：需要把低延迟检索接入实时音频流程。
6. 从 SQLite、MongoDB、MySQL 或 Supabase 同步数据的团队：希望用现成连接器把业务数据摄入索引。

如何安装或部署这个 Agent？

服务端先安装对应语言的 SDK，并在 moss.dev 注册取得 project_id 与 project_key。Python 需要 3.10+：

pip install moss

TypeScript / Node.js 需要 20+：

npm install @moss-dev/moss

浏览器端使用独立的 WebAssembly 包：

npm install @moss-dev/moss-web

运行仓库自带示例前，需要把凭证写进 .env（复制 .env.example 后填写）：

cd examples/python
pip install -r requirements.txt
cp ../../.env.example .env
python load_and_query_sample.py

如何使用这个 Agent？

Python 端到端示例：

from moss import MossClient, QueryOptions

client = MossClient("your_project_id", "your_project_key")

await client.create_index("support-docs", [
    {"id": "1", "text": "Refunds are processed within 3-5 business days."},
    {"id": "2", "text": "You can track your order on the dashboard."},
    {"id": "3", "text": "We offer 24/7 live chat support."},
])

await client.load_index("support-docs")
results = await client.query("support-docs", "how long do refunds take?", QueryOptions(top_k=3))

TypeScript 端到端示例：

import { MossClient } from "@moss-dev/moss";

const client = new MossClient("your_project_id", "your_project_key");

await client.createIndex("support-docs", [
  { id: "1", text: "Refunds are processed within 3-5 business days." },
  { id: "2", text: "You can track your order on the dashboard." },
  { id: "3", text: "We offer 24/7 live chat support." },
]);

await client.loadIndex("support-docs");
const results = await client.query("support-docs", "how long do refunds take?", { topK: 3 });

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题