Gør regneark til intelligent arbejde: En udviklers guide til Aspose.Cells Cloud AI Controller

Tilføj AI-drevet oversættelse, opgavedekomponering og tekstbehandling til dit regnearksarbejdsgang — med enkle REST‑kald, ingen ML‑ekspertise påkrævet.

Hvert udviklingsteam støder på den samme udfordring: regnearksdata skal oversat, opsummeret, kategoriseret eller omorganiseret før de er nyttige for efterfølgende systemer. Traditionelt betød det brugerdefinerede scripts, skrøbelige regex‑kæder eller dyrt manuelt arbejde.

Aspose.Cells Cloud AI Controller ændrer det. Den indkapsler kraftfulde AI-funktioner — oversættelse, opgaveplanlægning, tekstbehandling — i en håndfuld rene REST-endpoints. Upload et regneark eller send rå tekst, og få intelligente resultater tilbage. Ingen modelhosting, ingen prompt‑engineering, ingen infrastruktur at vedligeholde.

Dette indlæg gennemgår de tre grundlæggende API’er, som enhver udvikler bør kende, med kørbare eksempler i cURL, C# og Python.

1. Hvad gør AI-controlleren?

AIController (kilde: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) leverer AI‑drevne regnearks‑ og tekstbehandlings‑API’er. Den håndterer tre kernescenarier:

Alle endepunkter bruger præfikset v4.0/cells/ai/... og kræver OAuth 2.0-godkendelse via Aspose Cloud-dashboardet.

2. Før du begynder

1. Få legitimationsoplysninger: Registrer dig på Aspose Cloud Dashboard, opret en applikation, og hent din Client ID og Client Secret.
2. Installer et SDK (valgfrit — cURL fungerer også fint):

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

# Python
pip install asposecellscloud

3. Endpoint 1: AI Opgavedekomposition

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

Dette endpoint tager en naturlig sprogbeskrivelse af et projekt eller en opgaveliste og bruger derefter AI til at opdele den i en struktureret plan, der følger SMART‑kriterierne. Outputtet er en formateret Excel‑fil med kolonnerne: ID, Subject, Assignee, Estimated Duration, Description, Dependencies.

Det er perfekt for projektledere, der ønsker at omsætte en grov idé (“byg en ny funktion med backend, frontend og test”) til en klar‑til‑import opgaveliste til værktøjer som Redmine, Jira eller 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")

Hvad du får: En Excel-fil med en professionelt formateret tabel — hver række er en delopgave med estimerede timer, forslag til tildeling og afhængighedslinks.

4. Endpoint 2: Regnearksoversættelse

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

Oversætter alt tekstindhold i et regneark til et målsprog. AI’en bevarer cellepositioner, formler, formatering og flerside‑struktur. Kun den menneskelæselige tekst bliver oversat — formler som =SUM(A1:A10) forbliver intakte.

Understøttede målsprog bruger standard ISO‑koder: es (spansk), fr (fransk), de (tysk), zh (kinesisk), ja (japansk), etc.

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

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

Nøglefordel: Arbejdsbøger med flere ark understøttes fuldt ud. Outputfilen får navnet {original}_translated.{ext} automatisk.

5. Endpoint 3: Tekstfiloversættelse

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

Oversætter almindeligt tekstindhold — enten uploadet som en fil eller sendt direkte i anmodningens brødtekst. Praktisk til at oversætte dokumentation, noter, CSV‑indhold eller al tekstbaseret data.

To inputtilstande:

• Filupload: Send en .txt fil via multipart/form-data → få en oversat .txt fil tilbage
• Direkte tekst: Send rå tekst i anmodningens krop → få oversat tekst i svaret

cURL (Filupload)

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 (Direkte tekst)

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. Hurtig gennemgang: Oversæt en multinational rapport

Forestil dig, at du har en finansiel rapport på engelsk (Q3_Report.xlsx), som skal distribueres til teams i Spanien, Frankrig og Tyskland.

Trin 1: Oversæt til spansk:

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

Trin 2: Oversæt til fransk:

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

Trin 3: Oversæt til tysk:

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

Tre kommandoer, tre lokaliserede rapporter — alle med formler og formatering bevaret. Det er kraften i AI-drevet regnearksoversættelse.

7. Nøglefordele

• Ingen AI-infrastruktur: Ingen modeller at hoste, ingen GPU’er at provisionere. AI’en kører på Aspose’s cloud.
• Strukturbeskyttelse: Oversættelsen ødelægger ikke dit regneark — formler, diagrammer og layout forbliver intakte.
• Fleksibel input: Accepter både filuploads og rå tekst for maksimal kompatibilitet.
• Projektplanlægning på sekunder: Omformulér vage opgavebeskrivelser til strukturerede, tildelbare planer.
• SDK-understøttelse: Officielle SDK’er til .NET, Python og Java — eller brug ren REST med cURL.

8. Fejlhåndtering

Kontroller altid svarstatussen og håndter fejl på en elegant måde i produktionskode.

9. Hvad er næste?

AI Controller har tre yderligere kraftfulde slutpunkter til avancerede scenarier:

• ai/report/analysis — Analyserer automatisk regnearksdata og genererer professionelle Markdown‑rapporter
• ai/summarize/spreadsheet — Opretter intelligente sammendrag af store arbejdsbøger
• ai/categorize/spreadsheet — Klassificerer kolonnedata i logiske grupper (f.eks. udgiftskategorisering)

Desuden kan du bringe din egen AI-endpoint (DeepSeek, tilpassede OpenAI-kompatible tjenester) til oversættelse. Alt dette er dækket i Avanceret guide.

Kom i gang nu: hent dine legitimationsoplysninger fra Aspose Cloud Dashboard og kør eksemplerne ovenfor. Du får AI-drevet regnearksbehandling på få minutter.