Transforme Planilhas em Trabalho Inteligente: Um Guia do Desenvolvedor para o Aspose.Cells Cloud AI Controller

Adicione tradução impulsionada por IA, decomposição de tarefas e processamento de texto ao seu fluxo de trabalho de planilha — com chamadas REST simples, sem necessidade de expertise em ML.

Toda equipe de desenvolvimento enfrenta o mesmo obstáculo: os dados de planilhas precisam ser traduzidos, resumidos, categorados ou reorganizados antes de serem úteis para os sistemas downstream. Tradicionalmente, isso significava scripts personalizados, cadeias de regex frágeis ou trabalho manual caro.

Aspose.Cells Cloud AI Controller altera isso. Ele encapsula poderosas capacidades de IA — tradução, planejamento de tarefas, processamento de texto — em um conjunto de endpoints REST limpos. Faça upload de uma planilha ou envie texto bruto e receba resultados inteligentes. Sem hospedagem de modelo, sem engenharia de prompts, sem infraestrutura para manter.

Este post percorre as três APIs fundamentais que todo desenvolvedor deve conhecer, com exemplos executáveis em cURL, C# e Python.

1. O que o AI Controller faz?

O AIController (fonte: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) fornece APIs de planilha e processamento de texto com IA. Ele lida com três cenários principais:

Todos os endpoints usam o prefixo v4.0/cells/ai/... e requerem autenticação OAuth 2.0 via o painel do Aspose Cloud.

2. Antes de Começar

1. Obter credenciais: Registre-se no Aspose Cloud Dashboard, crie um Aplicativo e obtenha seu Client ID e Client Secret.
2. Instalar um SDK (opcional — cURL funciona bem também):

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

# Python
pip install asposecellscloud

3. Endpoint 1: Decomposição de Tarefas de IA

Rota: PUT /v4.0/cells/ai/task/decompose

Este endpoint recebe uma descrição em linguagem natural de um projeto ou lista de tarefas e, em seguida, usa IA para dividi‑la em um plano estruturado seguindo os critérios SMART. A saída é um arquivo Excel formatado com colunas: ID, Subject, Assignee, Estimated Duration, Description, Dependencies.

É perfeito para gerentes de projeto que desejam transformar uma ideia vaga (“construir um novo recurso com backend, frontend e testes”) em uma lista de tarefas pronta para importação em ferramentas como Redmine, Jira ou 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")

O que você recebe: Um arquivo Excel com uma tabela formatada profissionalmente — cada linha é uma sub‑tarefa com horas estimadas, sugestões de responsável e links de dependência.

4. Endpoint 2: Tradução de Planilha

Rota: PUT /v4.0/cells/ai/translate/spreadsheet

Traduz todo o conteúdo de texto em uma planilha para um idioma alvo. A IA preserva as posições das células, fórmulas, formatação e a estrutura de múltiplas planilhas. Apenas o texto legível por humanos é traduzido — fórmulas como =SUM(A1:A10) permanecem intactas.

Os idiomas de destino suportados usam códigos ISO padrão: es (Espanhol), fr (Francês), de (Alemão), zh (Chinês), ja (Japonês), etc.

cURL

# Traduzir um arquivo Excel do inglês para o espanhol
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.")

Benefício principal: Pastas de trabalho com várias planilhas são totalmente suportadas. O arquivo de saída é nomeado {original}_translated.{ext} automaticamente.

5. Endpoint 3: Tradução de Arquivo de Texto

Rota: PUT /v4.0/cells/ai/translate/text-file

Traduz conteúdo de texto simples — seja enviado como um arquivo ou enviado diretamente no corpo da solicitação. Útil para traduzir documentação, notas, conteúdo CSV ou quaisquer dados baseados em texto.

Dois modos de entrada:

• Upload de arquivo: Envie um arquivo .txt via multipart/form-data → receba um arquivo .txt traduzido de volta
• Texto direto: Envie texto bruto no corpo da requisição → receba o texto traduzido na resposta

cURL (Upload de Arquivo)

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 (Texto Direto)

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. Visão geral rápida: Traduzir um relatório multinacional

Imagine que você tem um relatório financeiro em inglês (Q3_Report.xlsx) que precisa ser distribuído para equipes na Espanha, França e Alemanha.

Passo 1: Traduzir para o espanhol:

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

Etapa 2: Traduzir para o francês:

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

Etapa 3: Traduzir para o alemão:

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

Três comandos, três relatórios localizados — todos com fórmulas e formatação preservadas. Esse é o poder da tradução de planilhas impulsionada por IA.

7. Principais Benefícios

• Infraestrutura Zero de IA: Sem modelos para hospedar, sem GPUs para provisionar. A IA roda no Aspose’s cloud.
• Preservação da estrutura: A tradução não quebra sua planilha — fórmulas, gráficos e layout permanecem intactos.
• Entrada flexível: Aceita tanto uploads de arquivos quanto texto bruto para máxima compatibilidade.
• Planejamento de projetos em segundos: Converte descrições vagas de tarefas em planos estruturados e atribuíveis.
• Suporte a SDK: SDKs oficiais para .NET, Python e Java — ou use REST puro com cURL.

8. Error Handling

Sempre verifique o status da resposta e trate os erros de forma elegante no código de produção.

9. O que vem a seguir?

O AI Controller tem três endpoints mais poderosos para cenários avançados:

• ai/report/analysis — Analisa automaticamente os dados da planilha e gera relatórios Markdown profissionais
• ai/summarize/spreadsheet — Cria resumos inteligentes de grandes pastas de trabalho
• ai/categorize/spreadsheet — Classifica os dados das colunas em grupos lógicos (por exemplo, categorização de despesas)

Além disso, você pode trazer seu próprio endpoint de IA (DeepSeek, serviços personalizados compatíveis com OpenAI) para tradução. Tudo isso está coberto no Guia Avançado.

Comece agora: obtenha suas credenciais no Aspose Cloud Dashboard e execute os exemplos acima. Você terá processamento de planilhas com IA em minutos.