Trasforma i fogli di calcolo in lavoro intelligente: Guida per sviluppatori al Aspose.Cells Cloud AI Controller

Aggiungi traduzione basata sull’IA, scomposizione dei compiti e elaborazione del testo al tuo flusso di lavoro dei fogli di calcolo — con semplici chiamate REST, senza necessità di competenze ML.

Ogni team di sviluppo si scontra con lo stesso ostacolo: i dati dei fogli di calcolo devono essere tradotti, riassunti, categorizzati o riorganizzati prima di essere utili per i sistemi a valle. Tradizionalmente, ciò significava script personalizzati, catene regex fragili o lavoro manuale costoso.

Aspose.Cells Cloud AI Controller cambia questo. Incapsula potenti capacità AI — traduzione, pianificazione di attività, elaborazione del testo — in una serie di endpoint REST puliti. Carica un foglio di calcolo o invia testo grezzo e ottieni risultati intelligenti.

Questo post illustra le tre API fondamentali che ogni sviluppatore dovrebbe conoscere, con esempi eseguibili in cURL, C# e Python.

1. Cosa fa il controller AI?

Il AIController (source: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) fornisce API per l’elaborazione di fogli di calcolo e testi basate su AI. Gestisce tre scenari principali:

Tutti gli endpoint utilizzano il prefisso v4.0/cells/ai/... e richiedono l’autenticazione OAuth 2.0 tramite la dashboard di Aspose Cloud.

2. Prima di iniziare

1. Ottieni le credenziali: Registrati al Aspose Cloud Dashboard, crea un’Applicazione e prendi il tuo Client ID e Client Secret.
2. Installa un SDK (opzionale — cURL funziona bene anche così):

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

# Python
pip install asposecellscloud

3. Endpoint 1: Decomposizione del compito AI

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

Questo endpoint accetta una descrizione in linguaggio naturale di un progetto o di un elenco di attività, quindi utilizza l’IA per scomporla in un piano strutturato secondo i criteri SMART. L’output è un file Excel formattato con le colonne: ID, Subject, Assignee, Estimated Duration, Description, Dependencies.

È perfetto per i project manager che desiderano trasformare un’idea grezza (“build a new feature with backend, frontend, and testing”) in un elenco di attività pronto per l’importazione in strumenti come Redmine, Jira o 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")

Cosa ottieni: Un file Excel con una tabella formattata professionalmente — ogni riga è un sotto‑compito con ore stimate, suggerimenti per l’assegnatario e collegamenti di dipendenza.

4. Endpoint 2: Traduzione del foglio di calcolo

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

Tradue tutto il contenuto testuale in un foglio di calcolo in una lingua di destinazione. L’IA conserva le posizioni delle celle, le formule, la formattazione e la struttura a più fogli. Solo il testo leggibile dall’uomo viene tradotto — le formule come =SUM(A1:A10) rimangono intatte.

Le lingue di destinazione supportate utilizzano i codici ISO standard: es (spagnolo), fr (francese), de (tedesco), zh (cinese), ja (giapponese), ecc.

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

Vantaggio principale: I workbook a più fogli sono pienamente supportati. Il file di output viene denominato automaticamente {original}_translated.{ext}.

5. Endpoint 3: Traduzione del file di testo

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

Traduce contenuti di testo semplice — sia caricati come file sia inviati direttamente nel corpo della richiesta. Utile per tradurre documentazione, note, contenuti CSV o qualsiasi dato basato su testo.

Due modalità di input:

• Caricamento file: Invia un file .txt tramite multipart/form-data → ricevi indietro un file .txt tradotto
• Testo diretto: Invia testo grezzo nel corpo della richiesta → ricevi il testo tradotto nella risposta

cURL (Caricamento file)

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

Il corpo della risposta contiene direttamente il testo tradotto.

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. Guida rapida: tradurre un rapporto multinazionale

Immagina di avere un report finanziario in inglese (Q3_Report.xlsx) che deve essere distribuito ai team in Spagna, Francia e Germania.

Passo 1: Traduci in spagnolo:

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

Passo 2: Traduci in francese:

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

Passo 3: Traduci in tedesco:

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 comandi, tre report localizzati — tutti con formule e formattazione preservate. Questo è il potere della traduzione di fogli di calcolo guidata dall’IA.

7. Benefici chiave

• Nessuna infrastruttura AI: Nessun modello da ospitare, nessuna GPU da fornire. L’AI funziona su Aspose’s cloud.
• Preservazione della struttura: La traduzione non rompe il tuo foglio di calcolo — formule, grafici e layout rimangono intatti.
• Input flessibile: Accetta sia caricamenti di file sia testo grezzo per la massima compatibilità.
• Pianificazione del progetto in pochi secondi: Trasforma descrizioni di compiti vaghe in piani strutturati e assegnabili.
• Supporto SDK: SDK ufficiali per .NET, Python e Java — o usa REST semplice con cURL.

8. Gestione degli errori

Controlla sempre lo stato della risposta e gestisci gli errori in modo corretto nel codice di produzione.

9. Cosa segue?

Il controller AI dispone di tre endpoint più potenti per scenari avanzati:

• ai/report/analysis — Analizza automaticamente i dati dei fogli di calcolo e genera report Markdown professionali
• ai/summarize/spreadsheet — Crea riepiloghi intelligenti di grandi cartelle di lavoro
• ai/categorize/spreadsheet — Classifica i dati delle colonne in gruppi logici (ad esempio, categorizzazione delle spese)

In più, puoi portare il tuo endpoint AI (DeepSeek, servizi personalizzati compatibili con OpenAI) per la traduzione. Tutto questo è trattato nella Guida Avanzata.

Inizia subito: prendi le tue credenziali dal Aspose Cloud Dashboard e esegui gli esempi sopra. Avrai l’elaborazione di fogli di calcolo con AI in pochi minuti.