将电子表格转化为智能工作：Aspose.Cells Cloud AI Controller 开发者指南

为您的电子表格工作流添加 AI 驱动的翻译、任务分解和文本处理——只需普通的 REST 调用，无需机器学习专业知识。

每个开发团队都会遇到同样的难题：在电子表格数据对下游系统有用之前，需要对其进行_翻译_、汇总、分类_或_重新组织。传统上，这意味着自定义脚本、脆弱的正则表达式链或昂贵的人工工作。

Aspose.Cells Cloud AI Controller 更改了这一点。它将强大的 AI 能力——翻译、任务规划、文本处理——封装为少量简洁的 REST 端点。上传电子表格或发送原始文本，即可获得智能结果。无需模型托管、无需提示工程、无需维护基础设施。

本文介绍了每个开发者都应该了解的三个基础 API，并提供了可运行的 cURL, C#, and Python 示例。

1. AI 控制器的作用是什么？

AIController（源代码：src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs）提供 AI 驱动的电子表格和文本处理 API。它处理三个核心场景：

#	场景	端点	功能说明
1	任务分解	`PUT /v4.0/cells/ai/task/decompose`	将自然语言任务描述转换为结构化的项目计划（包含 ID、主题、受让人、持续时间和依赖关系的 Excel 文件）
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. 开始之前

获取凭证：在 Aspose Cloud Dashboard 注册，创建一个 Application，并获取您的 Client ID 和 Client Secret。
安装 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、主题、受让人、预计持续时间、描述、依赖项。

它非常适合希望将粗略想法（“build a new feature with backend, frontend, and testing”）转换为可直接导入 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 (直接文本)

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），需要分发给西班牙、法国和德国的团队。

Step 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

Step 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 支持: 提供 .NET、Python 和 Java 的官方 SDK — 或使用 cURL 的普通 REST。

8. 错误处理

Status	Meaning	Typical cause
400	错误请求	缺少或无效的 `targetLanguage`，内容为空，或任务描述格式错误
401	未授权	身份验证失败或凭据缺失
500	服务器错误	AI 服务暂时不可用或电子表格处理错误

在生产代码中，始终检查响应状态并优雅地处理错误。

9. 接下来做什么？

AI 控制器拥有三个更强大的端点，用于高级场景：

ai/report/analysis — 自动分析电子表格数据并生成专业的 Markdown 报告
ai/summarize/spreadsheet — 为大型工作簿创建智能摘要
ai/categorize/spreadsheet — 将列数据分类为逻辑组（例如，费用分类）

此外，您可以 自行提供 AI 端点（DeepSeek，自定义兼容 OpenAI 的服务）进行翻译。所有这些内容都在高级指南中有所覆盖。

立即开始: 从 Aspose Cloud Dashboard 获取您的凭据并运行上面的示例。几分钟内即可拥有 AI 驱动的电子表格处理。

将电子表格转化为智能工作：Aspose.Cells Cloud AI Controller 开发者指南#

1. AI 控制器的作用是什么？#

2. 开始之前#

3. 端点 1：AI 任务分解#

cURL#

C# / .NET#

Python#

4. 端点 2：电子表格翻译#

cURL#

C# / .NET#

Python#

5. 端点 3：文本文件翻译#

cURL（文件上传）#

cURL (直接文本)#

Python#

6. 快速演练：翻译跨国报告#

7. 关键优势#

8. 错误处理#

9. 接下来做什么？#

将电子表格转化为智能工作：Aspose.Cells Cloud AI Controller 开发者指南

1. AI 控制器的作用是什么？

2. 开始之前

3. 端点 1：AI 任务分解

cURL

C# / .NET

Python

4. 端点 2：电子表格翻译

cURL

C# / .NET

Python

5. 端点 3：文本文件翻译

cURL（文件上传）

cURL (直接文本)

Python

6. 快速演练：翻译跨国报告

7. 关键优势

8. 错误处理

9. 接下来做什么？