首页/文件与集合/集合

集合

创建文档集合，构建 RAG（检索增强生成）搜索管道。

什么是集合？

集合是文件的分组，用于 RAG 搜索。当你创建集合并添加文件后， xAI 会自动对文件内容进行分块和向量化。之后，你可以搜索集合中的内容，或使用 collections_search 工具让 Grok 自动搜索相关内容。

创建和管理集合

Python

import os
from xai_sdk import Client

client = Client(api_key=os.getenv("XAI_API_KEY"))

# 创建集合
collection = client.collections.create(
    name="我的知识库",
    description="产品文档和技术规范",
)

# 添加文件到集合
client.collections.add_file(
    collection_id=collection.id,
    file_id="file-abc123",
)

# 搜索集合
results = client.collections.search(
    collection_id=collection.id,
    query="如何配置认证？",
)

for result in results:
    print(f"Score: {result.score}")
    print(f"Content: {result.content}")

集合搜索工具 (RAG)

集合搜索工具（collections_search）允许 Grok 智能体自动搜索你的文档集合。当用户提问时，模型会自动搜索相关文档片段来生成更准确的回答。

工具	工具名称	费用
集合搜索 (RAG)	`collections_search` / `file_search`	$2.50 / 1K 次调用

存储费用

集合存储：$0.10 / GiB / 天
下载费用：按传输数据量计费

集合元数据

可以为集合添加自定义元数据，如标签、分类等。元数据可以用于过滤搜索结果，使 RAG 搜索更加精确。

最佳实践

按主题或部门创建不同的集合
定期更新集合内容以保持信息最新
使用描述性名称和元数据便于管理
对于大型文档库，使用元数据过滤提高搜索精度
监控搜索调用以优化成本