📘 תיעוד 190

קישורי Workers

המדריך הזה מלווה אותך בהגדרה ובפריסה של פרויקט Workers AI הראשון שלך. תשתמש ב-Workers, בקישור (binding) של Workers AI, ובמודל שפה גדול (LLM) כדי לפרוס את היישום הראשון שלך שמבוסס על AI ברשת הגלובלית של Cloudflare.

1. הירשם ל-חשבון Cloudflare ↗︎.
2. התקן את Node.js ↗︎.

#מנהל גרסאות של Node.js

השתמש ב-Vite+ (vp env) ↗︎ כדי להתקין ולנהל גרסאות של Node.js.

לגרסאות Node.js נתמכות, עיין ב-דרישות המערכת של Wrangler.

#1. יצירת פרויקט Worker

תיצור פרויקט Worker חדש באמצעות ה-CLI של create-cloudflare (C3). C3 ↗︎ הוא כלי שורת פקודה שנועד לעזור לך להגדיר ולפרוס יישומים חדשים ל-Cloudflare.

צור פרויקט חדש בשם hello-ai על ידי הרצת אחת מהפקודות הבאות:

npm:

npm create cloudflare@latest -- hello-ai

yarn:

yarn create cloudflare hello-ai

pnpm:

pnpm create cloudflare@latest hello-ai

הרצת npm create cloudflare@latest תבקש ממך להתקין את חבילת create-cloudflare ↗︎, ותלווה אותך בהגדרה. C3 גם יתקין את Wrangler, ה-CLI של פלטפורמת המפתחים של Cloudflare.

להגדרה, בחר באפשרויות הבאות:

• עבור What would you like to start with?, בחר Hello World example.
• עבור Which template would you like to use?, בחר Worker only.
• עבור Which language do you want to use?, בחר TypeScript.
• עבור Do you want to use git for version control?, בחר Yes.
• עבור Do you want to add an AGENTS.md file to help AI coding tools understand Cloudflare APIs?, בחר Yes.
• עבור Do you want to deploy your application?, בחר No (נבצע כמה שינויים לפני הפריסה).

פעולה זו תיצור ספריית hello-ai חדשה. ספריית hello-ai החדשה שלך תכלול:

• Worker של "Hello World" בנתיב src/index.ts.
• קובץ תצורה wrangler.jsonc.

עבור לספריית היישום שלך:

cd hello-ai

#2. חיבור ה-Worker ל-Workers AI

עליך ליצור קישור AI עבור ה-Worker כדי להתחבר ל-Workers AI. קישורים (Bindings) מאפשרים ל-Workers שלך לקיים אינטראקציה עם משאבים, כמו Workers AI, בפלטפורמת המפתחים של Cloudflare.

כדי לקשר את Workers AI ל-Worker שלך, הוסף את התוכן הבא לסוף קובץ Wrangler:

{
	"ai": {
		"binding": "AI"
	}
}

[ai]
binding = "AI"

הקישור שלך זמין בקוד ה-Worker על env.AI.

אפשר גם לקשר את Workers AI לפונקציית Pages. למידע נוסף, עיין ב-קישורי Functions.

#3. הרצת משימת הסקה ב-Worker

עכשיו אפשר להריץ משימת הסקה ב-Worker. במקרה הזה תשתמש ב-LLM, gemma-4-26b-a4b-it, כדי לענות על שאלה.

עדכן את הקובץ index.ts בספריית היישום hello-ai עם הקוד הבא:

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>;

עד לנקודה הזו יצרת קישור AI עבור ה-Worker והגדרת את ה-Worker להריץ את מודל Gemma 4 26B A4B עם הנמקה מושבתת. עכשיו אפשר לבדוק את הפרויקט באופן מקומי לפני פריסה גלובלית.

#4. פיתוח מקומי עם Wrangler

מתוך ספריית הפרויקט, בדוק את Workers AI באופן מקומי על ידי הרצת wrangler dev:

npx wrangler dev

#חיובים על שימוש בפיתוח מקומי של Workers AI

שימוש ב-Workers AI תמיד ניגש לחשבון Cloudflare שלך כדי להריץ מודלי AI, ויגרום לחיובים על שימוש גם בפיתוח מקומי.

תתבקש להתחבר אחרי הרצת wrangler dev. כשתריץ npx wrangler dev, Wrangler ייתן לך כתובת URL (לרוב localhost:8787) כדי לבדוק את ה-Worker. אחרי שתעבור לכתובת ש-Wrangler מספק, לתשובה תהיה צורה דומה לדוגמה הבאה:

{
	"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. פריסת ה-AI Worker

לפני פריסת ה-AI Worker באופן גלובלי, התחבר עם חשבון Cloudflare שלך על ידי הרצה:

npx wrangler login

תופנה לדף אינטרנט שמבקש ממך להתחבר ללוח הבקרה של Cloudflare. אחרי ההתחברות, תישאל אם Wrangler יכול לבצע שינויים בחשבון Cloudflare שלך. גלול למטה ובחר Allow כדי להמשיך.

לבסוף, פרוס את ה-Worker כדי שהפרויקט יהיה נגיש באינטרנט. כדי לפרוס את ה-Worker, הרץ:

npx wrangler deploy

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

ה-Worker ייפרס לתת הדומיין המותאם אישית שלך ב-workers.dev. עכשיו אפשר לבקר בכתובת כדי להריץ את ה-AI Worker.

בסיום המדריך הזה יצרת Worker, חיברת אותו ל-Workers AI דרך קישור AI, והרצת משימת הסקה באמצעות מודל Gemma 4 26B A4B.

#משאבים קשורים

• קהילת Cloudflare Developers ב-Discord ↗︎: שלח בקשות לתכונות, דווח על באגים, ושתף משוב ישירות עם צוות Cloudflare על ידי הצטרפות לשרת Discord של Cloudflare.
• מודלים: עיין בקטלוג המודלים של Workers AI.
• AI SDK: למד איך לשלב עם מודל AI.