← Přehled / ai-search / api / migration

Migrace vazby Workers

env.AI.autorag() binding je starší API pro AI Search. Bude fungovat i nadále, ale všechny nové funkce a vylepšení jsou dostupné pouze prostřednictvím nových vazeb AI Search.

Zde je přehled klíčových rozdílů mezi starším a novým bindingem:

AI Search poskytuje dva nové bindingy:

Vazba instance (ai_search) se váže přímo na jednu instanci. Toto je nejjednodušší způsob migrace z env.AI.autorag().

// wrangler.jsonc
{
	"ai_search": [
		{
			"binding": "MY_SEARCH",
			"instance_name": "my-instance",
		},
	],
}

Vazba jmenného prostoru (ai_search_namespaces) vám poskytuje přístup ke všem instancím v rámci jmenného prostoru. Použijte jej, pokud potřebujete dynamickou správu instancí, vyhledávání napříč instancemi nebo Items API.

// wrangler.jsonc
{
	"ai_search_namespaces": [
		{
			"binding": "AI_SEARCH",
			"namespace": "default",
		},
	],
}

Podrobnosti o rozdílu najdete v Jmenné prostory.

Nové vazby vyžadují následující minimální verze balíčků pro podporu typů TypeScript a lokálního vývoje.

Stávající instance se nacházejí ve výchozím jmenném prostoru. Pro jednoduchý postup upgradu použijte vazbu instance. Informace o vazbě jmenného prostoru najdete v AI Search bindingy.

Před:

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "ai": {
    "binding": "AI"
  }
}

[ai]
binding = "AI"

Poté:

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "compatibility_date": "2026-03-27",
  "ai_search": [
    {
      "binding": "MY_INSTANCE",
      "instance_name": "my-instance"
    }
  ]
}

compatibility_date = "2026-03-27"

[[ai_search]]
binding = "MY_INSTANCE"
instance_name = "my-instance"

Aktualizujte Env rozhraní, abyste mohli použít nový typ vazby.

Před:

export interface Env {
	AI: Ai;
}

Poté:

export interface Env {
	MY_INSTANCE: AiSearchInstance;
}

Nahraďte env.AI.autorag() volání novou vazbou.

Před:

const result = await env.AI.autorag("my-instance").search({
	query: "What is Cloudflare?",
});

Poté:

const result = await env.MY_INSTANCE.search({
	messages: [{ role: "user", content: "What is Cloudflare?" }],
});

Tvar odpovědi se změnil z data array na chunks pole.

Ve starší vazbě streamování pomocí env.AI.autorag().aiSearch({ stream: true }) vracela pouze streamovanou odpověď bez získaných chunků.

Nová vazba odesílá získané chunky nejprve jako chunks událost, po které následuje streamovaná odpověď. Díky tomu můžete zdrojové chunky zobrazit ihned, zatímco se generovaná odpověď streamuje.

Nová vazba používá filtrování metadat ve stylu Vectorize. Filtry se nyní předávají uvnitř ai_search_options.retrieval.filters.

Filtrování podle jediné položky metadat pomocí implicitní rovnosti:

Před:

const result = await env.AI.autorag("my-instance").search({
	query: "What is Cloudflare?",
	filters: {
		type: "eq",
		key: "folder",
		value: "customer-a/",
	},
});

Poté:

const result = await env.MY_INSTANCE.search({
	messages: [{ role: "user", content: "What is Cloudflare?" }],
	ai_search_options: {
		retrieval: {
			filters: { folder: "customer-a/" },
		},
	},
});

Kombinujte více podmínek, které musí být splněny všechny:

Před:

const result = await env.AI.autorag("my-instance").search({
	query: "What is Cloudflare?",
	filters: {
		type: "and",
		filters: [
			{ type: "eq", key: "folder", value: "customer-a/" },
			{ type: "gte", key: "timestamp", value: "1735689600000" },
		],
	},
});

Poté:

const result = await env.MY_INSTANCE.search({
	messages: [{ role: "user", content: "What is Cloudflare?" }],
	ai_search_options: {
		retrieval: {
			filters: {
				folder: "customer-a/",
				timestamp: { $gte: 1735689600 },
			},
		},
	},
});

env.AI.autorag() bude fungovat i nadále bez omezení. Migraci nemusíte provádět okamžitě.

Referenci staršího API najdete v Vazba Workers (starší).