Documentation – Aspose.Cells Cloud AI – 任务分解、电子表格与文本翻译

Developer-Guide: Aspose.Cells Cloud AI – 用户任务分解 API（v4.0）｜SMART 任务规划

Mon, 01 Jan 0001 00:00:00 +0000

DecomposeUserTask（分解用户任务）端点提供一个 REST 接口，可将自由格式的任务描述转换为详细的、按顺序排列的行动方案，且符合 SMART 原则。该服务自动分配以小时为单位的时间估算，并将输出格式化为与 Redmine 兼容的导入格式，同时创建项目里程碑节点。只需提供原始任务列表及可选的时间估算，API 即可返回一个可直接导入项目管理工具的就绪文件（如 CSV、XLSX 等），从而自动化任务拆解，减少人工操作。

分解用户任务 API

Web API

PUT https://api.aspose.cloud/v4.0/cells/ai/task/decompose

安全与身份验证

Aspose.Cells Cloud API 是安全的，需要基于 JWT 令牌的身份验证。

请求参数：

参数名	类型	位置	必填/可选	描述
TaskDescription	string	Body	必填	用户整体目标的纯文本描述。服务会解析该描述并生成独立的任务项。示例：“为第三季度启动营销活动，包括内容创作、电子邮件群发及社交媒体广告。”

响应

成功响应（200 OK）
Content‑Type: application/octet-stream（二进制文件流）

响应头：

Content-Disposition: attachment; filename="DecomposedTaskPlan.xlsx"
Content-Length: <字节数>

XLSX/ODS 格式使用相同结构，各列置于第一个工作表中。

HTTP 状态码

状态码	含义	说明
200	OK（成功）	过滤器应用成功；响应包含操作详情。
400	Bad Request（错误请求）	缺少或参数无效（例如不支持的文件类型）。
401	Unauthorized（未授权）	JWT 令牌无效或缺失。
413	Payload Too Large（请求实体过大）	上传文件超过大小限制。
500	Internal Server Error（内部服务器错误）	服务器发生意外错误。

错误响应示例（400 Bad Request）

{
  "code": "InvalidParameter",
  "message": "字段 'TaskDescription' 为必填项，且不能为空。"
}

示例请求体（JSON）

{
  "TaskDescription": "为现有系统开发一个任务拆分功能的 Web API。"
}

示例响应
API 返回包含生成文件的二进制流。若需预览 CSV 响应的前几行，可解码该流并查看标题行，例如：

ID,Subject,Trucker,Estimated Duration,Description
1	任务拆分 API 需求收集	业务分析师	8	收集新任务拆分端点的功能性与非功能性需求、用户故事及验收标准。
2	API 规范（OpenAPI）	业务分析师	6	定义 POST /tasks/split 的 OpenAPI 合约，包括请求模式、响应格式、错误代码及安全要求。
3	拆分算法与数据模型设计	解决方案架构师	5	设计核心算法，将父任务拆分为子任务；并扩展数据模型（数据库表/实体），以存储层级结构与元数据。
4	架构集成评审	解决方案架构师	4	分析对现有服务、事件流及数据库迁移的影响；制定集成方案。
...

应在何处使用分解用户任务 API？

项目启动阶段：将高层次项目简介转换为与 Redmine 兼容的任务列表（含时间估算），支持立即开展冲刺规划。
营销自动化：将活动目标拆解为可执行步骤，导出为 CSV 并导入任务管理工具，实现跨团队协作。
资源分配：为每个子任务生成基于小时的估算，使管理者可在项目启动前合理分配团队工作量。
里程碑跟踪：自动生成可与甘特图工具同步的里程碑节点，确保每个阶段都有明确交付成果。

为何应使用分解用户任务 API？

符合 SMART 原则的输出：确保每个生成的任务均满足“具体（Specific）、可衡量（Measurable）、可实现（Achievable）、相关性（Relevant）、时限性（Time-bound）”标准。
内置小时级时间估算：免除手动计算，提升预测准确性。
即用型导入格式（CSV、XLSX 等）：便于与 Redmine、Jira、Azure DevOps 及其他项目管理平台集成。
单请求自动化：通过一次请求即可完成任务拆解，加速项目启动并减少人工干预。

如何使用 SDK 调用分解用户任务 API

分解用户任务 API 规范

分解用户任务 API 规范提供了公开可访问的编程接口，支持直接从 Web 浏览器执行 REST 交互。

Excel API SDK

使用 Aspose.Cells Cloud SDK

使用 SDK 是最快捷的开发方式，它抽象了底层细节，让您能以简洁代码调用 DecomposeUserTask 端点。
请查阅 GitHub 仓库获取 Aspose.Cells Cloud SDK 的完整列表。
以下代码示例展示了如何使用不同 SDK 与 Aspose.Cells Web 服务进行交互：

Developer-Guide: Aspose.Cells Cloud Web API – 使用 AI 驱动的语言转换功能翻译文本文件

Mon, 01 Jan 0001 00:00:00 +0000

TranslateTextFile 端点利用 Aspose.Cells Cloud AI 服务，将文本文件的内容翻译为指定的目标语言。它支持两种操作模式：(1) 文件上传模式——通过 multipart/form-data 发送文本文件，并接收已翻译的文件；(2) 直接内容模式——在请求体中提交原始文本，并直接获取翻译后的文本。该服务会保留原始换行符和格式，自动为文件名添加 “_translated” 后缀，并以可下载流的形式返回结果。适用于批量翻译文档、集成到多语言工作流中，或实时翻译用户生成内容。

TranslateTextFile API

Web API

PUT https://api.aspose.cloud/v4.0/cells/ai/translate/text-file

请求参数：

参数名称	类型	位置	必需/可选	描述
Spreadsheet	文件	请求体	必需	待翻译的源文本文件。必须为纯文本（.txt）或支持的电子表格格式。示例：通过名为 “file” 的 multipart/form-data 字段上传 `document.txt`。
targetLanguage	字符串	查询参数	必需	目标语言的 ISO-639-1 语言代码（例如：“es” 表示西班牙语，“fr” 表示法语，“de” 表示德语）。该代码不区分大小写。
region	字符串	查询参数	可选	电子表格区域标识符，影响区域性特定格式（如日期、数字和货币）。常见取值：“US”、“EU”、“CN”。若省略，则使用工作簿的原始区域设置。
password	字符串	查询参数	可选	打开加密电子表格文件所需的密码。纯文本文件无需提供。

响应

成功响应（200 OK）响应头： Content-Type: application/octet-stream // 已翻译文件的二进制流 Content-Disposition: attachment; filename="<原文件名>_translated.txt" Content-Length: <字节数>

响应体：包含已翻译文本的二进制流，保留原始换行符和格式。

HTTP 状态码

状态码	含义	描述
200	OK（成功）	翻译操作成功；响应包含操作详情。
400	Bad Request（错误请求）	缺少或无效参数（例如：不支持的文件类型）。
401	Unauthorized（未授权）	JWT 令牌无效或缺失。
413	Payload Too Large（载荷过大）	上传的文件超过大小限制。
500	Internal Server Error（内部服务器错误）	发生意外服务器错误。

应在何处使用 TranslateTextFile API？

多语言文档门户——自动翻译以文本文件形式上传的用户手册或帮助文档，按需提供本地化版本。
内容管理系统（CMS）——集成至 CMS 工作流中，在发布前将博客文章或新闻稿翻译为面向国际受众的语言。
企业数据处理流程——用于批处理作业，处理大量 CSV 或 TXT 报表，将其转换为区域办事处所需语言，同时保留原始格式。
客户支持平台——实时翻译传入的纯文本工单或聊天记录，辅助使用不同语言的客服人员。

为何应使用 TranslateTextFile API？

AI 驱动的高精度翻译——采用最先进的神经网络翻译模型，实现自然、上下文感知的输出。
双重输入灵活性——支持文件上传和原始文本载荷，简化与各类客户端应用的集成。
保留原始布局——维持换行符、缩进和特殊字符，避免后续处理清理工作。
无缝文件处理——返回已自动生成 “_translated” 后缀的可直接下载文件，降低客户端代码复杂度。

如何使用 SDK 调用 TranslateTextFile API

TranslateTextFile API 规范

TranslateTextFile API 规范提供了公开可访问的编程接口，允许直接从 Web 浏览器执行 REST 交互。

Excel API SDK

使用 Aspose.Cells Cloud SDK

使用 SDK 是最快捷的开发方式，它抽象了底层细节，使您能够用简短代码快速实现电子表格合并等功能。请查阅 GitHub 仓库，获取 Aspose.Cells Cloud SDK 的完整列表。以下代码示例展示了如何使用多种 SDK 与 Aspose.Cells Web 服务进行交互：

Developer-Guide: Aspose.Cells Cloud Web API——将电子表格翻译为目标语言

Mon, 01 Jan 0001 00:00:00 +0000

TranslateSpreadsheet 端点属于 Translate Spreadsheet API，它会读取工作簿中的每个文本元素，将内容发送至由人工智能驱动的翻译服务，并返回一个新的电子表格文件，其中所有文本数据均以指定的 targetLanguage（目标语言）呈现。该操作保持原始布局、单元格样式、公式以及多工作表结构不变，非常适合用于全球化报告、仪表板和数据驱动型文档。支持的文件格式包括 XLS、XLSX、XLSM、CSV 和 ODS。若语言代码无效、身份验证失败或翻译服务中断，系统将返回错误。

Translate Spreadsheet API（翻译电子表格 API）

Web API

PUT https://api.aspose.cloud/v4.0/cells/ai/translate/spreadsheet

请求参数：

参数名称	类型	位置	必填/可选	描述
Spreadsheet（电子表格）	文件	必填	FormData	待翻译的 Excel 工作簿。可接受的扩展名：.xls、.xlsx、.xlsm、.csv、.ods。文件最大尺寸：50 MB。示例：`budget.xlsx`。
targetLanguage（目标语言）	字符串	必填	查询参数	所需输出语言的 ISO 639-1 语言代码（例如：“es” 表示西班牙语，“fr” 表示法语，“de” 表示德语）。必须为底层人工智能服务所支持的语言。
region（区域）	字符串	可选	查询参数	电子表格区域标识符，影响区域特定格式（如日期、数字和货币）。常见取值：“US”、“EU”、“CN”。若省略，则使用工作簿的原始区域设置。
password（密码）	字符串	可选	查询参数	打开受保护工作簿所需的密码。若文件未设置密码，请留空。

响应

成功响应（200 OK）
响应头：
Content-Type: application/octet-stream // 若请求 CSV 输出则为 text/csv
Content-Disposition: attachment; filename=“translated.xlsx”
Content-Length: <字节数>

响应体：
<包含翻译后电子表格文件的二进制流>

错误响应遵循标准 Aspose.Cells Cloud 错误模型（application/json），包含字段 code（错误代码）、message（错误信息）及可选字段 details（详细信息）。

HTTP 状态码

代码	含义	描述
200	OK（成功）	翻译操作成功；响应包含操作详情。
400	Bad Request（请求错误）	缺少或无效参数（例如：不支持的文件类型）。
401	Unauthorized（未授权）	JWT 令牌无效或缺失。
413	Payload Too Large（负载过大）	上传文件超过大小限制。
500	Internal Server Error（内部服务器错误）	服务器发生意外错误。

应在哪里使用 Translate Spreadsheet API？

国际财务报告——将季度 Excel 报告转换为多种语言，供各地区办公室使用，同时保留公式和图表布局。
多语言营销仪表板——自动为全球团队生成销售业绩仪表板的本地化版本。
教育内容分发——将成绩册、作业表或课程电子表格翻译成不同国家学生所需的语言，无需手动复制粘贴。
合规性监管——生成符合语言要求的合规性电子表格，保留验证规则和数据验证列表。

为何应使用 Translate Spreadsheet API？

人工智能驱动的高准确度——利用先进的神经网络翻译模型，实现上下文感知的高质量语言转换。
零布局破坏——保持单元格公式、条件格式、图表及工作表顺序与源文件完全一致。
单次调用处理多工作表——在一次请求中完成所有工作表的翻译，无需逐个工作表循环操作。
无缝云集成——与 Aspose.Cells Cloud 身份验证兼容，便于在 CI/CD、无服务器函数或企业后端中构建自动化流程。

如何使用 SDK 调用 Translate Spreadsheet API

Translate Spreadsheet API 规范

Translate Spreadsheet API 规范提供了公开可访问的编程接口，可直接从网页浏览器执行 REST 交互。

Excel API SDK

使用 Aspose.Cells Cloud SDK

使用 SDK 是开发速度最快的途径，它抽象了底层细节，使您能用简短代码实现电子表格合并等操作。
请查看 GitHub 仓库，获取 Aspose.Cells Cloud SDK 的完整列表。
以下代码示例展示了如何使用不同 SDK 与 Aspose.Cells Web 服务进行交互：