Biến Bảng tính thành Công việc Thông minh: Hướng dẫn cho Nhà phát triển về Aspose.Cells Cloud AI Controller

Thêm khả năng dịch bằng AI, phân tách nhiệm vụ và xử lý văn bản vào quy trình làm việc trên bảng tính của bạn — chỉ cần các cuộc gọi REST đơn giản, không cần chuyên môn ML.

Mỗi đội phát triển đều gặp cùng một rào cản: dữ liệu bảng tính cần được dịch, tóm tắt, phân loại, hoặc tổ chức lại trước khi nó có ích cho các hệ thống hạ nguồn. Truyền thống, điều này có nghĩa là các script tùy chỉnh, chuỗi regex dễ gãy, hoặc công việc thủ công tốn kém.

Aspose.Cells Cloud AI Controller thay đổi điều đó. Nó gói các khả năng AI mạnh mẽ — dịch thuật, lập kế hoạch nhiệm vụ, xử lý văn bản — vào một vài endpoint REST sạch sẽ. Tải lên một bảng tính hoặc gửi văn bản thô, và nhận lại kết quả thông minh. Không cần lưu trữ mô hình, không cần thiết kế prompt, không cần duy trì hạ tầng.

Bài viết này hướng dẫn ba API nền tảng mà mọi nhà phát triển nên biết, kèm theo các ví dụ có thể chạy được bằng cURL, C#, and Python.

1. Trình Điều Khiển AI Làm Gì?

AIController (source: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) cung cấp các API xử lý bảng tính và văn bản dựa trên AI. Nó xử lý ba kịch bản cốt lõi:

Tất cả các endpoint sử dụng tiền tố v4.0/cells/ai/... và yêu cầu xác thực OAuth 2.0 thông qua bảng điều khiển Aspose Cloud.

2. Trước Khi Bắt Đầu

1. Lấy thông tin xác thực: Đăng ký tại Aspose Cloud Dashboard, tạo một ứng dụng, và lấy Client ID và Client Secret của bạn.
2. Cài đặt SDK (tùy chọn — cURL cũng hoạt động tốt):

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

# Python
pip install asposecellscloud

3. Điểm cuối 1: Phân tách nhiệm vụ AI

Đường dẫn: PUT /v4.0/cells/ai/task/decompose

Endpoint này nhận mô tả ngôn ngữ tự nhiên của một dự án hoặc danh sách công việc, sau đó sử dụng AI để phân tách nó thành một kế hoạch có cấu trúc theo tiêu chí SMART. Kết quả là một tệp Excel được định dạng với các cột: ID, Subject, Assignee, Estimated Duration, Description, Dependencies.

Nó hoàn hảo cho các quản lý dự án muốn biến một ý tưởng thô (“xây dựng một tính năng mới với backend, frontend và testing”) thành danh sách nhiệm vụ sẵn sàng nhập cho các công cụ như Redmine, Jira hoặc 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")

Bạn sẽ nhận được: Một tệp Excel với bảng được định dạng chuyên nghiệp — mỗi hàng là một công việc phụ với số giờ ước tính, đề xuất người thực hiện và liên kết phụ thuộc.

4. Điểm cuối 2: Dịch bảng tính

Đường dẫn: PUT /v4.0/cells/ai/translate/spreadsheet

Dịch tất cả nội dung văn bản trong một bảng tính sang ngôn ngữ mục tiêu. AI giữ nguyên vị trí ô, công thức, định dạng và cấu trúc đa trang tính. Chỉ có văn bản có thể đọc được bởi con người được dịch — các công thức như =SUM(A1:A10) vẫn giữ nguyên.

Các ngôn ngữ đích được hỗ trợ sử dụng mã ISO tiêu chuẩn: es (Tiếng Tây Ban Nha), fr (Tiếng Pháp), de (Tiếng Đức), zh (Tiếng Trung), ja (Tiếng Nhật), v.v.

cURL

# Dịch một tệp Excel từ tiếng Anh sang tiếng Tây Ban Nha
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.")

Lợi ích chính: Sổ làm việc đa trang được hỗ trợ đầy đủ. Tệp đầu ra được đặt tên tự động là {original}_translated.{ext}.

5. Endpoint 3: Dịch tệp văn bản

Đường dẫn: PUT /v4.0/cells/ai/translate/text-file

Dịch nội dung văn bản thuần — có thể tải lên dưới dạng tệp hoặc gửi trực tiếp trong phần thân yêu cầu. Hữu ích cho việc dịch tài liệu, ghi chú, nội dung CSV hoặc bất kỳ dữ liệu dựa trên văn bản nào.

Hai chế độ nhập:

• File upload: Gửi một tệp .txt qua multipart/form-data → nhận lại tệp .txt đã được dịch
• Direct text: Gửi văn bản thô trong phần thân yêu cầu → nhận văn bản đã dịch trong phản hồi

cURL (Tải lên Tệp)

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 (Văn bản trực tiếp)

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

Thân phản hồi chứa văn bản đã dịch trực tiếp.

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. Hướng Dẫn Nhanh: Dịch Báo Cáo Đa Quốc Gia

Hãy tưởng tượng bạn có một báo cáo tài chính bằng tiếng Anh (Q3_Report.xlsx) cần được phân phối tới các đội ở Tây Ban Nha, Pháp và Đức.

Bước 1: Dịch sang tiếng Tây Ban Nha:

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

Bước 2: Dịch sang tiếng Pháp:

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

Bước 3: Dịch sang tiếng Đức:

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

Ba lệnh, ba báo cáo được địa phương hoá — tất cả đều giữ nguyên công thức và định dạng. Đó là sức mạnh của việc dịch bảng tính dựa trên AI.

7. Key Benefits

• Cơ sở hạ tầng AI bằng không: Không cần mô hình để lưu trữ, không cần GPU để cung cấp. AI chạy trên đám mây của Aspose.
• Bảo toàn cấu trúc: Việc dịch không làm hỏng bảng tính của bạn — công thức, biểu đồ và bố cục vẫn nguyên vẹn.
• Đầu vào linh hoạt: Chấp nhận cả tải lên tệp và văn bản thô để đạt khả năng tương thích tối đa.
• Lập kế hoạch dự án trong vài giây: Chuyển đổi mô tả nhiệm vụ mơ hồ thành các kế hoạch có cấu trúc, có thể giao nhiệm vụ.
• Hỗ trợ SDK: Các SDK chính thức cho .NET, Python và Java — hoặc sử dụng REST thuần với cURL.

8. Xử lý lỗi

Luôn kiểm tra trạng thái phản hồi và xử lý lỗi một cách nhẹ nhàng trong mã sản xuất.

9. Tiếp theo là gì?

Trình điều khiển AI có ba điểm cuối mạnh mẽ hơn cho các kịch bản nâng cao:

• ai/report/analysis — Tự động phân tích dữ liệu bảng tính và tạo ra các báo cáo Markdown chuyên nghiệp
• ai/summarize/spreadsheet — Tạo các bản tóm tắt thông minh cho các workbook lớn
• ai/categorize/spreadsheet — Phân loại dữ liệu cột thành các nhóm logic (ví dụ: phân loại chi phí)

Thêm nữa, bạn có thể tự mang AI endpoint của mình (DeepSeek, các dịch vụ tùy chỉnh tương thích với OpenAI) để dịch. Tất cả những điều này được đề cập trong Hướng dẫn nâng cao.

Bắt đầu ngay: lấy thông tin xác thực của bạn từ Aspose Cloud Dashboard và chạy các ví dụ ở trên. Bạn sẽ có khả năng xử lý bảng tính bằng AI trong vài phút.