Преобразуйте электронные таблицы в умную работу: Руководство разработчика по Aspose.Cells Cloud AI Controller

Добавьте перевод с поддержкой ИИ, разбиение задач и обработку текста в ваш рабочий процесс с электронными таблицами — с простыми REST‑вызовами, без необходимости в экспертизе в области машинного обучения.

Каждая команда разработчиков сталкивается с одной и той же проблемой: данные таблиц необходимо переведённые, суммированные, категоризированные или реорганизованные, прежде чем они станут полезными для downstream systems. Традиционно это означало пользовательские скрипты, хрупкие цепочки regex или дорогостоящую ручную работу.

Aspose.Cells Cloud AI Controller изменяет это. Он объединяет мощные возможности ИИ — перевод, планирование задач, обработку текста — в несколько чистых REST‑конечных точек. Загрузите таблицу или отправьте необработанный текст и получите интеллектуальные результаты обратно. Нет хостинга модели, нет настройки подсказок, нет инфраструктуры для обслуживания.

В этой статье рассматриваются три базовых API, которые должен знать каждый разработчик, с исполняемыми примерами на cURL, C# и Python.

1. Что делает AI Controller?

Контроллер AIController (исходный код: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) предоставляет API для обработки электронных таблиц и текста с использованием ИИ. Он поддерживает три основных сценария:

#	Сценарий	Endpoint	Что делает
1	Разбиение задачи	`PUT /v4.0/cells/ai/task/decompose`	Преобразует описание задачи на естественном языке в структурированный план проекта (Excel‑файл с ID, темой, исполнителем, длительностью, зависимостями)
2	Перевод таблицы	`PUT /v4.0/cells/ai/translate/spreadsheet`	Переводит весь текстовый контент в таблице на целевой язык, сохраняя структуру, формулы и форматирование
3	Перевод текстового файла	`PUT /v4.0/cells/ai/translate/text-file`	Переводит необработанный текст или текстовый файл на целевой язык — поддерживает как загрузку файла, так и ввод текста напрямую

Все конечные точки используют префикс v4.0/cells/ai/... и требуют аутентификацию OAuth 2.0 через панель управления Aspose Cloud.

2. Перед началом

Получить учетные данные: Зарегистрируйтесь в Aspose Cloud Dashboard, создайте приложение и получите ваш Client ID и Client Secret.
Установить SDK (необязательно — cURL тоже подходит):

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

# Python
pip install asposecellscloud

3. Endpoint 1: Разложение задачи ИИ

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

Этот endpoint принимает описание проекта или списка задач на естественном языке, затем использует ИИ, чтобы разбить его на структурированный план в соответствии с критериями 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), который необходимо распределить между командами в Испании, Франции и Германии.

Step 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 для выделения. ИИ работает в облаке Aspose.
Сохранение структуры: Перевод не ломает вашу таблицу — формулы, диаграммы и макет остаются неизменными.
Гибкий ввод: Поддерживает как загрузку файлов, так и необработанный текст для максимальной совместимости.
Планирование проекта за секунды: Преобразуйте расплывчатые описания задач в структурированные, назначаемые планы.
Поддержка SDK: Официальные SDK для .NET, Python и Java — или используйте простой REST с cURL.

8. Обработка ошибок

Статус	Описание	Типичная причина
400	Неверный запрос	Отсутствующий или недействительный `targetLanguage`, пустое содержание, или некорректное описание задачи
401	Неавторизовано	Ошибка аутентификации или отсутствуют учетные данные
500	Ошибка сервера	Сервис ИИ временно недоступен или ошибка обработки таблицы

Всегда проверяйте статус ответа и аккуратно обрабатывайте ошибки в производственном коде.

9. Что дальше?

Контроллер ИИ имеет три более мощных конечных точки для продвинутых сценариев:

ai/report/analysis — Автоматически анализирует данные таблицы и генерирует профессиональные отчёты в формате Markdown
ai/summarize/spreadsheet — Создаёт интеллектуальные резюме больших рабочих книг
ai/categorize/spreadsheet — Классифицирует данные столбцов в логические группы (например, категоризация расходов)

Кроме того, вы можете использовать собственный AI‑endpoint (DeepSeek, пользовательские совместимые с OpenAI сервисы) для перевода. Всё это описано в Продвинутое руководство.

Начните прямо сейчас: получите свои учетные данные из Aspose Cloud Dashboard и запустите приведённые выше примеры. Вы получите обработку электронных таблиц с поддержкой ИИ за считанные минуты.

Преобразуйте электронные таблицы в умную работу: Руководство разработчика по Aspose.Cells Cloud AI Controller#

1. Что делает AI Controller?#

2. Перед началом#

3. Endpoint 1: Разложение задачи ИИ#

cURL#

C# / .NET#

Python#

4. Конечная точка 2: Перевод электронных таблиц#

cURL#

C# / .NET#

Python#

5. Конечная точка 3: Перевод текстового файла#

cURL (Загрузка файла)#

cURL (Прямой текст)#

Python#

6. Краткое руководство: Перевести многонациональный отчет#

7. Ключевые преимущества#

8. Обработка ошибок#

9. Что дальше?#

Преобразуйте электронные таблицы в умную работу: Руководство разработчика по Aspose.Cells Cloud AI Controller

1. Что делает AI Controller?

2. Перед началом

3. Endpoint 1: Разложение задачи ИИ

cURL

C# / .NET

Python

4. Конечная точка 2: Перевод электронных таблиц

cURL

C# / .NET

Python

5. Конечная точка 3: Перевод текстового файла

cURL (Загрузка файла)

cURL (Прямой текст)

Python

6. Краткое руководство: Перевести многонациональный отчет

7. Ключевые преимущества

8. Обработка ошибок

9. Что дальше?