Μετατρέψτε τα Φύλλα Εργασίας σε Έξυπνη Εργασία: Οδηγός Προγραμματιστή για το Aspose.Cells Cloud AI Controller

Προσθέστε μετάφραση με τεχνητή νοημοσύνη, αποσύνθεση εργασιών και επεξεργασία κειμένου στη ροή εργασίας του υπολογιστικού φύλλου σας — με απλές κλήσεις REST, χωρίς να απαιτείται εξειδίκευση ML.

Κάθε ομάδα ανάπτυξης αντιμετωπίζει το ίδιο πρόβλημα: τα δεδομένα των υπολογιστικών φύλλων πρέπει να μεταφραστούν, συνοψιστούν, κατηγοριοποιηθούν ή αναδιοργανωθούν πριν είναι χρήσιμα για τα downstream συστήματα. Παραδοσιακά, αυτό σήμαινε προσαρμοσμένα σενάρια, εύθραυστες αλυσίδες regex ή δαπανηρή χειροκίνητη εργασία.

Aspose.Cells Cloud AI Controller αλλάζει αυτό. Συμπεριλαμβάνει ισχυρές δυνατότητες AI — μετάφραση, προγραμματισμό εργασιών, επεξεργασία κειμένου — σε μια σειρά καθαρών REST endpoints. Ανεβάστε ένα υπολογιστικό φύλλο ή στείλτε ακατέργαστο κείμενο και λάβετε έξυπνα αποτελέσματα. Χωρίς φιλοξενία μοντέλου, χωρίς μηχανική προτροπών, χωρίς υποδομή προς συντήρηση.

Αυτή η ανάρτηση περιηγείται στις τρεις θεμελιώδεις API που πρέπει να γνωρίζει κάθε προγραμματιστής, με παραδείγματα εκτελέσιμα σε cURL, C# και Python.

1. Τι κάνει ο ελεγκτής AI;

Ο AIController (πηγή: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) παρέχει API επεξεργασίας λογιστικών φύλλων και κειμένου με τεχνητή νοημοσύνη. Διαχειρίζεται τρία βασικά σενάρια:

# Σενάριο Endpoint Τι κάνει
1 Αποσύνθεση Εργασίας PUT /v4.0/cells/ai/task/decompose Μετατρέπει μια περιγραφή εργασίας σε φυσική γλώσσα σε ένα δομημένο σχέδιο έργου (αρχείο Excel με ID, θέμα, υπεύθυνο, διάρκεια, εξαρτήσεις)
2 Μετάφραση Φύλλου Εργασίας PUT /v4.0/cells/ai/translate/spreadsheet Μεταφράζει όλο το κειμενικό περιεχόμενο σε ένα φύλλο εργασίας στη γλώσσα‑στόχο, διατηρώντας τη δομή, τους τύπους και τη μορφοποίηση
3 Μετάφραση Αρχείου Κειμένου PUT /v4.0/cells/ai/translate/text-file Μεταφράζει ακατέργαστο κείμενο ή αρχείο κειμένου στη γλώσσα‑στόχο — υποστηρίζει τόσο τη μεταφόρτωση αρχείου όσο και την άμεση εισαγωγή κειμένου

Όλα τα endpoints χρησιμοποιούν το πρόθεμα v4.0/cells/ai/... και απαιτούν έλεγχο ταυτότητας OAuth 2.0 μέσω του Aspose Cloud dashboard.


2. Πριν ξεκινήσετε

  1. Αποκτήστε διαπιστευτήρια: Εγγραφείτε στο Aspose Cloud Dashboard, δημιουργήστε μια Εφαρμογή και πάρτε το Client ID και το Client Secret σας.
  2. Εγκαταστήστε ένα SDK (προαιρετικό — cURL λειτουργεί επίσης καλά):
<!-- .NET -->
<PackageReference Include="Asprose.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");

Python

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

# Μετάφραση ενός αρχείου Excel από τα Αγγλικά στα Ισπανικά
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);

Python

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."

Python

# 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. Κύρια Οφέλη

  • Μηδενική υποδομή AI: Δεν υπάρχουν μοντέλα για φιλοξενία, δεν χρειάζονται GPUs. Η AI λειτουργεί στο cloud της Aspose.
  • Διατήρηση δομής: Η μετάφραση δεν διασπά το λογιστικό φύλλο σας — τύποι, γραφήματα και διάταξη παραμένουν αμετάβλητα.
  • Ευέλικτη εισαγωγή: Δέχεται τόσο μεταφορτώσεις αρχείων όσο και ακατέργαστο κείμενο για μέγιστη συμβατότητα.
  • Σχεδιασμός έργου σε δευτερόλεπτα: Μετατρέπει ασαφείς περιγραφές εργασιών σε δομημένα, εκχωρήσιμα σχέδια.
  • Υποστήριξη SDK: Επίσημα SDK για .NET, Python και Java — ή χρησιμοποιήστε απλό REST με cURL.

8. Διαχείριση Σφαλμάτων

Κατάσταση Σημασία Τυπική αιτία
400 Λάθος αίτημα Λείπει ή είναι άκυρη η targetLanguage, κενό περιεχόμενο ή εσφαλμένη περιγραφή εργασίας
401 Μη εξουσιοδοτημένο Αυθεντικοποίηση απέτυχε ή λείπουν διαπιστευτήρια
500 Σφάλμα διακομιστή Η υπηρεσία AI είναι προσωρινά μη διαθέσιμη ή υπάρχει σφάλμα επεξεργασίας λογιστικού φύλλου

Πάντα ελέγχετε την κατάσταση της απόκρισης και διαχειρίζεστε τα σφάλματα με χάρη στον κώδικα παραγωγής.

9. Τι ακολουθεί;

Ο ελεγκτής AI διαθέτει τρία ακόμη πιο ισχυρά endpoints για προχωρημένα σενάρια:

  • ai/report/analysis — Αναλύει αυτόματα τα δεδομένα των υπολογιστικών φύλλων και δημιουργεί επαγγελματικές αναφορές σε Markdown
  • ai/summarize/spreadsheet — Δημιουργεί έξυπνες περιλήψεις μεγάλων βιβλίων εργασίας
  • ai/categorize/spreadsheet — Κατηγοριοποιεί τα δεδομένα των στηλών σε λογικές ομάδες (π.χ., κατηγοριοποίηση εξόδων)

Επιπλέον, μπορείτε να φέρετε το δικό σας AI endpoint (DeepSeek, προσαρμοσμένες υπηρεσίες συμβατές με OpenAI) για μετάφραση. Όλα αυτά καλύπτονται στον Προηγμένος Οδηγός.

Ξεκινήστε τώρα: πάρτε τα διαπιστευτήριά σας από το Aspose Cloud Dashboard και εκτελέστε τα παραδείγματα παραπάνω. Θα έχετε επεξεργασία λογιστικών φύλλων με τεχνητή νοημοσύνη σε λίγα λεπτά.