Tabellenkalkulationen in intelligente Arbeit verwandeln: Ein Entwicklerleitfaden für den Aspose.Cells Cloud AI Controller

Fügen Sie Ihrer Tabellenkalkulations-Workflow KI-gestützte Übersetzung, Aufgabenzerlegung und Textverarbeitung hinzu — mit einfachen REST-Aufrufen, ohne ML-Expertise.

Jedes Entwicklungsteam stößt auf dasselbe Problem: Tabellendaten müssen übersetzt, zusammengefasst, kategorisiert oder neu organisiert werden, bevor sie für nachgelagerte Systeme nützlich sind. Traditionell bedeutete das benutzerdefinierte Skripte, anfällige Regex‑Ketten oder teure manuelle Arbeit.

Aspose.Cells Cloud AI Controller ändert das. Es bündelt leistungsstarke KI‑Funktionen — Übersetzung, Aufgabenplanung, Textverarbeitung — in eine Handvoll sauberer REST‑Endpunkte. Laden Sie eine Tabellenkalkulation hoch oder senden Sie Rohtext und erhalten Sie intelligente Ergebnisse zurück.

Dieser Beitrag führt durch die drei grundlegenden APIs, die jeder Entwickler kennen sollte, mit ausführbaren Beispielen in cURL, C# und Python.

1. Was macht der AI-Controller?

Der AIController (Quelle: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) bietet KI-gestützte Tabellenkalkulations- und Textverarbeitungs-APIs. Er behandelt drei Kernszenarien:

Alle Endpunkte verwenden das Präfix v4.0/cells/ai/... und erfordern OAuth 2.0‑Authentifizierung über das Aspose Cloud dashboard.

2. Vor dem Start

1. Anmeldeinformationen erhalten: Registrieren Sie sich im Aspose Cloud Dashboard, erstellen Sie eine Anwendung und holen Sie sich Ihre Client ID und Client Secret.
2. Ein SDK installieren (optional — cURL funktioniert ebenfalls gut):

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

# Python
pip install asposecellscloud

3. Endpunkt 1: KI-Aufgabenzerlegung

Route: PUT /v4.0/cells/ai/task/decompose

Dieser Endpunkt nimmt eine natürlichsprachliche Beschreibung eines Projekts oder einer Aufgabenliste entgegen und verwendet KI, um sie in einen strukturierten Plan nach SMART‑Kriterien zu zerlegen. Die Ausgabe ist eine formatierte Excel‑Datei mit den Spalten: ID, Subject, Assignee, Estimated Duration, Description, Dependencies.

Es ist perfekt für Projektmanager, die eine grobe Idee („eine neue Funktion mit Backend, Frontend und Tests entwickeln“) in eine sofort importierbare Aufgabenliste für Tools wie Redmine, Jira oder Trello umwandeln möchten.

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

Was Sie erhalten: Eine Excel-Datei mit einer professionell formatierten Tabelle — jede Zeile ist eine Unteraufgabe mit geschätzten Stunden, Vorschlägen für den Bearbeiter und Abhängigkeitslinks.

4. Endpoint 2: Tabellenkalkulation Übersetzung

Route: PUT /v4.0/cells/ai/translate/spreadsheet

Übersetzt alle Textinhalte in einer Tabellenkalkulation in eine Zielsprache. Die KI bewahrt Zellpositionen, Formeln, Formatierungen und die Mehrblattstruktur. Nur der menschenlesbare Text wird übersetzt — Formeln wie =SUM(A1:A10) bleiben unverändert.

Unterstützte Zielsprachen verwenden standardisierte ISO‑Codes: es (Spanisch), fr (Französisch), de (Deutsch), zh (Chinesisch), ja (Japanisch), usw.

cURL

Übersetzen einer Excel-Datei von Englisch nach Spanisch

# 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);

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

Hauptvorteil: Mehrblättrige Arbeitsmappen werden vollständig unterstützt. Die Ausgabedatei wird automatisch {original}_translated.{ext} benannt.

5. Endpunkt 3: Textdatei-Übersetzung

Route: PUT /v4.0/cells/ai/translate/text-file

Übersetzt einfachen Textinhalt — entweder als Datei hochgeladen oder direkt im Anforderungstext gesendet. Nützlich zum Übersetzen von Dokumentationen, Notizen, CSV‑Inhalten oder jeglichen textbasierten Daten.

Zwei Eingabemodi:

• Datei-Upload: Senden Sie eine .txt-Datei über multipart/form-data → erhalten Sie eine übersetzte .txt-Datei zurück
• Direkter Text: Senden Sie Rohtext im Anforderungstext → erhalten Sie den übersetzten Text in der Antwort

cURL (Datei-Upload)

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 (Direkter Text)

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. Schneller Überblick: Übersetzen eines multinationalen Berichts

Stellen Sie sich vor, Sie haben einen Finanzbericht auf Englisch (Q3_Report.xlsx), der an Teams in Spanien, Frankreich und Deutschland verteilt werden muss.

Step 1: Übersetze ins Spanische:

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

Schritt 2: Übersetzen ins Französische:

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

Schritt 3: Übersetzen Sie ins Deutsche:

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

Drei Befehle, drei lokalisierte Berichte — alles mit erhaltenen Formeln und Formatierungen. Das ist die Kraft der KI‑gesteuerten Tabellenkalkulationsübersetzung.

7. Hauptvorteile

• Zero AI infrastructure: Keine Modelle zum Hosten, keine GPUs zum Bereitstellen. Die KI läuft auf Aspose’s cloud.
• Structure preservation: Die Übersetzung beschädigt nicht Ihre Tabelle — Formeln, Diagramme und Layout bleiben unverändert.
• Flexible input: Akzeptiert sowohl Datei‑Uploads als auch Rohtext für maximale Kompatibilität.
• Project planning in seconds: Verwandeln Sie vage Aufgabenbeschreibungen in strukturierte, zuweisbare Pläne.
• SDK support: Offizielle SDKs für .NET, Python und Java — oder verwenden Sie reines REST mit cURL.

8. Fehlerbehandlung

Überprüfen Sie stets den Antwortstatus und behandeln Sie Fehler in Produktionscode elegant.

9. Was kommt als Nächstes?

Der AI Controller hat drei weitere leistungsstarke Endpunkte für erweiterte Szenarien:

• ai/report/analysis — Analysiert automatisch Tabellendaten und erstellt professionelle Markdown-Berichte
• ai/summarize/spreadsheet — Erstellt intelligente Zusammenfassungen großer Arbeitsmappen
• ai/categorize/spreadsheet — Klassifiziert Spaltendaten in logische Gruppen (z. B. Ausgabenkategorisierung)

Zusätzlich können Sie Ihren eigenen KI-Endpunkt (DeepSeek, benutzerdefinierte OpenAI‑kompatible Dienste) für die Übersetzung nutzen. All dies wird im Erweiterten Leitfaden behandelt.

Jetzt loslegen: holen Sie Ihre Zugangsdaten vom Aspose Cloud Dashboard und führen Sie die obigen Beispiele aus. Sie haben in wenigen Minuten KI‑gestützte Tabellenkalkulationsverarbeitung.