Convierte las hojas de cálculo en trabajo inteligente: Guía para desarrolladores del Aspose.Cells Cloud AI Controller

Agrega traducción impulsada por IA, descomposición de tareas y procesamiento de texto a tu flujo de trabajo de hojas de cálculo — con llamadas REST simples, sin necesidad de experiencia en ML.

Cada equipo de desarrollo se encuentra con el mismo obstáculo: los datos de la hoja de cálculo necesitan ser traducidos, resumidos, categorizados o reorganizados antes de que sean útiles para los sistemas posteriores.

Aspose.Cells Cloud AI Controller cambia eso. Envuelve potentes capacidades de IA — traducción, planificación de tareas, procesamiento de texto — en un puñado de endpoints REST limpios. Cargue una hoja de cálculo o envíe texto sin formato, y obtenga resultados inteligentes de vuelta. Sin alojamiento de modelos, sin ingeniería de prompts, sin infraestructura que mantener.

Esta publicación recorre las tres API fundamentales que todo desarrollador debe conocer, con ejemplos ejecutables en cURL, C# y Python.

1. ¿Qué hace el controlador de IA?

El AIController (source: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) ofrece API de procesamiento de hojas de cálculo y texto impulsadas por IA. Maneja tres escenarios principales:

Todos los puntos finales usan el prefijo v4.0/cells/ai/... y requieren autenticación OAuth 2.0 a través del panel de control de Aspose Cloud.

2. Antes de comenzar

1. Obtener credenciales: Regístrese en el Aspose Cloud Dashboard, cree una Aplicación y obtenga su Client ID y Client Secret.
2. Instalar un SDK (opcional — cURL funciona bien también):

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

# Python
pip install asposecellscloud

3. Punto final 1: Descomposición de tareas de IA

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

Este endpoint toma una descripción en lenguaje natural de un proyecto o lista de tareas, y luego utiliza IA para desglosarla en un plan estructurado siguiendo los criterios SMART. La salida es un archivo Excel formateado con columnas: ID, Subject, Assignee, Estimated Duration, Description, Dependencies.

Es perfecto para los gerentes de proyecto que desean convertir una idea vaga (“construir una nueva funcionalidad con backend, frontend y pruebas”) en una lista de tareas lista para importar a herramientas como Redmine, Jira o 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")

Qué obtienes: Un archivo Excel con una tabla formateada profesionalmente — cada fila es una sub‑tarea con horas estimadas, sugerencias de asignación y enlaces de dependencia.

4. Punto final 2: Traducción de hoja de cálculo

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

Traduce todo el contenido de texto en una hoja de cálculo a un idioma objetivo. La IA conserva las posiciones de las celdas, las fórmulas, el formato y la estructura de varias hojas. Sólo el texto legible por humanos se traduce — las fórmulas como =SUM(A1:A10) permanecen intactas.

Los idiomas de destino compatibles utilizan códigos ISO estándar: es (Español), fr (Francés), de (Alemán), zh (Chino), ja (Japonés), etc.

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.")

Beneficio clave: Los libros de trabajo con varias hojas son totalmente compatibles. El archivo de salida se nombra {original}_translated.{ext} automáticamente.

5. Punto final 3: Traducción de archivo de texto

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

Traduce contenido de texto sin formato — ya sea cargado como un archivo o enviado directamente en el cuerpo de la solicitud. Útil para traducir documentación, notas, contenido CSV o cualquier dato basado en texto.

Dos modos de entrada:

• Carga de archivo: Envía un archivo .txt mediante multipart/form-data → obtén un archivo .txt traducido de vuelta
• Texto directo: Envía texto sin formato en el cuerpo de la solicitud → obtén el texto traducido en la respuesta

cURL (Carga de archivo)

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 Directo)

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. Guía rápida: traducir un informe multinacional

Imagina que tienes un informe financiero en inglés (Q3_Report.xlsx) que necesita ser distribuido a los equipos en España, Francia y Alemania.

Paso 1: Traducir al español:

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

Paso 2: Traducir al 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

Paso 3: Traducir al alemán:

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

Tres comandos, tres informes localizados — todos con fórmulas y formato preservados. Ese es el poder de la traducción de hojas de cálculo impulsada por IA.

7. Beneficios clave

• Infraestructura Zero AI: No hay modelos que hospedar, ni GPUs que provisionar. La IA se ejecuta en la nube de Aspose.
• Preservación de la estructura: La traducción no rompe su hoja de cálculo — fórmulas, gráficos y diseño permanecen intactos.
• Entrada flexible: Acepta tanto cargas de archivos como texto sin formato para máxima compatibilidad.
• Planificación de proyectos en segundos: Convierte descripciones vagas de tareas en planes estructurados y asignables.
• Compatibilidad SDK: SDK oficiales para .NET, Python y Java — o usa REST puro con cURL.

8. Manejo de errores

Siempre verifique el estado de la respuesta y maneje los errores de forma elegante en el código de producción.

9. ¿Qué sigue?

El controlador de IA tiene tres endpoints más potentes para escenarios avanzados:

• ai/report/analysis — Analiza automáticamente los datos de la hoja de cálculo y genera informes Markdown profesionales
• ai/summarize/spreadsheet — Crea resúmenes inteligentes de libros de trabajo grandes
• ai/categorize/spreadsheet — Clasifica los datos de columnas en grupos lógicos (p. ej., categorización de gastos)

Además, puedes traer tu propio punto final de IA (DeepSeek, servicios personalizados compatibles con OpenAI) para la traducción. Todo esto se cubre en la Guía Avanzada.

Comienza ahora: obtén tus credenciales del Aspose Cloud Dashboard y ejecuta los ejemplos anteriores. Tendrás procesamiento de hojas de cálculo impulsado por IA en minutos.