A táblázatok átalakítása intelligens munkává: Fejlesztői útmutató az Aspose.Cells Cloud AI Controller-hez

Adjon AI-alapú fordítást, feladatlebontást és szövegfeldolgozást a táblázatkezelő munkafolyamatához — egyszerű REST hívásokkal, ML szakértelem nélkül.

Minden fejlesztőcsapat ugyanabba a falba ütközik: a táblázat adatait lefordítani, összefoglalni, kategorizálni vagy újraszervezni kell, mielőtt hasznosak lennének a downstream rendszerek számára. Hagyományosan ez egyedi szkripteket, törékeny regex láncokat vagy drága manuális munkát jelentett.

Aspose.Cells Cloud AI Controller megváltoztatja ezt. Erőteljes AI képességeket — fordítás, feladattervezés, szövegfeldolgozás — csomagol egy marék tiszta REST végpontra. Tölts fel egy táblázatot vagy küldj nyers szöveget, és kapj intelligens eredményeket vissza. Nincs modellhosztolás, nincs prompt tervezés, nincs karbantartandó infrastruktúra.

Ez a bejegyzés áttekinti a három alapvető API-t, amelyet minden fejlesztőnek ismernie kell, futtatható példákkal cURL, C# és Python nyelven.

1. Mit csinál az AI vezérlő?

Az AIController (forrás: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) AI-alapú táblázatkezelő és szövegfeldolgozó API-kat biztosít. Három fő forgatókönyvet kezel:

Minden végpont a v4.0/cells/ai/... előtagot használja, és OAuth 2.0 hitelesítést igényel az Aspose Cloud irányítópulton keresztül.

2. Mielőtt elkezdenél

1. Szerezze be a hitelesítő adatokat: Regisztráljon a Aspose Cloud Dashboard oldalon, hozzon létre egy alkalmazást, és szerezze meg a Client ID és Client Secret értékeit.
2. Telepítsen egy SDK-t (opcionális — a cURL is megfelelő):

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

# Python
pip install asposecellscloud

3. Végpont 1: AI feladatdekompozíció

Útvonal: PUT /v4.0/cells/ai/task/decompose

Ez a végpont egy természetes nyelvű leírást fogad egy projektről vagy feladatlistáról, majd AI-t használva lebontja azt egy strukturált tervre a SMART kritériumok szerint. A kimenet egy formázott Excel‑fájl, amely a következő oszlopokat tartalmazza: ID, Subject, Assignee, Estimated Duration, Description, Dependencies.

Tökéletes azoknak a projektmenedzsereknek, akik egy durva ötletet (“build a new feature with backend, frontend, and testing”) szeretnének egy importálásra kész feladatlistává alakítani a Redmine, Jira vagy Trellohez hasonló eszközök számára.

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

Mit kapsz: Egy Excel-fájl egy professzionálisan formázott táblázattal — minden sor egy alfeladat, becsült órákkal, felelős javaslatokkal és függőségi hivatkozásokkal.

4. Végpont 2: Táblázat fordítás

Útvonal: PUT /v4.0/cells/ai/translate/spreadsheet

Lefordítja a minden szöveges tartalmat egy táblázatban a célnyelvre. Az AI megőrzi a cellák pozícióját, a képleteket, a formázást és a többlapos struktúrát. Csak az ember által olvasható szöveg kerül lefordításra — a =SUM(A1:A10) képletek érintetlenek maradnak.

A támogatott célnyelvek szabványos ISO kódokat használnak: es (spanyol), fr (francia), de (német), zh (kínai), ja (japán), stb.

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

Kulcsfontosságú előny: A több lapos munkafüzetek teljes mértékben támogatottak. A kimeneti fájlt a rendszer automatikusan {original}_translated.{ext} névre nevezi.

5. Endpoint 3: Szövegfájl fordítás

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

Egyszerű szöveges tartalmat fordít — akár fájlként feltöltve, akár közvetlenül a kérés törzsében elküldve. Hasznos dokumentációk, jegyzetek, CSV tartalom vagy bármilyen szöveges adat fordításához.

Két bemeneti mód:

• Fájl feltöltés: Küldjön egy .txt fájlt multipart/form-data formátumban → kapjon egy lefordított .txt fájlt vissza
• Közvetlen szöveg: Küldjön nyers szöveget a kérés törzsében → kapjon lefordított szöveget a válaszban

cURL (Fájl feltöltés)

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 (Közvetlen szöveg)

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

A válasz törzse közvetlenül tartalmazza a lefordított szöveget.

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. Gyors áttekintés: Multinacionális jelentés lefordítása

Képzeld el, hogy van egy pénzügyi jelentésed angolul (Q3_Report.xlsx), amelyet Spanyolország, Franciaország és Németország csapataihoz kell eljuttatni.

1. lépés: Fordítsa le spanyolra:

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. lépés: Fordítsa franciára:

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. lépés: Fordítsa le németre:

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

Három parancs, három lokalizált jelentés — mindegyik a képletekkel és a formázással megőrizve. Ez az AI-alapú táblázatfordítás ereje.

7. Fő előnyök

• Zero AI infrastruktúra: Nincsenek modellek a hosztoláshoz, nincs GPU a biztosításhoz. Az AI az Aspose’s cloud-en fut.
• Struktúra megőrzése: A fordítás nem rombolja a táblázatot — képletek, diagramok és elrendezés változatlan marad.
• Rugalmas bemenet: Elfogadja a fájlfeltöltéseket és a nyers szöveget is a maximális kompatibilitás érdekében.
• Projekttervezés másodpercek alatt: Átalakítja a homályos feladatleírásokat strukturált, kiosztható tervekké.
• SDK támogatás: Hivatalos SDK-k .NET, Python és Java számára — vagy használhat egyszerű REST-et cURL-lel.

8. Hibakezelés

Mindig ellenőrizze a válasz állapotát, és kezelje a hibákat megfelelően a termelési kódban.

9. Mi a következő?

Az AI vezérlőnek három további erőteljes végpontja van fejlett forgatókönyvekhez:

• ai/report/analysis — Automatikusan elemzi a táblázat adatokat, és professzionális Markdown jelentéseket generál
• ai/summarize/spreadsheet — Intelligens összefoglalókat készít nagy munkafüzetekről
• ai/categorize/spreadsheet — Oszlopadatokat logikai csoportokba sorol (pl., költségkategorizálás)

Ráadásul hozd a saját AI végpontodat (DeepSeek, egyedi OpenAI-kompatibilis szolgáltatások) a fordításhoz. Mindez a Haladó útmutató-ban van lefedve.

Kezdje el most: szerezze be a hitelesítő adatait az Aspose Cloud Dashboard oldalról, és futtassa a fenti példákat. Néhány percen belül AI-alapú táblázatfeldolgozást kap.