เปลี่ยนสเปรดชีตให้เป็นงานอัจฉริยะ: คู่มือสำหรับนักพัฒนาเกี่ยวกับ Aspose.Cells Cloud AI Controller

เพิ่มการแปลด้วย AI, การแยกงาน, และการประมวลผลข้อความในกระบวนการทำงานของสเปรดชีตของคุณ — ด้วยการเรียก REST ธรรมดา ไม่จำเป็นต้องมีความเชี่ยวชาญด้าน ML

ทุกทีมพัฒนาต้องเผชิญกับอุปสรรคเดียวกัน: ข้อมูลสเปรดชีตต้องถูก แปล, สรุป, จัดประเภท, หรือ จัดระเบียบ ก่อนที่จะเป็นประโยชน์ต่อระบบ downstream. โดยทั่วไปแล้ว นั่นหมายถึงสคริปต์ที่กำหนดเอง, โซ่ regex ที่เปราะบาง, หรือการทำงานด้วยมือที่มีค่าใช้จ่ายสูง.

Aspose.Cells Cloud AI Controller ทำการเปลี่ยนแปลงนั้น. มันรวมความสามารถ AI ที่ทรงพลัง — การแปล, การวางแผนงาน, การประมวลผลข้อความ — ไว้ในไม่กี่ endpoint ของ REST ที่เรียบง่าย. อัปโหลดสเปรดชีตหรือส่งข้อความดิบ แล้วรับผลลัพธ์อัจฉริยะกลับมา. ไม่มีการโฮสต์โมเดล, ไม่มีการออกแบบ prompt, ไม่มีโครงสร้างพื้นฐานที่ต้องดูแล.

โพสต์นี้อธิบายผ่าน API พื้นฐานสามอย่างที่นักพัฒนาทุกคนควรรู้ พร้อมตัวอย่างที่สามารถรันได้ใน cURL, C#, and Python.

1. ตัวควบคุม AI ทำอะไร?

AIController (source: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) ให้บริการ API การประมวลผลสเปรดชีตและข้อความที่ใช้ AI. มันจัดการกับสามสถานการณ์หลัก:

ทุก endpoint ใช้คำนำหน้า v4.0/cells/ai/... และต้องการการรับรองความถูกต้อง OAuth 2.0 ผ่านแดชบอร์ดของ Aspose Cloud

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

Endpoint นี้รับคำอธิบายด้วยภาษาธรรมชาติของโครงการหรือรายการงาน แล้วใช้ AI แยกย่อยเป็นแผนโครงสร้างตามเกณฑ์ SMART ผลลัพธ์คือไฟล์ Excel ที่จัดรูปแบบไว้พร้อมคอลัมน์: ID, Subject, Assignee, Estimated Duration, Description, Dependencies.

มันเหมาะอย่างยิ่งสำหรับผู้จัดการโครงการที่ต้องการเปลี่ยนแนวคิดคร่าว ๆ (“สร้างฟีเจอร์ใหม่ด้วยแบ็กเอนด์, ฟรอนท์เอนด์, และการทดสอบ”) ให้เป็นรายการงานที่พร้อมนำเข้าไปยังเครื่องมือเช่น 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. Endpoint 2: การแปลสเปรดชีต

เส้นทาง: PUT /v4.0/cells/ai/translate/spreadsheet

แปล เนื้อหาข้อความทั้งหมด ในสเปรดชีตเป็นภาษาที่ต้องการ AI จะคงตำแหน่งเซลล์ สูตร การจัดรูปแบบ และโครงสร้างหลายชีตไว้ โดยจะแปลเฉพาะข้อความที่มนุษย์อ่านได้เท่านั้น — สูตรเช่น =SUM(A1:A10) จะคงเดิม

ภาษาปลายทางที่รองรับใช้รหัส ISO มาตรฐาน: es (สเปน), fr (ฝรั่งเศส), de (เยอรมัน), zh (จีน), ja (ญี่ปุ่น), เป็นต้น.

cURL

# แปลไฟล์ Excel จากภาษาอังกฤษเป็นสเปน
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. Endpoint 3: การแปลไฟล์ข้อความ

เส้นทาง: PUT /v4.0/cells/ai/translate/text-file

แปลเนื้อหาข้อความธรรมดา — ไม่ว่าจะอัปโหลดเป็นไฟล์หรือส่งโดยตรงในส่วนของ request body มีประโยชน์สำหรับการแปลเอกสาร, บันทึก, เนื้อหา CSV หรือข้อมูลใด ๆ ที่เป็นข้อความ

สองโหมดการป้อนข้อมูล:

• File upload: ส่งไฟล์ .txt ผ่าน multipart/form-data → รับไฟล์ .txt ที่แปลแล้วกลับมา
• Direct text: ส่งข้อความดิบในส่วน body ของคำขอ → รับข้อความที่แปลแล้วในการตอบกลับ

cURL (File Upload)

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) ที่ต้องแจกจ่ายให้กับทีมในสเปน ฝรั่งเศส และเยอรมนี.

ขั้นตอนที่ 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. ประโยชน์หลัก

• Zero AI infrastructure: ไม่มีโมเดลให้โฮสต์, ไม่มี GPU ให้จัดหา. AI ทำงานบนคลาวด์ของ Aspose.
• Structure preservation: การแปลไม่ทำลายสเปรดชีตของคุณ — สูตร, แผนภูมิ, และการจัดวางยังคงเหมือนเดิม.
• Flexible input: รองรับการอัปโหลดไฟล์และข้อความดิบเพื่อความเข้ากันได้สูงสุด.
• Project planning in seconds: เปลี่ยนคำอธิบายงานที่คลุมเครือให้เป็นแผนที่มีโครงสร้างและสามารถมอบหมายได้.
• SDK support: SDK อย่างเป็นทางการสำหรับ .NET, Python, และ Java — หรือใช้ REST ธรรมดากับ cURL.

8. การจัดการข้อผิดพลาด

ควรตรวจสอบสถานะการตอบสนองและจัดการข้อผิดพลาดอย่างราบรื่นในโค้ดการผลิต

9. ต่อไปคืออะไร?

ตัวควบคุม AI มีจุดเชื่อมต่อที่ทรงพลังเพิ่มเติมอีกสามจุดสำหรับสถานการณ์ขั้นสูง:

• ai/report/analysis — วิเคราะห์ข้อมูลสเปรดชีตโดยอัตโนมัติและสร้างรายงาน Markdown ระดับมืออาชีพ
• ai/summarize/spreadsheet — สร้างสรุปอัจฉริยะของสมุดงานขนาดใหญ่
• ai/categorize/spreadsheet — จัดประเภทข้อมูลคอลัมน์เป็นกลุ่มเชิงตรรกะ (เช่น การจัดประเภทค่าใช้จ่าย)

นอกจากนี้ คุณสามารถ **นำเอาเอ็นด์พอยต์ AI ของคุณเอง ** (DeepSeek, บริการที่เข้ากันได้กับ OpenAI ที่กำหนดเอง) สำหรับการแปลได้ ทั้งหมดนี้ได้อธิบายไว้ใน คู่มือขั้นสูง.

เริ่มต้นทันที: รับข้อมูลประจำตัวของคุณจาก Aspose Cloud Dashboard และเรียกใช้ตัวอย่างข้างต้น คุณจะมีการประมวลผลสเปรดชีตด้วย AI ภายในไม่กี่นาที.