ცხრილების ჭკვიან სამუშაოში გადაყვანა: დეველოპერის გიდი Aspose.Cells Cloud AI Controller-ის

დაამატეთ AI‑მოყოლილი თარგმანი, დავალებების განყოფილება და ტექსტის დამუშავება თქვენს ცხრილურ სამუშაო ნაკადში — მარტივი REST‑გამოძახებებით, ML‑გამოცდილება საჭირო არაა.

თითოეული განვითარების გუნდი იწვევს იგივე პრობლემას: ცხრილის მონაცემები უნდა იყოს თარგმნილი, შემაჯამებული, დაკატეგორიზებული ან თავიდან ორგანიზებული, სანამ ისინი downstream სისტემებისთვის სასარგებლო გახდებიან. ტრადიციულად, ეს ნიშნავს მორგებული სკრიპტები, ნაზავი რეგექსის ჯაჭვები ან ძვირადღირებული ხელით შესრულებული სამუშაო.

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‑ებს სთავაზობს. იგი სამ ძირითად სცენარებს განიცდის:

ყველა endpoint იყენებს პრეფიქსს v4.0/cells/ai/... და მოითხოვს OAuth 2.0 აუტენტიფიკაციას Aspose Cloud dashboard-ის საშუალებით.

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, Subject, Assignee, Estimated Duration, Description, Dependencies

ეს სრულყოფილია პროექტის მმართველებისთვის, ვინც غواړي ცოცხალი იდეა (“ახალი ფუნქციის შექმნა backend, frontend, და 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");

პითონი

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. Endpoint 3: ტექსტური ფაილის თარგმანი

მარშრუტი: PUT /v4.0/cells/ai/translate/text-file

თარგმნის მარტივი ტექსტის შინაარსს — ან ფაილის სახით ატვირთული, ან პირდაპირ მოთხოვნის სხეულში გაგზავნილი. სასარგებლოა დოკუმენტაციის, შენიშვნების, CSV შინაარსის ან ნებისმიერი ტექსტზე დაფუძნებული მონაცემის გადათარგმნისთვის.

ორი შეყვანის რეჟიმი:

• ფაილის ატვირთვა: გაგზავნეთ .txt ფაილი multipart/form-data ფორმით → მიიღეთ გადათარგმნილი .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), რომელიც უნდა განაწილდეს გუნდებს ესპანეთში, საფრანგეთში და გერმანიაში.

ნაბიჯი 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’s cloud-ზე.
• სტრუქტურის შენარჩუნება: თარგმანი არ აბლოკავს თქვენს ცხრილს — ფორმულები, გრაფიკები და განლაგება დარჩება უცვლელი.
• მოქნილი შეყვანა: მიიღეთ როგორც ფაილების ატვირთვა, ისე ულიმიტური ტექსტი მაქსიმალური თავსებადობისთვის.
• პროექტის დაგეგმვა წამებში: გადაიტანეთ გაურკვეველი დავალებების აღწერილობები სტრუქტურირებულ, დანიშნულ გეგმებში.
• SDK-ის მხარდაჭერა: ოფიციალური SDK-ები .NET, Python და Java-სთვის — ან გამოიყენეთ მარტივი REST cURL-ით.

8. შეცდომის დამუშავება

ყოველთვის შეამოწმეთ პასუხის სტატუსი და შეცდომები გლუვად დამუშავეთ წარმოების კოდში.

9. რა შემდეგია?

AI კონტროლერს აქვს სამი უფრო ძლიერი endpoint‑ი გაფართებული სცენარებისთვის:

• ai/report/analysis — ავტომატურად ანალიზებს ცხრილის მონაცემებს და ქმნის პროფესიონალურ Markdown ანგარიშებს
• ai/summarize/spreadsheet — ქმნის ინტელექტუალურ შეჯამებებს დიდი სამუშაო წიგნების
• ai/categorize/spreadsheet — კლასიფიცირებს სვეტის მონაცემებს ლოგიკური ჯგუფებში (მაგალითად, ხარჯის კატეგორიზაცია)

დამატებით, შეგიძლიათ იყავით თქვენი AI საბოლოო წერტილი (DeepSeek, პერსონალური OpenAI‑თან თავსებადი სერვისები) თარგმანისთვის. ყველა ეს აღწერილია დამატებითი გიდი.

დაიწყეთ ახლავე: მიიღეთ თქვენი ავტორიზაციის დეტალები Aspose Cloud Dashboard-დან და გაუშვით ზემოთ მოცემული მაგალითები. რამდენიმე წუთში მიიღებთ AI‑ით მხარდაჭერილ ცხრილთა დამუშავებას.