Documentation – Aspose.Cells Cloud AI – Декомпозиция задач, перевод электронных таблиц и текста

Developer-Guide: Aspose.Cells Cloud AI — API декомпозиции пользовательской задачи (v4.0) | Планирование задач по методу SMART

Mon, 01 Jan 0001 00:00:00 +0000

Конечная точка DecomposeUserTask предоставляет REST-интерфейс для преобразования описания задачи в свободной форме в детальный, последовательный план действий, соответствующий критериям SMART. Система автоматически рассчитывает оценки длительности в часах, формирует вывод в формате, совместимом с Redmine, и создаёт узлы этапов проекта. При предоставлении только исходного списка задач и, при необходимости, предварительных оценок времени, API возвращает готовый к использованию файл (CSV, XLSX и др.), который можно непосредственно импортировать в инструменты управления проектами, автоматизируя разбиение задач и сокращая ручной труд.

API декомпозиции пользовательской задачи

Веб-API

PUT https://api.aspose.cloud/v4.0/cells/ai/task/decompose

Безопасность и аутентификация

Aspose.Cells Cloud API защищены и требуют аутентификации на основе JWT-токена.

Параметры запроса:

Название параметра	Тип	Расположение	Обязательный/необязательный	Описание
TaskDescription	string	Body	Обязательный	Описание общей цели пользователя в виде обычного текста. Сервис анализирует описание и генерирует отдельные задачи. Пример: «Запустить маркетинговую кампанию на III квартал, включая создание контента, рассылку по электронной почте и рекламу в соцсетях».

Ответ

Успешный ответ (200 OK)
Content-Type: application/octet-stream (поток двоичных данных)

Заголовки:

Content-Disposition: attachment; filename="DecomposedTaskPlan.xlsx"
Content-Length: <размер в байтах>

Для форматов XLSX/ODS структура аналогична, столбцы размещаются в первом листе.

Коды HTTP-статусов

Код	Значение	Описание
200	OK	Фильтр применён успешно; в ответе содержатся данные об операции.
400	Bad Request	Отсутствуют или некорректны параметры (например, неподдерживаемый тип файла).
401	Unauthorized	Неверный или отсутствующий JWT-токен.
413	Payload Too Large	Размер загружаемого файла превышает допустимый лимит.
500	Internal Server Error	Непредвиденная ошибка сервера.

Пример ответа об ошибке (400 Bad Request)

{
  "code": "InvalidParameter",
  "message": "Поле 'TaskDescription' является обязательным и не может быть пустым."
}

Пример тела запроса (JSON)

{
  "TaskDescription": "Разработать веб-API для функции разбиения задач в существующей системе."
}

Пример ответа
API возвращает двоичный поток, содержащий сгенерированный файл. Чтобы просмотреть первые несколько строк CSV-ответа, декодируйте поток и отобразите строку заголовков, например:

ID,Subject,Trucker,Estimated Duration,Description
1	Сбор требований к API разбиения задач	Бизнес-аналитик	8	Собрать функциональные и нефункциональные требования, пользовательские истории и критерии приемки для нового конечного узла разбиения задач.
2	Спецификация API (OpenAPI)	Бизнес-аналитик	6	Определить контракт OpenAPI для POST /tasks/split, включая схему запроса, форматы ответов, коды ошибок и требования безопасности.
3	Алгоритм разбиения и проектирование модели данных	Решающий архитектор	5	Спроектировать основной алгоритм, разделяющий родительскую задачу на подзадачи, и расширить модель данных (таблицы/сущности БД) для хранения иерархии и метаданных.
4	Обзор интеграции архитектуры	Решающий архитектор	4	Проанализировать влияние на существующие сервисы, потоки событий и миграции базы данных; подготовить план интеграции.
...

Где следует использовать API декомпозиции пользовательской задачи?

Запуск проекта: Преобразуйте общий brief проекта в список задач, совместимый с Redmine, с оценками времени, чтобы сразу приступить к планированию спринта.
Автоматизация маркетинга: Разбейте цели кампании на исполнимые этапы, экспортируйте как CSV и импортируйте в инструменты управления задачами для координации работы между командами.
Распределение ресурсов: Сгенерируйте почасовые оценки для каждой подзадачи, чтобы менеджеры могли сбалансировать нагрузку между участниками команды до начала проекта.
Отслеживание вех: Автоматически создавайте узлы вех, синхронизируемые с инструментами диаграмм Ганта, обеспечивая чёткие выходные данные для каждой фазы.

Почему стоит использовать API декомпозиции пользовательской задачи?

Выходные данные, соответствующие критериям SMART, гарантируют, что каждая сгенерированная задача будет конкретной, измеримой, достижимой, релевантной и ограниченной по времени.
Встроенная почасовая оценка времени устраняет необходимость вручную рассчитывать длительность и повышает точность прогнозов.
Готовые к импорту форматы файлов (CSV, XLSX и др.) упрощают интеграцию с Redmine, Jira, Azure DevOps и другими платформами управления проектами.
Автоматизация одним запросом позволяет разбивать задачи за один вызов, ускоряя инициацию проекта и минимизируя ручной труд.

Как использовать API декомпозиции пользовательской задачи с SDK

Спецификация API декомпозиции пользовательской задачи

Спецификация API декомпозиции пользовательской задачи предоставляет публично доступный программный интерфейс для выполнения REST-взаимодействий прямо из веб-браузера.

SDK для работы с Excel API

Использование SDK Aspose.Cells Cloud

Использование SDK — самый быстрый способ разработки, так как оно абстрагирует низкоуровневые детали и позволяет вызывать конечную точку DecomposeUserTask с помощью компактного кода.
Ознакомьтесь с репозиторием на GitHub для получения полного списка SDK Aspose.Cells Cloud.
В приведённых ниже примерах кода демонстрируется взаимодействие с веб-сервисами Aspose.Cells Cloud с использованием различных SDK:

Developer-Guide: Aspose.Cells Cloud Web API – перевод текстового файла с помощью ИИ для перевода

Mon, 01 Jan 0001 00:00:00 +0000

Конечная точка TranslateTextFile использует облачные ИИ-сервисы Aspose.Cells для перевода содержимого текстового файла на указанный целевой язык. Она поддерживает два режима работы: (1) Режим загрузки файла — отправка текстового файла через multipart/form-data с получением переведённого файла в ответ; (2) Режим прямой передачи контента — отправка необработанного текста в теле запроса с получением переведённого текста напрямую. Сервис сохраняет исходные разрывы строк и форматирование, автоматически добавляет суффикс “_translated” к имени файла и возвращает результат в виде потока для скачивания. Идеально подходит для пакетного перевода документов, интеграции в многоязыковые рабочие процессы или оперативного перевода пользовательского контента.

API перевода текстового файла

Web API

PUT https://api.aspose.cloud/v4.0/cells/ai/translate/text-file

Параметры запроса:

Название параметра	Тип	Расположение	Обязательный/необязательный	Описание
Spreadsheet	File	Обязательный	FormData	Исходный текстовый файл для перевода. Должен быть простым текстовым файлом (.txt) или поддерживаемым форматом электронной таблицы. Пример: загрузка `document.txt` через поле “file” в multipart/form-data.
targetLanguage	String	Обязательный	Query	Языковой код ISO‑639‑1 целевого языка (например, “es” — испанский, “fr” — французский, “de” — немецкий). Код нечувствителен к регистру.
region	string	Необязательный	Query	Идентификатор региона электронной таблицы, влияющий на форматирование, зависящее от локали (даты, числа, валюты). Типичные значения: “US”, “EU”, “CN”. При отсутствии используется исходный регион книги.
password	String	Необязательный	Query	Пароль, необходимый для открытия зашифрованных файлов электронных таблиц. Для простых текстовых файлов не требуется.

Ответ

Успешный ответ (200 OK) Заголовки: Content-Type: application/octet-stream // бинарный поток переведённого файла Content-Disposition: attachment; filename="<исходное_имя>_translated.txt" Content-Length: <размер в байтах>

Тело: бинарный поток, содержащий переведённый текст с сохранением исходных разрывов строк и форматирования.

Коды HTTP-статуса

Код	Значение	Описание
200	OK	Перевод успешно выполнен; ответ содержит детали операции.
400	Bad Request	Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла).
401	Unauthorized	Недействительный или отсутствующий JWT-токен.
413	Payload Too Large	Размер загруженного файла превышает допустимый лимит.
500	Internal Server Error	Непредвиденная ошибка сервера.

Где следует использовать API перевода текстового файла?

Многоязычные порталы документации — автоматический перевод пользовательских руководств или справочных файлов, загружаемых как текстовые документы, с предоставлением локализованных версий по запросу.
Системы управления контентом (CMS) — интеграция в рабочий процесс CMS для перевода блог-постов или статей перед публикацией в международных версиях.
Предприятные конвейерные процессы обработки данных — использование в пакетных задачах обработки больших объёмов отчётов в форматах CSV или TXT с переводом их на язык региональных подразделений при сохранении исходного форматирования.
Платформы поддержки клиентов — перевод входящих текстовых заявок или логов чатов в режиме реального времени для помощи агентам поддержки, работающим на разных языках.

Почему стоит использовать API перевода текстового файла?

Точность на основе ИИ — использует передовые нейросетевые модели перевода для получения естественного, контекстно-зависимого результата.
Гибкость входных данных — поддерживает как загрузку файлов, так и передачу необработанного текста, упрощая интеграцию с разнообразными клиентскими приложениями.
Сохранение исходного макета — сохраняет разрывы строк, отступы и специальные символы, исключая необходимость постобработки.
Удобная обработка файлов — возвращает готовый к скачиванию файл с автоматически сгенерированным суффиксом “_translated”, снижая сложность клиентского кода.

Как использовать API перевода текстового файла с помощью SDK

Спецификация API перевода текстового файла

Спецификация API перевода текстового файла предоставляет публично доступное программное интерфейсное описание для выполнения REST-взаимодействий непосредственно из веб-браузера.

SDK для Excel API

Использование SDK Aspose.Cells Cloud

Использование SDK — самый быстрый способ разработки, поскольку он скрывает низкоуровневые детали и позволяет объединять электронные таблицы друг с другом в считанные строки кода. Полный список SDK Aspose.Cells Cloud доступен в репозитории на GitHub. Следующие примеры кода демонстрируют взаимодействие с веб-сервисами Aspose.Cells с использованием различных SDK:

Developer-Guide: Aspose.Cells Cloud Web API — Перевод электронной таблицы на целевой язык

Mon, 01 Jan 0001 00:00:00 +0000

Endpoint TranslateSpreadsheet, входящий в состав API перевода электронных таблиц, считывает каждый текстовый элемент в рабочей книге, отправляет содержимое в сервис перевода на основе ИИ и возвращает новый файл электронной таблицы, в котором все текстовые данные представлены на указанном языке — targetLanguage. Операция сохраняет исходную компоновку, стили ячеек, формулы и структуру с несколькими листами, что делает её идеальной для локализации отчётов, информационных панелей и документов, основанных на данных. Поддерживаемые форматы файлов: XLS, XLSX, XLSM, CSV и ODS. Ошибки возвращаются при недопустимых кодах языка, сбоях аутентификации или недоступности сервиса перевода.

API перевода электронных таблиц

Web API

PUT https://api.aspose.cloud/v4.0/cells/ai/translate/spreadsheet

Параметры запроса:

Имя параметра	Тип	Расположение	Обязательный/Необязательный	Описание
Spreadsheet	File	Required	FormData	Рабочая книга Excel, подлежащая переводу. Допустимые расширения: .xls, .xlsx, .xlsm, .csv, .ods. Максимальный размер файла: 50 МБ. Пример: `budget.xlsx`.
targetLanguage	string	Required	Query	Код языка по стандарту ISO 639‑1 для целевого языка вывода (например, «es» — испанский, «fr» — французский, «de» — немецкий). Язык должен поддерживаться базовым сервисом ИИ.
region	string	Optional	Query	Идентификатор региона электронной таблицы, влияющий на форматирование, зависящее от региона: даты, числа, валюты. Типичные значения: «US», «EU», «CN». Если не указан, используется исходный регион книги.
password	string	Optional	Query	Пароль для открытия защищённой рабочей книги. Оставьте пустым, если файл не защищён паролем.

Ответ

Успешный ответ (200 OK)
Заголовки:
Content‑Type: application/octet-stream // или text/csv, если запрошен вывод CSV
Content‑Disposition: attachment; filename=“translated.xlsx”
Content‑Length: <размер в байтах>

Тело ответа:
<двоичный поток, содержащий переведённый файл электронной таблицы>

Ответы об ошибках следуют стандартной модели ошибок Aspose.Cells Cloud (application/json), включая поля code, message и необязательное поле details.

Коды HTTP-статуса

Код	Значение	Описание
200	OK	Фильтр применён успешно; ответ содержит детали операции.
400	Bad Request	Отсутствуют или некорректны параметры (например, неподдерживаемый тип файла).
401	Unauthorized	Некорректный или отсутствующий JWT-токен.
413	Payload Too Large	Загруженный файл превышает лимит размера.
500	Internal Server Error	Непредвиденная ошибка сервера.

Где следует использовать API перевода электронных таблиц?

Международная финансовая отчётность — Перевод квартальных отчётов Excel на несколько языков для региональных офисов с сохранением формул и макетов диаграмм.
Многоязычные маркетинговые информационные панели — Автоматическая генерация локализованных версий панелей отслеживания показателей продаж для глобальных команд.
Распространение образовательного контента — Перевод оценочных таблиц, заданий и учебных таблиц для студентов в разных странах без ручного копирования и вставки.
Соблюдение регуляторных требований — Генерация отчётов о соответствии, адаптированных к языку, с сохранением правил валидации и списков ограничений данных.

Почему стоит использовать API перевода электронных таблиц?

Точность на основе ИИ — Использует современные нейросетевые модели перевода для контекстно-зависимого и высококачественного языкового преобразования.
Нулевые искажения макета — Сохраняет формулы ячеек, условное форматирование, диаграммы и порядок листов в точности как в исходном файле.
Обработка нескольких листов за один вызов — Переводит каждый лист в одном запросе, исключая необходимость циклов по листам.
Бесшовная интеграция в облако — Работает с аутентификацией Aspose.Cells Cloud, обеспечивая автоматизацию в CI/CD, serverless-функциях и корпоративных бэкендах.

Как использовать API перевода электронных таблиц с SDK

Спецификация API перевода электронных таблиц

Спецификация API перевода электронных таблиц предоставляет публично доступный программный интерфейс для выполнения REST-взаимодействий непосредственно из веб-браузера.

SDK API для Excel

Использование SDK Aspose.Cells Cloud

Использование SDK — самый быстрый способ разработки, поскольку он скрывает низкоуровневые детали и позволяет объединять электронные таблицы всего в несколько строк кода.
Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub.
Ниже приведены примеры кода, демонстрирующие взаимодействие с веб-сервисами Aspose.Cells Cloud с использованием различных SDK: