將試算表轉化為智慧工作：Aspose.Cells Cloud AI Controller 開發者指南

為您的試算表工作流程新增 AI 驅動的翻譯、任務分解與文字處理——只需簡單的 REST 呼叫，無需機器學習專業知識。

每個開發團隊都會遇到同樣的障礙：在電子表格資料對下游系統有用之前，需要將其 翻譯、摘要、分類 或 重新組織。傳統上，這意味著自訂腳本、脆弱的正則表達式鏈或昂貴的手動工作。

Aspose.Cells Cloud AI Controller 會改變這一點。它將強大的 AI 功能——翻譯、任務規劃、文字處理——封裝為少數幾個簡潔的 REST 端點。上傳試算表或傳送原始文字，即可獲得智慧結果回傳。無需模型託管，無需提示工程，無需維護基礎設施。

本文將介紹每位開發人員都應該了解的三個基礎 API，並提供 cURL、C# 和 Python 的可執行範例。

1. AI 控制器的功能是什麼？

The AIController (source: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) 提供 AI 驅動的試算表和文字處理 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 將原始文字或文字檔翻譯為目標語言 — 支援檔案上傳與直接文字輸入

所有端點均使用前綴 v4.0/cells/ai/...，並且需要通過 Aspose Cloud 儀表板進行 OAuth 2.0 身份驗證。

2. 開始之前

  1. 取得認證：在 Aspose Cloud Dashboard 註冊，建立應用程式，並取得您的 Client ID 和 Client Secret。
  2. 安裝 SDK（可選 — cURL 也能正常使用）：
<!-- .NET -->
<PackageReference Include="Aspose.Cells-Cloud" Version="25.x" />

# Python
pip install asposecellscloud

3. 端點 1：AI 任務分解

路由: PUT /v4.0/cells/ai/task/decompose

此端點接受項目或任務清單的自然語言描述，然後使用 AI 將其分解為符合 SMART 標準的結構化計畫。輸出為具有以下欄位的格式化 Excel 檔案：ID、主旨、受指派者、預估持續時間、描述、相依性.

它非常適合希望將粗略想法（“建立具有後端、前端和測試的新功能”）轉換為可直接匯入 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

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

主要優勢：完整支援多工作表活頁簿。輸出檔案會自動命名為 {original}_translated.{ext}。

5. 端點 3：文字檔案翻譯

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

翻譯純文字內容 — 可以是上傳的檔案或直接在請求主體中傳送。適用於翻譯文件、筆記、CSV 內容或任何基於文字的資料。

兩種輸入模式:

  • 檔案上傳: 透過 multipart/form-data 送出 .txt 檔案 → 取得已翻譯的 .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 (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."

回應正文直接包含翻譯後的文字。

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

三個指令，三份本地化報告——所有公式與格式均保持不變。這就是 AI 驅動的試算表翻譯的威力。

7. 主要優勢

  • 零 AI 基礎設施: 無需托管模型，無需配置 GPU。AI 在 Aspose 的雲端運行。
  • 結構保留: 翻譯不會破壞您的試算表 — 公式、圖表和版面保持完整。
  • 彈性輸入: 同時接受檔案上傳與原始文字，以實現最大相容性。
  • 秒級項目規劃: 將模糊的任務描述轉換為結構化、可指派的計畫。
  • SDK 支援: 官方 SDK 支援 .NET、Python 與 Java — 或使用純粹的 REST 搭配 cURL。

8. 錯誤處理

狀態 含義 常見原因
400 錯誤的請求 缺少或無效的 targetLanguage、內容為空，或任務描述格式錯誤
401 未授權 驗證失敗或缺少憑證
500 伺服器錯誤 AI 服務暫時不可用或試算表處理錯誤

在生產環境的程式碼中，請始終檢查回應狀態並優雅地處理錯誤。

9. 接下來是什麼？

AI 控制器有三個更強大的端點，用於高級場景：

  • ai/report/analysis — 自動分析試算表資料並生成專業的 Markdown 報告
  • ai/summarize/spreadsheet — 為大型活頁簿建立智慧摘要
  • ai/categorize/spreadsheet — 將欄位資料分類為邏輯群組（例如，費用分類）

此外，您可以 自行提供 AI 端點（DeepSeek、自訂相容 OpenAI 的服務）以進行翻譯。所有這些內容都在 進階指南 中有說明。

立即開始：從 Aspose Cloud Dashboard 取得您的憑證，並執行上述範例。您將在幾分鐘內擁有 AI 驅動的試算表處理功能。