Transformez les feuilles de calcul en travail intelligent : Guide du développeur pour l’Aspose.Cells Cloud AI Controller

Ajoutez la traduction alimentée par l’IA, la décomposition de tâches et le traitement de texte à votre flux de travail de feuille de calcul — avec des appels REST simples, aucune expertise en ML requise.

Chaque équipe de développement rencontre le même obstacle : les données de feuille de calcul doivent être traduites, résumées, classées ou réorganisées avant d’être utiles aux systèmes en aval. Traditionnellement, cela signifiait des scripts personnalisés, des chaînes regex fragiles ou un travail manuel coûteux.

Aspose.Cells Cloud AI Controller modifie cela. Il regroupe de puissantes capacités d’IA — traduction, planification de tâches, traitement de texte — en quelques points de terminaison REST propres. Téléchargez une feuille de calcul ou envoyez du texte brut, et obtenez des résultats intelligents en retour. Aucun hébergement de modèle, aucune ingénierie de prompt, aucune infrastructure à maintenir.

Cet article passe en revue les trois API fondamentales que chaque développeur devrait connaître, avec des exemples exécutables en cURL, C# et Python.

1. Que fait le contrôleur d’IA ?

Le AIController (source : src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) fournit des API de traitement de feuilles de calcul et de texte alimentées par l’IA. Il gère trois scénarios principaux :

Tous les points de terminaison utilisent le préfixe v4.0/cells/ai/... et nécessitent une authentification OAuth 2.0 via le tableau de bord Aspose Cloud.

2. Avant de commencer

1. Obtenir les informations d’identification: Inscrivez‑vous sur le Aspose Cloud Dashboard, créez une Application et récupérez votre Client ID et Client Secret.
2. Installer un SDK (optionnel — cURL fonctionne également):

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

# Python
pip install asposecellscloud

3. Point de terminaison 1 : Décomposition de tâche IA

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

Ce point de terminaison prend une description en langage naturel d’un projet ou d’une liste de tâches, puis utilise l’IA pour la décomposer en un plan structuré suivant les critères SMART. Le résultat est un fichier Excel formaté avec les colonnes : ID, Subject, Assignee, Estimated Duration, Description, Dependencies.

C’est parfait pour les chefs de projet qui souhaitent transformer une idée vague (“construire une nouvelle fonctionnalité avec backend, frontend et tests”) en une liste de tâches prête à être importée dans des outils tels que 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")

Ce que vous obtenez: Un fichier Excel avec un tableau formaté professionnellement — chaque ligne est une sous‑tâche avec des heures estimées, des suggestions d’attribution et des liens de dépendance.

4. Point de terminaison 2 : Traduction de feuille de calcul

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

Traduit tout le contenu textuel d’une feuille de calcul vers une langue cible. L’IA préserve les positions des cellules, les formules, le formatage et la structure multi‑feuilles. Seul le texte lisible par l’homme est traduit — les formules comme =SUM(A1:A10) restent intactes.

Les langues cibles prises en charge utilisent les codes ISO standard : es (espagnol), fr (français), de (allemand), zh (chinois), ja (japonais), 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.")

Avantage clé : Les classeurs à plusieurs feuilles sont entièrement pris en charge. Le fichier de sortie est nommé {original}_translated.{ext} automatiquement.

5. Point de terminaison 3 : traduction de fichier texte

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

Traduit le contenu texte brut — soit téléchargé sous forme de fichier, soit envoyé directement dans le corps de la requête. Utile pour traduire la documentation, les notes, le contenu CSV ou toute donnée textuelle.

Deux modes d’entrée:

• Téléchargement de fichier : Envoyez un fichier .txt via multipart/form-data → recevez un fichier .txt traduit en retour
• Texte direct : Envoyez du texte brut dans le corps de la requête → recevez le texte traduit dans la réponse

cURL (Téléversement de fichier)

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 (Texte Direct)

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

Le corps de la réponse contient directement le texte traduit.

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. Guide rapide : traduire un rapport multinational

Imaginez que vous avez un rapport financier en anglais (Q3_Report.xlsx) qui doit être distribué aux équipes en Espagne, en France et en Allemagne.

Étape 1 : Traduire en espagnol :

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

Étape 2: Traduire en français:

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

Étape 3 : Traduire en allemand :

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

Trois commandes, trois rapports localisés — tous avec les formules et la mise en forme préservées. C’est la puissance de la traduction de feuilles de calcul pilotée par l’IA.

7. Avantages clés

• Zero AI infrastructure : Aucun modèle à héberger, aucun GPU à provisionner. L’IA fonctionne sur le cloud d’Aspose.
• Préservation de la structure : La traduction ne casse pas votre feuille de calcul — formules, graphiques et mise en page restent intacts.
• Entrée flexible : Acceptez à la fois les téléchargements de fichiers et le texte brut pour une compatibilité maximale.
• Planification de projet en quelques secondes : Transformez des descriptions de tâches vagues en plans structurés et assignables.
• Support SDK : SDK officiels pour .NET, Python et Java — ou utilisez le REST simple avec cURL.

8. Gestion des erreurs

Vérifiez toujours le statut de la réponse et gérez les erreurs de manière élégante dans le code de production.

9. Que faire ensuite ?

Le contrôleur AI possède trois points de terminaison supplémentaires plus puissants pour les scénarios avancés :

• ai/report/analysis — Analyse automatiquement les données de feuilles de calcul et génère des rapports Markdown professionnels
• ai/summarize/spreadsheet — Crée des résumés intelligents de grands classeurs
• ai/categorize/spreadsheet — Classe les données de colonnes en groupes logiques (par ex., catégorisation des dépenses)

De plus, vous pouvez apporter votre propre point de terminaison IA (DeepSeek, services personnalisés compatibles OpenAI) pour la traduction. Tout cela est couvert dans le Guide avancé.

Commencez dès maintenant: récupérez vos identifiants depuis le Aspose Cloud Dashboard et exécutez les exemples ci‑dessus. Vous disposerez d’un traitement de feuilles de calcul alimenté par l’IA en quelques minutes.