הפוך גיליונות אלקטרוניים לעבודה חכמה: מדריך למפתחים ל‑Aspose.Cells Cloud AI Controller

הוסף תרגום מבוסס AI, פירוק משימות ועיבוד טקסט לתהליך העבודה של הגיליון האלקטרוני שלך — עם קריאות REST פשוטות, ללא צורך במומחיות ML.

כל צוות פיתוח נתקל באותה בעיה: נתוני גיליון אלקטרוני צריכים להיות מתורגמים, מתומצתים, מתוייגים, או מארגנים מחדש לפני שהם שימושיים למערכות המשנה. באופן מסורתי, זאת משמעותה סקריפטים מותאמים, שרשראות regex שבירות, או עבודה ידנית יקרה.

Aspose.Cells Cloud AI Controller משנה זאת. הוא עוטף יכולות AI חזקות — תרגום, תכנון משימות, עיבוד טקסט — למספר מועט של נקודות קצה REST נקיות. העלה גיליון אלקטרוני או שלח טקסט גולמי, וקבל תוצאות חכמות בחזרה. ללא אירוח מודלים, ללא הנדסת פרומפטים, ללא תשתית לתחזוקה.

פוסט זה מסביר את שלוש ה-API הבסיסיות שכל מפתח צריך לדעת, עם דוגמאות שניתן להריץ ב-cURL, C#, ו-Python.

1. מה עושה בקר AI?

ה-AIController (מקור: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) מספק API-ים של גיליונות אלקטרוניים ועיבוד טקסט המופעלים על ידי AI. הוא מטפל בשלושה תרחישים מרכזיים:

כל נקודות הקצה משתמשות בקידומת 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: פירוק משימת AI

נתיב: PUT /v4.0/cells/ai/task/decompose

קצה זה מקבל תיאור בשפה טבעית של פרויקט או רשימת משימות, ואז משתמש ב‑AI כדי לפרק אותו לתוכנית מובנית בהתאם לקריטריונים של 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

מתרגם את כל תוכן הטקסט בגיליון אל שפה יעד. ה‑AI משמר מיקומי תאים, נוסחאות, עיצוב ומבנה ריבוי גיליונות. רק הטקסט הקריא לבני אדם מתורגם — נוסחאות כמו =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

Step 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

שלוש פקודות, שלושה דוחות מקומיים — כולם עם נוסחאות ועיצוב שמורים. זה הכוח של תרגום גיליונות אלקטרוניים מבוסס AI.

7. יתרונות מרכזיים

• תשתית AI אפס: אין מודלים לארח, אין GPUs לפריסה. ה‑AI פועל בענן של Aspose.
• שמירת מבנה: תרגום אינו פוגע בגליון האלקטרוני שלך — נוסחאות, גרפים ועיצוב נשארים ללא שינוי.
• קלט גמיש: מקבל גם העלאות קבצים וגם טקסט גולמי לתאימות מרבית.
• תכנון פרויקט בשניות: ממיר תיאורי משימות מעורפלים לתוכניות מובנות שניתן להקצות.
• תמיכה ב‑SDK: SDK רשמיים ל‑.NET, Python ו‑Java — או להשתמש ב‑REST פשוט עם cURL.

8. טיפול בשגיאות

תמיד בדקו את סטטוס התגובה וטפלו בשגיאות בצורה אלגנטית בקוד ייצור.

9. מה הלאה?

ל‑AI Controller יש שלושה קצות קצה חזקים יותר לתרחישים מתקדמים:

• ai/report/analysis — מנתח באופן אוטומטי נתוני גיליונות אלקטרוניים ומייצר דוחות Markdown מקצועיים
• ai/summarize/spreadsheet — יוצר סיכומים חכמים של חוברות עבודה גדולות
• ai/categorize/spreadsheet — מסווג נתוני עמודות לקבוצות לוגיות (למשל, סיווג הוצאות)

בנוסף, אתה יכול להביא את נקודת הקצה של AI שלך (DeepSeek, שירותים מותאמים תואמים ל‑OpenAI) לתרגום. כל זה מכוסה במדריך מתקדם.

התחל עכשיו: קח את האישורים שלך מ-Aspose Cloud Dashboard והפעל את הדוגמאות למעלה. יהיה לך עיבוד גיליונות אלקטרוניים עם AI תוך דקות.