تحويل جداول البيانات إلى عمل ذكي: دليل المطور لـ Aspose.Cells Cloud AI Controller

أضف الترجمة المدعومة بالذكاء الاصطناعي، وتفكيك المهام، ومعالجة النصوص إلى سير عمل جدول البيانات الخاص بك — باستخدام استدعاءات REST بسيطة، دون الحاجة إلى خبرة في التعلم الآلي.

كل فريق تطوير يواجه نفس العقبة: تحتاج بيانات الجداول الإلكترونية إلى ترجمة, تلخيص, تصنيف, أو إعادة تنظيم قبل أن تكون مفيدة للأنظمة اللاحقة. تقليديًا، كان ذلك يعني سكريبتات مخصصة، سلاسل تعبيرات نمطية هشة، أو عمل يدوي مكلف.

Aspose.Cells Cloud AI Controller يغيّر ذلك. إنه يضم قدرات AI قوية — الترجمة، تخطيط المهام، معالجة النصوص — في عدد قليل من نقاط النهاية REST النظيفة. قم بتحميل جدول بيانات أو أرسل نصًا خامًا، واحصل على نتائج ذكية. لا استضافة نموذج، لا هندسة موجهات، لا بنية تحتية تحتاج صيانة.

تستعرض هذه المقالة ثلاثة واجهات برمجة تطبيقات أساسية يجب على كل مطور معرفتها، مع أمثلة قابلة للتنفيذ في cURL, C#, and Python.

1. ماذا يفعل وحدة التحكم بالذكاء الاصطناعي؟

يقدم AIController (المصدر: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) واجهات برمجة تطبيقات لمعالجة الجداول النصية المدعومة بالذكاء الاصطناعي. يتعامل مع ثلاثة سيناريوهات أساسية:

جميع نقاط النهاية تستخدم البادئة v4.0/cells/ai/... وتحتاج إلى مصادقة OAuth 2.0 عبر لوحة تحكم Aspose Cloud.

2. قبل البدء

1. الحصول على بيانات الاعتماد: سجّل في Aspose Cloud Dashboard، أنشئ تطبيقًا، واحصل على Client ID و Client Secret.
2. تثبيت SDK (اختياري — cURL يعمل بشكل جيد أيضًا):

<!-- .NET -->
<PackageReference Include="Aspose.Cells-Cloud" Version="25.x" />

# Python
pip install asposecellscloud

3. نقطة النهاية 1: تفكيك مهمة الذكاء الاصطناعي

المسار: PUT /v4.0/cells/ai/task/decompose

تستقبل هذه النقطة النهاية وصفًا بلغة طبيعية لمشروع أو قائمة مهام، ثم تستخدم الذكاء الاصطناعي لتقسيمه إلى خطة منظمة وفقًا لمعايير SMART. يكون الناتج ملف Excel منسق يحتوي على الأعمدة: ID, Subject, Assignee, Estimated Duration, Description, Dependencies.

إنه مثالي لمديري المشاريع الذين يرغبون في تحويل فكرة تقريبية (“بناء ميزة جديدة مع الواجهة الخلفية، الواجهة الأمامية، والاختبار”) إلى قائمة مهام جاهزة للاستيراد لأدوات مثل Redmine أو Jira أو Trello.

cURL

# Get token
curl -X POST "https://api.aspose.cloud/connect/token" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

# Decompose a task
curl -X PUT "https://api.aspose.cloud/v4.0/cells/ai/task/decompose" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '"Build a user authentication system with login, registration, password reset, and OAuth integration. Estimate 40 hours total."' \
  -o tasks.xlsx

C# / .NET

using Aspose.Cells.Cloud.SDK.Api;

var cellsApi = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

string taskDescription = "Build a user authentication system with login, registration, " +
    "password reset, and OAuth integration. Estimate 40 hours total.";

// The API returns an Excel file stream with the structured task plan
using Stream result = cellsApi.DecomposeUserTask(taskDescription);
using var outFile = File.Create("tasks.xlsx");
result.CopyTo(outFile);

Console.WriteLine("Task plan generated: tasks.xlsx");

بايثون

from asposecellscloud.apis.cells_api import CellsApi
import os

instance = CellsApi(
    os.getenv('CellsCloudClientId'),
    os.getenv('CellsCloudClientSecret'))

task_description = (
    "Build a user authentication system with login, registration, "
    "password reset, and OAuth integration. Estimate 40 hours total."
)

# Returns an Excel file with structured task breakdown
result = instance.decompose_user_task(task_description)
with open("tasks.xlsx", "wb") as f:
    f.write(result.read())

print("Task plan saved to tasks.xlsx")

ما ستحصل عليه: ملف Excel يحتوي على جدول منسق بشكل احترافي — كل صف هو مهمة فرعية مع ساعات مقدرة، اقتراحات للمُكلف، وروابط الاعتماد.

4. نقطة النهاية 2: ترجمة جدول البيانات

المسار: PUT /v4.0/cells/ai/translate/spreadsheet

يترجم جميع محتوى النص في جدول بيانات إلى لغة مستهدفة. يحافظ الذكاء الاصطناعي على مواضع الخلايا، الصيغ، التنسيق، وبنية الأوراق المتعددة. يتم ترجمة النص القابل للقراءة من قبل الإنسان فقط — الصيغ مثل =SUM(A1:A10) تبقى كما هي.

اللغات المستهدفة المدعومة تستخدم رموز ISO القياسية: es (الإسبانية)، fr (الفرنسية)، de (الألمانية)، zh (الصينية)، ja (اليابانية)، إلخ.

cURL

# Translate an Excel file from English to Spanish
curl -X PUT "https://api.aspose.cloud/v4.0/cells/ai/translate/spreadsheet?targetLanguage=es" \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@report.xlsx" \
  -o report_translated.xlsx

C# / .NET

using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Request;

var cellsApi = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

var request = new TranslateSpreadsheetRequest(
    spreadsheet: "report.xlsx",
    targetLanguage: "fr");  // Translate to French

using Stream result = cellsApi.TranslateSpreadsheet(request);
using var outFile = File.Create("report_translated.xlsx");
result.CopyTo(outFile);

بايثون

from asposecellscloud.apis.cells_api import CellsApi
import os

instance = CellsApi(
    os.getenv('CellsCloudClientId'),
    os.getenv('CellsCloudClientSecret'))

# Translate to German
with open("report.xlsx", "rb") as f:
    result = instance.translate_spreadsheet(
        file=f,
        target_language="de",
        local_outpath="report_translated.xlsx")

print("Translated file saved.")

الفائدة الرئيسية: يتم دعم دفاتر العمل متعددة الأوراق بالكامل. يتم تسمية ملف الإخراج تلقائيًا بـ {original}_translated.{ext}.

5. نقطة النهاية 3: ترجمة ملف نصي

المسار: PUT /v4.0/cells/ai/translate/text-file

يقوم بترجمة محتوى النص العادي — إما عن طريق تحميله كملف أو إرساله مباشرة في جسم الطلب. مفيد لترجمة المستندات والملاحظات ومحتوى CSV أو أي بيانات نصية.

وضعا الإدخال:

• رفع الملف: أرسل ملف .txt عبر multipart/form-data → احصل على ملف .txt مترجم مرة أخرى
• نص مباشر: أرسل نصًا خامًا في جسم الطلب → احصل على النص المترجم في الاستجابة

cURL (تحميل ملف)

curl -X PUT "https://api.aspose.cloud/v4.0/cells/ai/translate/text-file?targetLanguage=ja" \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@readme.txt" \
  -o readme_translated.txt

cURL (النص المباشر)

curl -X PUT "https://api.aspose.cloud/v4.0/cells/ai/translate/text-file?targetLanguage=zh" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: text/plain" \
  -d "Hello, welcome to our product documentation. This guide covers setup and configuration."

يتضمن جسم الاستجابة النص المترجم مباشرة.

بايثون

# File upload mode
with open("readme.txt", "rb") as f:
    result = instance.translate_text_file(
        file=f,
        target_language="ko",
        local_outpath="readme_translated.txt")

# Direct text mode
result = instance.translate_text_content(
    content="Hello world, this is a test.",
    target_language="fr")
print(result)  # Prints translated text

6. دليل سريع: ترجمة تقرير متعدد الجنسيات

تخيل أن لديك تقريرًا ماليًا باللغة الإنجليزية (Q3_Report.xlsx) يحتاج إلى توزيعه على الفرق في إسبانيا وفرنسا وألمانيا.

الخطوة 1: ترجم إلى الإسبانية:

curl -X PUT "https://api.aspose.cloud/v4.0/cells/ai/translate/spreadsheet?targetLanguage=es" \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@Q3_Report.xlsx" \
  -o Q3_Report_es.xlsx

الخطوة 2: ترجمة إلى الفرنسية:

curl -X PUT "https://api.aspose.cloud/v4.0/cells/ai/translate/spreadsheet?targetLanguage=fr" \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@Q3_Report.xlsx" \
  -o Q3_Report_fr.xlsx

الخطوة 3: ترجم إلى الألمانية:

curl -X PUT "https://api.aspose.cloud/v4.0/cells/ai/translate/spreadsheet?targetLanguage=de" \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@Q3_Report.xlsx" \
  -o Q3_Report_de.xlsx

ثلاثة أوامر، ثلاثة تقارير محلية — جميعها مع الحفاظ على الصيغ والتنسيق. هذا هو قوة ترجمة جداول البيانات المدفوعة بالذكاء الاصطناعي.

7. الفوائد الرئيسية

• بنية تحتية للذكاء الاصطناعي صفرية: لا نماذج لاستضافتها، ولا وحدات معالجة رسومية لتوفيرها. يعمل الذكاء الاصطناعي على سحابة Aspose.
• الحفاظ على الهيكل: الترجمة لا تفسد جدول البيانات الخاص بك — الصيغ، والرسوم البيانية، والتخطيط يبقى كما هو.
• إدخال مرن: قبول كل من تحميل الملفات والنص الخام لتحقيق أقصى توافق.
• تخطيط المشروع في ثوانٍ: تحويل أوصاف المهام الغامضة إلى خطط منظمة قابلة للتعيين.
• دعم SDK: مجموعات تطوير البرمجيات الرسمية لـ .NET و Python و Java — أو استخدم REST بسيط مع cURL.

8. معالجة الأخطاء

تحقق دائمًا من حالة الاستجابة وتعامل مع الأخطاء بلطف في كود الإنتاج.

9. ما التالي؟

يتوفر في وحدة التحكم AI ثلاثة نقاط نهاية أكثر قوة للسيناريوهات المتقدمة:

• ai/report/analysis — يقوم تلقائيًا بتحليل بيانات جداول البيانات وإنشاء تقارير Markdown احترافية
• ai/summarize/spreadsheet — ينشئ ملخصات ذكية لمصنفات كبيرة
• ai/categorize/spreadsheet — يصنّف بيانات الأعمدة إلى مجموعات منطقية (مثال: تصنيف النفقات)

بالإضافة إلى ذلك، يمكنك إحضار نقطة النهاية الذكية الخاصة بك (DeepSeek، خدمات مخصصة متوافقة مع OpenAI) للترجمة. كل هذا مغطى في الدليل المتقدم.

ابدأ الآن: احصل على بيانات الاعتماد الخاصة بك من لوحة تحكم Aspose Cloud وشغّل الأمثلة أعلاه. ستحصل على معالجة جداول البيانات المدعومة بالذكاء الاصطناعي في دقائق.