Перетворення електронних таблиць у розумну роботу: Посібник розробника щодо Aspose.Cells Cloud AI Controller

Додайте переклад на базі ШІ, розподіл завдань та обробку тексту у ваш робочий процес електронних таблиць — за допомогою простих REST‑викликів, без необхідності у знаннях МЛ.

Кожна команда розробників стикається з однією і тією ж проблемою: дані електронних таблиць потрібно перекласти, підсумувати, категоризувати або переструктурувати, перш ніж вони стануть корисними для нижчестоячих систем. Традиційно це означало кастомні скрипти, крихкі ланцюжки regex або дороговартісну ручну роботу.

Aspose.Cells Cloud AI Controller змінює це. Він обгортає потужні можливості ШІ — переклад, планування завдань, обробка тексту — у кілька чистих REST‑endpoint’ів. Завантажте електронну таблицю або надішліть необроблений текст і отримайте інтелектуальні результати. Без розміщення моделей, без інженерії підказок, без необхідності підтримки інфраструктури.

У цьому дописі розглядаються три базові API, які повинен знати кожен розробник, з готовими прикладами на cURL, C# та Python.

1. Що робить AI Controller?

Контролер AIController (джерело: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) надає API для обробки електронних таблиць і тексту з використанням ШІ. Він обробляє три основні сценарії:

Усі кінцеві точки використовують префікс 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: Декомпозиція завдань ШІ

Маршрут: PUT /v4.0/cells/ai/task/decompose

Цей кінцевий пункт приймає опис проекту або списку завдань природною мовою, а потім використовує ШІ, щоб розбити його на структурований план згідно з критеріями 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. Кінцева точка 2: Переклад електронних таблиць

Маршрут: PUT /v4.0/cells/ai/translate/spreadsheet

Перекладає весь текстовий вміст у електронній таблиці на цільову мову. ШІ зберігає позиції клітинок, формули, форматування та багатосторінкову структуру. Перекладається лише людсько‑читабельний текст — формули, такі як =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 або будь‑яких текстових даних.

Два режими вводу:

• Завантаження файлу: Надішліть файл .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

Три команди, три локалізовані звіти — усі з формулами та форматуванням, збереженими. Ось сила перекладу електронних таблиць, керованого ШІ.

7. Ключові переваги

• Нульова AI інфраструктура: Немає моделей для розгортання, немає GPU для виділення. AI працює на Aspose’s cloud.
• Збереження структури: Переклад не порушує вашу електронну таблицю — формули, діаграми та макет залишаються незмінними.
• Гнучке введення: Приймайте як завантаження файлів, так і необроблений текст для максимальної сумісності.
• Планування проекту за секунди: Перетворюйте нечіткі описання завдань у структуровані, призначувані плани.
• Підтримка SDK: Офіційні 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 і запустіть наведені вище приклади. Ви отримаєте обробку електронних таблиць за допомогою ШІ за кілька хвилин.