AI Search

AI Search 对你上传的文件建索引，并支持关键词、向量或混合检索以及可选的 chat。Markdown Conversion 通过同一标准 env.AI binding 的 toMarkdown() / supported() 提供。

open-compute 使用 operator 配置的 provider：embedding/chat 使用 OpenAI-compatible endpoint，reranking 使用专用 Cohere v2 或通用 /v1/rerank endpoint。不提供完整 Workers AI 模型推理（run()、models()、AutoRAG 及其它无关推理）。

**目前只支持文本查询：**AI Search 只接受文本 query 和 string content message。image、file 以及 text+image 混合查询均不支持，并会 fail closed，不会静默降级为文本检索。文档导入阶段的 OCR 和可选 image description 只是把源文件转换为可索引文本，不代表支持多模态查询。

例如可用于：

上传文档或索引有界 R2 source，再从 Worker 中检索
在生成回答前做混合检索
metadata relevance boosting 后使用专用 reranker
使用 env.AI.toMarkdown() 将 Office/PDF/HTML 转为 Markdown

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    const result = await env.SEARCH.search({ query: "cache invalidation" });
    return Response.json(result);
  },
} satisfies ExportedHandler<{ SEARCH: AiSearchInstance }>;

绑定 namespace 和/或 instance；需要 Markdown Conversion 时再声明平台 ai binding：

import { bindings, defineConfig } from "cf/config";

export default defineConfig({
  worker: {
    name: "search-app",
    entrypoint: "src/index.ts",
    ai_search_namespaces: [
      {
        binding: "SEARCH_NS",
        namespace: "team",
      },
    ],
    ai_search: [
      {
        binding: "SEARCH",
        instance_name: "docs",
      },
    ],
    env: {
      AI: bindings.ai(),
    },
  },
});

手动外部 source（open-compute 扩展）

open-compute:manual 是给已拥有 immutable 文件 revision 的应用使用的 namespaced API superset。它不扫描 source，也不持久化第二份完整源对象，只保存 locator 与正常的 parse/index 派生状态。每个 source authority 配置一个 loopback provider：

[ai.source_providers.files]
endpoint = "http://127.0.0.1:9080/provider"
source = "files"
credential = { env = "FILES_SOURCE_TOKEN" }
max_source_bytes = 67108864

provider 对 exact { source, key, revision } 请求实现带认证的 POST <endpoint>/resolve 与 POST <endpoint>/read。resolve 返回 revision、contentType、size、sha256；read 通过 Content-Type、X-Open-Compute-Revision、X-Open-Compute-Size、X-Open-Compute-Sha256 重复这些事实。redirect、压缩、revision 漂移、digest 不符或超限正文均 fail closed。

只使用 open-compute:ai-search 导出的扩展类型：

import type { OpenComputeAiSearchNamespace } from "open-compute:ai-search";

const index = await env.SEARCH_NS.openComputeCreateManual("files", {
  id: "documents",
  embedding_model: "company/qwen-embedding",
  index_method: { keyword: true, vector: true },
});
await index.items.openComputeUpsert({
  key: "files/blob-123",
  revision: "immutable-revision",
  contentType: "application/pdf",
  metadata: { team_id: "team-1" },
  waitForCompletion: false,
});

重复同一 exact revision 是幂等操作。revision 改变时复用既有 generation fence；delete 只删除 locator 与派生索引状态。官方 Cloudflare 管理表面看不到 manual instance 和扩展字段。

对于 manual instance，item info、list、download 与 search 结果都会返回 open_compute_source，包含 provider、source namespace、key 与 exact revision，供应用重新授权原始对象。

官方文档：Cloudflare AI Search。绑定语法见绑定。

兼容性

主题	Cloudflare	open-compute
AI Search Worker API	Namespace / instance / items / jobs / search / chat	已声明表面相同
查询模态	模型支持时可使用 text、image 或 multimodal	仅文本
Markdown Conversion	`env.AI.toMarkdown()` / `supported()`	固定 overload 相同
Embedding / chat 模型	Cloudflare 托管 Workers AI	operator 固定的 OpenAI-compatible provider
Reranking 模型	Cloudflare 托管 Workers AI	operator 固定的 `cohere_rerank_v2` 或 `rerank_v1` provider
Search 响应	`query_kind` 与检索/rerank score	文本成功响应返回 `query_kind: "text"`；rerank chunk 包含 `reranking_score`
完整 Workers AI 推理	`run()` / `models()` / AutoRAG	不提供
对象字节	托管存储	选定的 Local 或 S3 authority
就近存放 / 复制	全球	单机
手动外部 source	非官方 member	`open-compute:manual` namespaced 扩展

下一步：使用 bindings 开发 · 兼容性与限制