INTEGRITY Dokumentace

← Cloudflare Workers AI / workers-ai / get-started

Workers Bindings

Tento návod vás provede nastavením a nasazením prvního projektu Workers AI. Použijete Workers, vazbu Workers AI a velký jazykový model (LLM) k nasazení vaší první aplikace využívající AI v globální síti Cloudflare.

  1. Zaregistrujte si účet Cloudflare ↗.
  2. Nainstalujte Node.js ↗.

Správce verzí Node.js

Použijte správce verzí Node, jako je Volta ↗ nebo nvm ↗ abyste se vyhnuli problémům s oprávněními a mohli měnit verze Node.js. Wrangler, o kterém se dozvíte dále v této příručce, vyžaduje verzi Node 16.17.0 nebo novější.

1. Vytvořte projekt Worker

Nový projekt Worker vytvoříte pomocí create-cloudflare CLI (C3). C3 ↗ je nástroj příkazové řádky, který vám pomůže nastavit a nasadit nové aplikace na Cloudflare.

Vytvořte nový projekt s názvem hello-ai spuštěním:

npm create cloudflare@latest -- hello-ai

Spouštění npm create cloudflare@latest vás vyzve k instalaci create-cloudflare balíček ↗, a provede vás nastavením. C3 také nainstaluje Wrangler, CLI nástroj pro Cloudflare Developer Platform.

Při nastavení vyberte následující možnosti:

Tímto vytvoříte nový hello-ai adresáři. Váš nový hello-ai adresář bude obsahovat:

Přejděte do adresáře své aplikace:

cd hello-ai

2. Připojte Worker k Workers AI

Aby se váš Worker mohl připojit k Workers AI, musíte vytvořit binding AI. Bindings umožňují vašim Workers pracovat s prostředky na Cloudflare Developer Platform, například s Workers AI.

Chcete-li připojit Workers AI ke svému Workeru, přidejte následující na konec souboru Wrangler:

{
	"ai": {
		"binding": "AI"
	}
}
[ai]
binding = "AI"

Váš binding je dostupné ve kódu vašeho Workeru na env.AI.

Workers AI můžete navázat také na Pages Function. Další informace najdete v Functions Bindings.

3. Spusťte úlohu inference ve svém Workeru

Nyní jste připraveni spustit inferenční úlohu ve svém Workeru. V tomto případě použijete LLM, gemma-4-26b-a4b-it, k zodpovězení otázky.

Aktualizujte index.ts soubor v hello-ai adresáři aplikace s následujícím kódem:

index.js
export default {
	async fetch(request, env) {
		const response = await env.AI.run("@cf/google/gemma-4-26b-a4b-it", {
			messages: [
				{
					role: "system",
					content: "You are a helpful assistant.",
				},
				{
					role: "user",
					content: "What is the origin of the phrase Hello, World",
				},
			],
			chat_template_kwargs: {
				enable_thinking: false,
			},
		});

		return Response.json(response);
	},
};
index.ts
export interface Env {
	// If you set another name in the Wrangler config file as the value for 'binding',
	// replace "AI" with the variable name you defined.
	AI: Ai;
}

export default {
	async fetch(request, env): Promise<Response> {
		const response = await env.AI.run("@cf/google/gemma-4-26b-a4b-it", {
			messages: [
				{
					role: "system",
					content: "You are a helpful assistant.",
				},
				{
					role: "user",
					content: "What is the origin of the phrase Hello, World",
				},
			],
			chat_template_kwargs: {
				enable_thinking: false,
			},
		});

		return Response.json(response);
	},
} satisfies ExportedHandler<Env>;

Doposud jste vytvořili vazbu AI pro svého Workera a nakonfigurovali jste ho tak, aby spouštěl model Gemma 4 26B A4B s vypnutým uvažováním. Nyní můžete projekt otestovat lokálně, než jej nasadíte globálně.

4. Vyvíjejte lokálně pomocí Wrangleru

V adresáři svého projektu otestujte Workers AI lokálně spuštěním wrangler dev:

npx wrangler dev

K přihlášení budete vyzváni po spuštění wrangler dev. Když spustíte npx wrangler dev, Wrangler vám poskytne adresu URL (nejspíše localhost:8787) pro kontrolu vašeho Workera. Jakmile otevřete adresu URL, kterou vám poskytne Wrangler, bude mít odpověď podobu podle následujícího příkladu:

{
	"id": "<generated id>",
	"object": "chat.completion",
	"created": 0,
	"model": "@cf/google/gemma-4-26b-a4b-it",
	"choices": [
		{
			"index": 0,
			"message": {
				"role": "assistant",
				"content": "<generated response>",
				"refusal": null
			},
			"finish_reason": "stop",
			"logprobs": null
		}
	]
}

5. Nasaďte svůj AI Worker

Před globálním nasazením vašeho AI Workeru se přihlaste ke svému účtu Cloudflare spuštěním:

npx wrangler login

Budete přesměrováni na webovou stránku s výzvou k přihlášení do dashboardu Cloudflare. Po přihlášení se zobrazí dotaz, zda Wrangler smí provádět změny ve vašem účtu Cloudflare. Přejděte dolů a vyberte Allow pokračovat.

Nakonec nasaďte svůj Worker, aby byl projekt dostupný na internetu. Worker nasadíte příkazem:

npx wrangler deploy
https://hello-ai.<YOUR_SUBDOMAIN>.workers.dev

Váš Worker bude nasazen na vaši vlastní workers.dev subdoména. Nyní můžete přejít na tuto adresu URL a spustit svého AI Workera.

Dokončením tohoto tutoriálu jste vytvořili Worker, propojili jej s Workers AI pomocí vazby AI a spustili úlohu inference s modelem Gemma 4 26B A4B.