# AI Search

Create fully managed RAG pipelines for your AI applications

> Links below point directly to Markdown versions of each page. Any page can also be retrieved as Markdown by sending an `Accept: text/markdown` header to the page's URL without the `index.md` suffix (for example, `curl -H "Accept: text/markdown" https://cloudflaredoc.ubitools.com/ai-search/`).
>
> For other Cloudflare products, see the [Cloudflare documentation directory](https://cloudflaredoc.ubitools.com/llms.txt).

## Overview

- [概览](https://cloudflaredoc.ubitools.com/ai-search/index.md): Cloudflare AI Search 是一项托管搜索服务。为你的内容建立索引，并通过 Workers 绑定、REST API 或 MCP server 以自然语言进行查询。

## 快速入门

- [快速入门](https://cloudflaredoc.ubitools.com/ai-search/get-started/index.md): 使用 Cloudflare AI Search 创建全托管的检索增强生成（RAG）流水线。
- [REST API](https://cloudflaredoc.ubitools.com/ai-search/get-started/api/index.md): 使用 REST API 以编程方式创建 AI Search 实例。
- [仪表板](https://cloudflaredoc.ubitools.com/ai-search/get-started/dashboard/index.md): 使用 Cloudflare 仪表板创建并配置 AI Search。
- [Python SDK](https://cloudflaredoc.ubitools.com/ai-search/get-started/python/index.md): 从 Python 创建、填充并查询 AI Search 实例。
- [Workers 绑定（binding）](https://cloudflaredoc.ubitools.com/ai-search/get-started/workers/index.md): 从 Cloudflare Worker 创建、填充并查询 AI Search 实例。
- [CLI](https://cloudflaredoc.ubitools.com/ai-search/get-started/wrangler/index.md): 从命令行创建并管理 AI Search 实例。

## Wrangler CLI

- [Wrangler CLI](https://cloudflaredoc.ubitools.com/ai-search/wrangler-commands/index.md): 使用 Wrangler 从命令行管理 AI Search 实例。

## 配置

- [配置](https://cloudflaredoc.ubitools.com/ai-search/configuration/index.md): 自定义 AI Search 实例如何建立索引、检索结果并 generate 响应。
- [数据源](https://cloudflaredoc.ubitools.com/ai-search/configuration/data-source/index.md): 连接网站、R2 bucket，或直接上传文件到 AI Search 实例以建立索引。
- [内置存储](https://cloudflaredoc.ubitools.com/ai-search/configuration/data-source/built-in-storage/index.md): 使用由 R2 与 Vectorize 驱动的内置存储，直接将文件上传到 AI Search 实例。
- [R2](https://cloudflaredoc.ubitools.com/ai-search/configuration/data-source/r2/index.md): 将 Cloudflare R2 bucket 连接为数据源，使用 AI Search 为存储的文档建立索引。
- [网站](https://cloudflaredoc.ubitools.com/ai-search/configuration/data-source/website/index.md): 将你拥有的域名连接为数据源，使 AI Search 可以抓取并索引网站页面。
- [分块](https://cloudflaredoc.ubitools.com/ai-search/configuration/indexing/chunking/index.md): 配置 AI Search 如何将内容拆分为块以进行 embedding 与检索。
- [混合搜索](https://cloudflaredoc.ubitools.com/ai-search/configuration/indexing/hybrid-search/index.md): 在 AI Search 中结合向量与关键词搜索，获得更广泛、更准确的检索结果。
- [关键词搜索](https://cloudflaredoc.ubitools.com/ai-search/configuration/indexing/keyword-search/index.md): 在 AI Search 中启用 BM25 关键词搜索，匹配包含精确查询词的文档。
- [元数据属性](https://cloudflaredoc.ubitools.com/ai-search/configuration/indexing/metadata/index.md): 在已索引文档上定义内置与自定义元数据属性。
- [路径筛选](https://cloudflaredoc.ubitools.com/ai-search/configuration/indexing/path-filtering/index.md): 通过定义包含与排除路径模式，控制 AI Search 索引哪些文件或 URL。
- [服务 API 令牌](https://cloudflaredoc.ubitools.com/ai-search/configuration/indexing/service-api-token/index.md): 创建服务 API 令牌，授予 AI Search 读取 R2 存储桶以建立索引的权限。
- [同步](https://cloudflaredoc.ubitools.com/ai-search/configuration/indexing/syncing/index.md): 了解 AI Search 如何自动同步并为已连接数据源的内容建立索引。
- [向量搜索](https://cloudflaredoc.ubitools.com/ai-search/configuration/indexing/vector-search/index.md): 在 AI Search 中配置向量搜索，使用 embedding 查找语义相似内容。
- [模型](https://cloudflaredoc.ubitools.com/ai-search/configuration/models/index.md): 配置 AI Search 用于 embedding、生成、重排序与查询重写的 AI 模型。
- [AI Gateway](https://cloudflaredoc.ubitools.com/ai-search/configuration/models/ai-gateway/index.md): 通过已连接的 AI Gateway 观测并控制 AI Search 实例使用的 AI 模型。
- [支持的模型](https://cloudflaredoc.ubitools.com/ai-search/configuration/models/supported-models/index.md): 查看 AI Search 支持的所有 AI 模型，包括文本生成、embedding 与重排序模型。
- [相关性提升](https://cloudflaredoc.ubitools.com/ai-search/configuration/retrieval/boosting/index.md): 使用相关性提升，使 AI Search 结果偏向具有特定元数据的文档。
- [相似度缓存](https://cloudflaredoc.ubitools.com/ai-search/configuration/retrieval/cache/index.md): 通过缓存并复用语义相似查询的答案，加快 AI Search 响应速度。
- [UI 片段](https://cloudflaredoc.ubitools.com/ai-search/configuration/retrieval/embed-search-snippets/index.md): 使用预构建、可自定义的搜索与聊天 Web 组件，将 AI Search 添加到你的网站。
- [筛选](https://cloudflaredoc.ubitools.com/ai-search/configuration/retrieval/filtering/index.md): 在查询时按元数据属性筛选 AI Search 结果。
- [公共端点设置](https://cloudflaredoc.ubitools.com/ai-search/configuration/retrieval/public-endpoint/index.md): 通过无需认证的公共 MCP、chat 与搜索端点暴露 AI Search 实例。
- [查询重写](https://cloudflaredoc.ubitools.com/ai-search/configuration/retrieval/query-rewriting/index.md): 启用查询重写以改写用户查询，提升 AI Search 检索质量。
- [重排序](https://cloudflaredoc.ubitools.com/ai-search/configuration/retrieval/reranking/index.md): 在 AI Search 中启用重排序，按语义相关性重新排序检索结果。
- [结果控制](https://cloudflaredoc.ubitools.com/ai-search/configuration/retrieval/result-controls/index.md): 控制 AI Search 返回结果的数量与最低分数阈值。
- [系统提示词](https://cloudflaredoc.ubitools.com/ai-search/configuration/retrieval/system-prompt/index.md): 使用自定义系统提示词引导 AI Search 的查询重写与响应生成行为。

## 操作指南

- [操作指南](https://cloudflaredoc.ubitools.com/ai-search/how-to/index.md): 分步指南：构建搜索引擎、按租户搜索及其他 AI Search 用例。
- [为网站添加搜索](https://cloudflaredoc.ubitools.com/ai-search/how-to/add-search-to-your-website/index.md): 创建可索引你网站的 AI Search 实例，然后使用 UI 片段组件为 React 站点添加搜索栏、聊天气泡和搜索模态框。
- [使用自有生成模型](https://cloudflaredoc.ubitools.com/ai-search/how-to/bring-your-own-generation-model/index.md): 使用 AI Search 进行检索，同时用 OpenAI 等外部模型生成响应。
- [在响应中显示来源引用](https://cloudflaredoc.ubitools.com/ai-search/how-to/chunk-citations/index.md): 在 AI 生成的答案旁显示来源引用。
- [将 AI Search 连接到 MCP 客户端](https://cloudflaredoc.ubitools.com/ai-search/how-to/connect-mcp-client/index.md): 通过内置 MCP 端点，将已建立索引的内容作为搜索工具公开给任何 MCP 客户端或代理。
- [抓取并索引单个网页](https://cloudflaredoc.ubitools.com/ai-search/how-to/fetch-and-index-web-pages/index.md): 使用 Browser Run /content 端点获取单个网页的已渲染 HTML，然后将其上传到 AI Search 实例的内置存储，以便 AI Search 对其进行搜索索引。
- [人在环路的知识库更新](https://cloudflaredoc.ubitools.com/ai-search/how-to/human-in-the-loop-knowledge-base/index.md): 构建可搜索知识库并提出更新建议的 agent，由人工批准并能够回滚每次写入。
- [NLWeb](https://cloudflaredoc.ubitools.com/ai-search/how-to/nlweb/index.md): 部署 NLWeb 与 AI Search，在网站上启用对话式自然语言查询。
- [多租户 (Multitenancy)](https://cloudflaredoc.ubitools.com/ai-search/how-to/per-tenant-search/index.md): 使用为每个租户提供的独立实例或带有元数据过滤的共享实例，在 AI Search 中保持每个租户的数据隔离。
- [跨多个实例搜索](https://cloudflaredoc.ubitools.com/ai-search/how-to/search-multiple-sources/index.md): 在单个查询中搜索共享知识库和租户专用知识库，并标识每个结果来自哪个实例。
- [创建简单搜索引擎](https://cloudflaredoc.ubitools.com/ai-search/how-to/simple-search-engine/index.md): 使用 AI Search Workers 绑定和 search 方法构建简单搜索引擎。
- [与知识库对话](https://cloudflaredoc.ubitools.com/ai-search/how-to/talk-to-your-knowledge-base/index.md): 构建一个语音代理，让用户通过语音与 AI Search 知识库对话并听取口语回答，使用 Cloudflare Agents 语音管道。

## REST API

- [REST API](https://cloudflaredoc.ubitools.com/api/resources/ai_search/index.md): 访问 AI Search REST API 参考，管理实例、条目与搜索操作。

## api

- [REST API](https://cloudflaredoc.ubitools.com/ai-search/api/instances/rest-api/index.md): 使用 Instances REST API 通过 HTTP 管理 AI Search 实例与同步任务。
- [Workers 绑定（binding）](https://cloudflaredoc.ubitools.com/ai-search/api/instances/workers-binding/index.md): 通过 Instances Workers 绑定（binding）从 Cloudflare Worker 管理 AI Search 实例。
- [REST API](https://cloudflaredoc.ubitools.com/ai-search/api/items/rest-api/index.md): 使用 Items REST API 在 AI Search 实例中上传、列出和管理文档。
- [Workers 绑定（binding）](https://cloudflaredoc.ubitools.com/ai-search/api/items/workers-binding/index.md): 使用 Items Workers 绑定（binding）在 AI Search 实例中上传、列出和管理文档。
- [元数据筛选器（旧版）](https://cloudflaredoc.ubitools.com/ai-search/api/migration/autorag-filter-format/index.md): 旧版 REST API 使用的 AutoRAG 元数据筛选器格式参考。
- [REST API 迁移](https://cloudflaredoc.ubitools.com/ai-search/api/migration/rest-api/index.md): 从旧版 AutoRAG REST API 端点迁移到新的 AI Search API 端点。
- [Workers 绑定迁移](https://cloudflaredoc.ubitools.com/ai-search/api/migration/workers-binding/index.md): 从旧版 env.AI.autorag() 绑定（binding）升级到新的 AI Search Workers 绑定。
- [Workers 绑定（旧版）](https://cloudflaredoc.ubitools.com/ai-search/api/migration/workers-binding-legacy/index.md): 早期 AI Search 实例使用的旧版 env.AI.autorag() Workers 绑定（binding）参考。
- [MCP](https://cloudflaredoc.ubitools.com/ai-search/api/search/mcp/index.md): 通过 Model Context Protocol (MCP) 端点向 AI Agent 暴露 AI Search 内容。
- [公共端点](https://cloudflaredoc.ubitools.com/ai-search/api/search/public-endpoint/index.md): 使用无需认证的公共端点，将 AI Search 集成到面向公众的应用中。
- [REST API](https://cloudflaredoc.ubitools.com/ai-search/api/search/rest-api/index.md): 使用 REST API 通过 HTTP 查询 AI Search 实例，进行搜索与 chat completions。
- [Workers 绑定（binding）](https://cloudflaredoc.ubitools.com/ai-search/api/search/workers-binding/index.md): 通过 Workers 绑定（binding）从 Cloudflare Worker 搜索并与 AI Search 实例对话。

## concepts

- [AI Search 工作原理](https://cloudflaredoc.ubitools.com/ai-search/concepts/how-ai-search-works/index.md): 了解 AI Search 如何为你的内容建立索引，并通过向量与关键词搜索检索结果。
- [命名空间](https://cloudflaredoc.ubitools.com/ai-search/concepts/namespaces/index.md): 将 AI Search 实例分组到命名空间，并通过 Workers 绑定（binding）动态管理。
- [搜索模式](https://cloudflaredoc.ubitools.com/ai-search/concepts/search-modes/index.md): 比较 AI Search 的向量、关键词与混合搜索模式，选择正确的检索策略。

## platform

- [限制与定价](https://cloudflaredoc.ubitools.com/ai-search/platform/limits-pricing/index.md): 查看 Workers 免费版和付费版计划中的 AI Search 使用限制与定价详情。
- [发布说明](https://cloudflaredoc.ubitools.com/ai-search/platform/release-note/index.md): 查看 Cloudflare AI Search 的近期变更。

## troubleshooting

- [API 错误代码](https://cloudflaredoc.ubitools.com/ai-search/troubleshooting/api-error-codes/index.md): 排查 API 与公共端点错误。
- [索引错误代码](https://cloudflaredoc.ubitools.com/ai-search/troubleshooting/indexing-error-codes/index.md): 解决异步索引、同步与抓取错误代码。