كيفية نشر واستضافة Claude Agent SDK مع Novita Sandbox

في عام 2026، وصل مجال الذكاء الاصطناعي إلى نقطة تحول حاسمة: الانتقال من الذكاء التجريبي إلى التنفيذ الصناعي. بينما ركزت الموجة الأولى من الذكاء الاصطناعي على المحادثة، فإن الحقبة الحالية تُعرّف بالوكالة (الذكاء الوكيل).

مع إطلاق Claude Agent SDK، تحول النموذج من واجهات برمجة التطبيقات (APIs) عديمة الحالة إلى أوقات تشغيل مستمرة ذات حالة. لم يعد المطورون راضين عن الوكلاء الذين يولدون الكود فقط— فهم يطالبون بأنظمة يمكنها التنفيذ والتصحيح والتكرار بشكل مستقل. على عكس نماذج اللغة الكبيرة التقليدية (LLMs) التي “تنسى” بعد كل طلب، يحافظ Claude Agent SDK الآن على حلقة استدلال مستمرة، حيث يكتب الكود ويصحح الأخطاء في الوقت الفعلي ويدير أنظمة ملفات معقدة.

لكن لا يزال هناك فجوة حرجة: البنية التحتية. للانتقال من العروض التوضيحية إلى قوة عمل رقمية على مستوى الإنتاج، يحتاج الوكلاء إلى أكثر من الذكاء— فهم بحاجة إلى بيئات آمنة وقابلة للتوسع وعالية الأداء وبأسعار معقولة لأداء عملهم.

تعلم كيفية نشر واستضافة وكلاء Claude في الإنتاج باستخدام Novita Sandbox، بيئة تنفيذ سحابية متوافقة مع E2B التي تسد هذه الفجوة ببنية تحتية من مستوى المؤسسات وبأسعار معقولة.

💡 مستعد لبدء البناء؟
توفر Novita مثالًا كاملًا لـ Claude Agent SDK جاهز للإنتاج مع واجهة سطر أوامر تفاعلية (CLI) وتطبيقات للأدوات وأفضل الممارسات. استنسخ المستودع وشغل أول وكيل لك في دقائق.

المزايا الأساسية: مصمم خصيصًا لـ Anthropic

1. ترحيل حقيقي “بدون إعادة هيكلة للكود”

توفر Novita نقطة نهاية لواجهة برمجة تطبيقات Anthropic متوافقة بالكامل. ما عليك سوى تغيير قيمة baseURL واحدة لمنح تطبيقات Claude الحالية لديك قدرات تنفيذ في العالم الحقيقي.

• التكامل الأصلي: استخدم @anthropic-ai/sdk مباشرة—لا توجد أطر عمل جديدة للتعلم عليها.
• التبديل السلس: متوافق مع جميع ميزات Beta، بما في ذلك أوضاع context-management و thinking.

import Anthropic from "@anthropic-ai/sdk";

// Just modify baseURL to switch seamlessly to Novita
const anthropic = new Anthropic({
  baseURL: "https://api.novita.ai/anthropic",
  apiKey: process.env.NOVITA_API_KEY,
});

// All Anthropic SDK usage remains unchanged
const response = await anthropic.messages.create({
  model: "zai-org/glm-4.7",
  max_tokens: 4096,
  messages: [{ role: "user", content: "Hello, World!" }],
});

2. “مختبر Sandbox” معزول عن السحابة

يوفر Novita Sandbox بيئات Linux يمكن إطلاقها فورًا مع إمكانية الوصول إلى نظام الملفات والتواصل الشبكي والعمليات الخلفية:

• عزل آمن: يعمل كل طلب في sandbox مستقل، مما يمنع تلوث الكود.
• قدرات كاملة المكدس: بيئات مدمجة لـ Node.js و Python و Jupyter مع دعم تثبيت ديناميكي لحزم npm و pip.
• معاينة فورية: كشف منفذ HTTPS العام بنقرة واحدة—عرض الصفحات المولدة فورًا.

import { Sandbox } from "novita-sandbox/code-interpreter";

// Create an isolated cloud environment in seconds
const sandbox = await Sandbox.create({ timeoutMs: 10 * 60 * 1000 });

// Write files
await sandbox.files.write("index.html", "<h1>Hello from Sandbox!</h1>");

// Start a background service and get a public URL
const handle = await sandbox.commands.run("npx http-server -p 3000", { background: true });
const publicUrl = `https://${sandbox.getHost(3000)}`;

console.log(`🌐 Preview URL: ${publicUrl}`);

3. الشفاء الذاتي للسياق والوعي الذكي

باستخدام قدرات أداة الاستخدام (Tool Use) الخاصة بـ Claude، يمكن للوكلاء:

• التكيف والإصلاح: عند حدوث أخطاء في وقت التشغيل، يرى الوكيل stderr ويعيد كتابة الكود تلقائيًا.
• تحسين الذاكرة: بالاقتران مع استراتيجيات contextManagement، يمسح النظام كتل الكود القديمة تلقائيًا للبقاء مركزًا.

// Enable the context-management Beta feature
// Reference: https://platform.claude.com/docs/en/build-with-claude/context-editing
const response = await anthropic.beta.messages.create({
  model: "zai-org/glm-4.7",
  max_tokens: 4096,
  betas: ["context-management-2025-06-27"],
  contextManagement: {
    edits: [
      {
        type: "clear_tool_uses_20250919",
        trigger: { type: "input_tokens", value: 10000 },  // Trigger cleanup when exceeding 10k tokens
        keep: { type: "tool_uses", value: 2 },            // Keep the last 2 tool calls
        clear_tool_inputs: true,                          // Also clear tool inputs
      },
    ],
  },
  tools: TOOLS,
  messages: conversationHistory,
});

كيف يعمل: عندما يتجاوز سياق المحادثة العتبة المحددة، يمسح واجهة برمجة التطبيقات (API) تلقائيًا نتائج استدعاءات الأدوات السابقة مع الحفاظ على المعلومات الحرجة الأخيرة. هذا يمنع “تلوث الذاكرة” الذي يقلل من أداء الوكيل.

حالات الاستخدام: إمكانيات لا حصر لها

السيناريو	ما يضيفه Novita Sandbox
مختبر ويب تفاعلي	إنشاء صفحات React/Tailwind من جملة واحدة؛ معاينة فورية.
تحليل بيانات ذكي	تشغيل Python ديناميكيًا لإنشاء مخططات باستخدام Pandas و Matplotlib.
اختبار آلي بالذكاء الاصطناعي	تشغيل نصوص الاختبار في بيئات معزولة؛ التقاط الأخطاء وإصلاحها تلقائيًا.
خلفية IDE مخصصة	توفير منفذ تنفيذ سحابي مستقل لكل مستخدم—بدون تكلفة تشغيلية إضافية.
سير عمل كود ذاتي الإصلاح	اختبار كود API المولد في حلقة مغلقة، للتأكد من عمله بشكل صحيح قبل التسليم.

بداية سريعة: بناء وكيل تفاعلي في ثلاث خطوات

لا حاجة إلى تكوين معقد—تجعل Novita التطوير بسيطًا.

الخطوة 1: تثبيت بسيط

npm install @anthropic-ai/sdk novita-sandbox dotenv open

الخطوة 2: تكامل ذكي لمفتاح API

يتضمن المشروع إرشادات تفاعلية للمفتاح. حتى بدون متغيرات بيئة، يطلب منك البرنامج إدخال المفتاح عند بدء التشغيل:

// agent_en.ts internal logic
if (!agent.hasApiKey()) {
  const apiKey = await promptForApiKey(rl);
  agent.setApiKey(apiKey);
}

الخطوة 3: إطلاق CLI تفاعلي بنقرة واحدة

شغل npm run agent-en للدخول إلى الوضع التفاعلي. ما عليك سوى إدخال متطلباتك، وسيتولى النماذج المتوافقة مع Anthropic توليد الكود وتشغيل الخدمات وفتح المتصفح.

npm run agent-en

جولة في الكود الأساسي

📌 تعريفات الأدوات: منح الذكاء الاصطناعي “قدرات ملموسة”

const TOOLS: Anthropic.Beta.Messages.BetaTool[] = [
  {
    name: "write_file",
    description: "Create or modify a file in the sandbox",
    input_schema: {
      type: "object",
      properties: {
        path: { type: "string", description: "File path, e.g., index.html" },
        content: { type: "string", description: "Complete file content" },
      },
      required: ["path", "content"],
    },
  },
  {
    name: "get_preview_url",
    description: "Start the web server and get the preview URL (returns the existing URL if the server is already running)",
    input_schema: { type: "object", properties: {} },
  },
];

📌 حلقة الوكيل: المعالجة حتى إتمام المهمة

async chat(userMessage: string): Promise<void> {
  // Refresh sandbox timeout on each user input
  await this.refreshSandboxTimeout();
  
  this.messages.push({ role: "user", content: userMessage });

  // Agentic Loop—continue processing until no tool calls remain
  let continueLoop = true;
  while (continueLoop) {
    const { response, assistantContent } = await this.streamResponse();
    this.messages.push({ role: "assistant", content: assistantContent });

    // Process tool calls
    const { hasToolUse, toolResults } = await this.processToolCalls(assistantContent);

    if (hasToolUse && toolResults.length > 0) {
      this.messages.push({ role: "user", content: toolResults });
      continueLoop = true;  // Tool calls exist; continue loop
    } else {
      continueLoop = false; // No tool calls; end
    }

    if (response.stop_reason === "end_turn") {
      continueLoop = false;
    }
  }
}

📌 الشفاء الذاتي للخدمة: كشف ذكي وإعادة تشغيل تلقائية

private async handleGetPreviewUrl(): Promise<string> {
  // Verify whether the process is actually alive
  if (this.previewUrl && this.serverHandle) {
    const processAlive = await this.checkServerProcessAlive();
    if (!processAlive) {
      console.log(`⚠️ Server process has exited; restarting...`);
      this.serverHandle = null;
      this.previewUrl = null;
    }
  }

  // Start a new server
  this.serverHandle = await this.sandbox.commands.run(
    `npx -y http-server . -p ${CONFIG.serverPort} -c-1`,
    { background: true }
  );

  // Get the public URL and run a health check
  const host = this.sandbox.getHost(CONFIG.serverPort);
  this.previewUrl = `https://${host}`;
  
  await waitForServer(this.previewUrl, maxRetries, intervalMs);
  await openBrowser(this.previewUrl);
  
  return `Preview URL: ${this.previewUrl}`;
}

استكشف المثال الكامل

توفر Novita مثالًا كامل الوظائف لـ Claude Agent SDK مع أنماط كود جاهزة للإنتاج. يوضح المثال:

• واجهة CLI تفاعلية مع استجابات متدفقة
• تطبيقات كاملة للأدوات (عمليات الملفات، تنفيذ الكود، إدارة خادم الويب)
• إدارة السياق مع تنظيف تلقائي
• معالجة الأخطاء ومنطق إعادة المحاولة
• فحوصات صحة الخدمة مع إعادة تشغيل تلقائية
• محادثة متعددة الأدوار مع حالة مستمرة

مستودع GitHub: Novita-CollabHub/examples/claude-agent

بداية سريعة مع المثال:

# Clone the repository
git clone https://github.com/novitalabs/Novita-CollabHub.git
cd Novita-CollabHub/examples/claude-agent

# Install dependencies
npm install

# Set your API key
export NOVITA_API_KEY=your_api_key_here

# Run the interactive agent
npm run agent-en

عرض توضيحي للمحادثة متعددة الأدوار

إليك مثال كامل لمحادثة متعددة الأدوار يوضح كيف يقوم الوكيل بتحسين الصفحة بشكل تكاملي بناءً على ملاحظات المستخدم:

الجولة 1: إنشاء تطبيق قائمة مهام

إدخال المستخدم: إنشاء تطبيق قائمة مهام

الجولة 2: التغيير إلى نمط Stardew Valley

إدخال المستخدم: التغيير إلى نمط Stardew Valley

الجولة 3: إضافة المزيد من الوظائف

إدخال المستخدم: إضافة المزيد من الوظائف

الخلاصة

يتطلب نشر Claude Agent SDK في الإنتاج بنية تحتية لم يتم تصميم منصات السحابة التقليدية لتوفيرها. يوفر Novita Sandbox بنية تحتية جاهزة للإنتاج تتكامل بسلاسة مع Claude Agent SDK، ويمنح وكلاءك “الأيدي” التي يحتاجونها للعمل في العالم الحقيقي من خلال تقديم:

• بيئة تنفيذ سحابية متوافقة مع E2B للتكامل السلس مع الأدوات الحالية
• نقطة نهاية متوافقة أصليًا مع Anthropic لا تتطلب أي إعادة هيكلة للكود—ما عليك سوى تغيير baseURL
• عزل حاويات آمن لتنفيذ كود غير موثوق
• توفير فوري مع أوقات تشغيل مهيأة مسبقًا
• كشف عنوان URL عام لتطبيقات الويب المولدة
• إدارة عمليات خلفية للخدمات التي تعمل لفترات طويلة

ابدأ في بناء وكلاء ذكاء اصطناعي ذات حالة اليوم:

• توثيق Novita Sandbox
• مثال كامل لـ Agent SDK

Novita AI هي منصة سحابية رائدة للذكاء الاصطناعي توفر للمطورين واجهات برمجة تطبيقات سهلة الاستخدام وبنية تحتية لـ GPU موثوقة وبأسعار معقولة لبناء وتوسيع نطاق تطبيقات الذكاء الاصطناعي.