تبدیل صفحات گسترده به کار هوشمند: راهنمای توسعه‌دهنده برای Aspose.Cells Cloud AI Controller

ترجمه مبتنی بر هوش مصنوعی، تجزیه وظایف و پردازش متن را به جریان کار صفحه‌گسترده خود اضافه کنید — با تماس‌های ساده REST، بدون نیاز به تخصص در یادگیری ماشین.

هر تیم توسعه‌ای به همان مانع برمی‌خورد: داده‌های صفحه‌گسترده باید ترجمه، خلاصه‌سازی، دسته‌بندی یا بازسازی شوند تا برای سیستم‌های پایین‌دست مفید باشند. به‌طور سنتی، این به معنای اسکریپت‌های سفارشی، زنجیره‌های شکنندهٔ regex یا کار دستی گران‌قیمت بود.

Aspose.Cells Cloud AI Controller این را تغییر می‌دهد. این قابلیت‌های قدرتمند هوش مصنوعی — ترجمه، برنامه‌ریزی وظایف، پردازش متن — را در چندین نقطه انتهایی REST تمیز می‌پیچد. یک صفحه‌گسترده را بارگذاری کنید یا متن خام ارسال کنید و نتایج هوشمندانه را دریافت کنید. هیچ میزبانی مدل، هیچ مهندسی پرامپت، هیچ زیرساختی برای نگهداری نیست.

این پست به بررسی سه API پایه‌ای می‌پردازد که هر توسعه‌دهنده باید آن‌ها را بداند، همراه با مثال‌های قابل اجرا در cURL, C#, and Python.

1. کنترلر هوش مصنوعی چه کاری انجام می‌دهد؟

کنترلر AIController (منبع: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) APIهای پردازش صفحه‌گسترده و متن مبتنی بر هوش مصنوعی را فراهم می‌کند. این کنترلر سه سناریوی اصلی را مدیریت می‌کند:

تمام نقاط انتهایی از پیشوند 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.

این برای مدیران پروژه‌ای که می‌خواهند یک ایدهٔ خام (“ساخت یک ویژگی جدید با backend، frontend و testing”) را به یک فهرست کار آماده برای وارد کردن در ابزارهایی مانند 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

مرحله ۲: به فرانسوی ترجمه کنید:

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. مزایای کلیدی

• زیرساخت صفر AI: هیچ مدلی برای میزبانی وجود ندارد، هیچ GPU‌ای برای فراهم‌سازی نیست. هوش مصنوعی بر روی ابر Aspose اجرا می‌شود.
• حفظ ساختار: ترجمه باعث خراب شدن صفحه‌گسترده شما نمی‌شود — فرمول‌ها، نمودارها و چیدمان به همان شکل باقی می‌مانند.
• ورودی انعطاف‌پذیر: هر دو بارگذاری فایل و متن خام را برای بیشترین سازگاری می‌پذیرد.
• برنامه‌ریزی پروژه در ثانیه‌ها: توصیفات مبهم وظایف را به برنامه‌های ساختاریافته و قابل تخصیص تبدیل می‌کند.
• پشتیبانی SDK: SDKهای رسمی برای .NET، Python و Java — یا می‌توانید از REST ساده با cURL استفاده کنید.

8. مدیریت خطا

همیشه وضعیت پاسخ را بررسی کنید و خطاها را به‌صورت ملایم در کد تولیدی مدیریت کنید.

9. چه کار بعدی؟

کنترلر AI دارای سه نقطه انتهایی قدرتمندتر برای سناریوهای پیشرفته است:

• ai/report/analysis — به‌صورت خودکار داده‌های صفحه‌گسترده را تجزیه و تحلیل می‌کند و گزارش‌های حرفه‌ای Markdown تولید می‌نماید
• ai/summarize/spreadsheet — خلاصه‌های هوشمندانه‌ای از کتاب‌های کاری بزرگ ایجاد می‌کند
• ai/categorize/spreadsheet — داده‌های ستون را به گروه‌های منطقی دسته‌بندی می‌کند (مثلاً دسته‌بندی هزینه‌ها)

به‌علاوه، می‌توانید نقطه انتهایی AI خود را بیاورید (DeepSeek، سرویس‌های سفارشی سازگار با OpenAI) برای ترجمه. تمام این موارد در راهنمای پیشرفته پوشش داده شده‌اند.

همین حالا شروع کنید: اعتبارهای خود را از Aspose Cloud Dashboard دریافت کنید و مثال‌های بالا را اجرا کنید. در عرض چند دقیقه پردازش صفحه‌گسترده با هوش مصنوعی خواهید داشت.