スプレッドシートをスマートワークに変える: Aspose.Cells Cloud AI Controller の開発者ガイド

AI 搭載の翻訳、タスク分解、テキスト処理をスプレッドシートのワークフローに追加しましょう — プレーンな REST 呼び出しだけで、ML の専門知識は不要です。

すべての開発チームは同じ壁に直面します：スプレッドシートデータは、下流システムで有用になる前に、翻訳、要約、分類、または_再構成_する必要があります。従来は、カスタムスクリプト、壊れやすい正規表現チェーン、または高価な手作業が必要でした。

Aspose.Cells Cloud AI Controller はそれを変更します。 強力な AI 機能 — 翻訳、タスク計画、テキスト処理 — を、少数のシンプルな REST エンドポイントにまとめます。 スプレッドシートをアップロードするか、生のテキストを送信し、インテリジェントな結果を取得します。 モデルのホスティングも、プロンプト エンジニアリングも、インフラの管理も不要です。

この投稿では、すべての開発者が知っておくべき3つの基礎的なAPIを解説し、cURL、C#、Python の実行可能なサンプルを示します。

1. AIコントローラは何をしますか？

AIController（ソース: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs）は、AI 搭載のスプレッドシートおよびテキスト処理 API を提供します。3 つの主要シナリオを処理します：

# シナリオ エンドポイント 機能概要
1 タスク分解 PUT /v4.0/cells/ai/task/decompose 自然言語のタスク説明を構造化されたプロジェクト計画に変換します（ID、件名、担当者、期間、依存関係を含む Excel ファイル）。
2 スプレッドシート翻訳 PUT /v4.0/cells/ai/translate/spreadsheet スプレッドシート内のすべてのテキストコンテンツを対象言語に翻訳し、構造、数式、書式設定を保持します。
3 テキストファイル翻訳 PUT /v4.0/cells/ai/translate/text-file 生テキストまたはテキストファイルを対象言語に翻訳します — ファイルアップロードと直接テキスト入力の両方に対応しています。

すべてのエンドポイントはプレフィックス v4.0/cells/ai/... を使用し、Aspose Cloud ダッシュボードを介した OAuth 2.0 認証が必要です。

2. 開始する前に

  1. 資格情報を取得: Aspose Cloud Dashboard に登録し、アプリケーションを作成して、Client ID と Client Secret を取得してください。
  2. SDK をインストール (オプション — cURL でも問題ありません):
<!-- .NET -->
<PackageReference Include="Aspose.Cells-Cloud" Version="25.x" />

# Python
pip install asposecellscloud

3. エンドポイント 1: AI タスク分解

ルート: PUT /v4.0/cells/ai/task/decompose

このエンドポイントは、プロジェクトまたはタスク一覧の自然言語による説明を受け取り、AI を使用して SMART 基準に従った構造化された計画に分解します。出力は、列 ID, Subject, Assignee, Estimated Duration, Description, Dependencies を含むフォーマットされた Excel ファイルです。

プロジェクトマネージャーが、ざっくりとしたアイデア（「バックエンド、フロントエンド、テストを含む新機能の構築」）を 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

スプレッドシート内のすべてのテキストコンテンツを対象言語に翻訳します。AIはセルの位置、数式、書式設定、マルチシート構造を保持します。人間が読むことのできるテキストのみが翻訳されます — =SUM(A1:A10) のような数式はそのまま保持されます。

サポートされているターゲット言語は標準の ISO コードを使用します: es (Spanish), fr (French), de (German), zh (Chinese), ja (Japanese), 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.")

主な利点: マルチシートブックは完全にサポートされています。出力ファイルは自動的に {original}_translated.{ext} という名前が付けられます。

5. エンドポイント 3: テキスト ファイルの翻訳

ルート: PUT /v4.0/cells/ai/translate/text-file

プレーンテキストコンテンツを翻訳します — ファイルとしてアップロードするか、リクエストボディに直接送信します。ドキュメント、メモ、CSV コンテンツ、またはテキストベースのデータの翻訳に便利です。

2つの入力モード:

  • ファイルアップロード: multipart/form-data を使用して .txt ファイルを送信 → 翻訳された .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

Step 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

3つのコマンド、3つのローカライズされたレポート — すべて数式と書式が保持されています。これが AI 主導のスプレッドシート翻訳の力です。

7. 主な利点

  • Zero AI インフラストラクチャ: モデルをホストする必要も、GPU をプロビジョニングする必要もありません。AI は Aspose のクラウド上で実行されます。
  • 構造の保持: 翻訳によってスプレッドシートが壊れることはありません — 数式、チャート、レイアウトはそのままです。
  • 柔軟な入力: ファイルアップロードと生テキストの両方を受け付け、最大の互換性を提供します。
  • 数秒でプロジェクト計画: 曖昧なタスク説明を構造化された割り当て可能な計画に変換します。
  • SDK サポート: .NET、Python、Java 用の公式 SDK が利用可能 — または cURL を使ったシンプルな REST を使用できます。

8. エラー処理

ステータス 意味 典型的な原因
400 不正なリクエスト targetLanguage が欠落または無効、コンテンツが空、またはタスク記述が不正な形式
401 認証エラー 認証に失敗した、または資格情報が欠如している
500 サーバーエラー AI サービスが一時的に利用できない、またはスプレッドシート処理エラー

本番コードでは、常にレスポンスステータスを確認し、エラーを適切に処理してください。

9. 次は何ですか？

AI コントローラには、高度なシナリオ向けのさらに強力なエンドポイントが3つあります:

  • ai/report/analysis — スプレッドシートデータを自動的に分析し、プロフェッショナルなMarkdownレポートを生成します
  • ai/summarize/spreadsheet — 大規模なブックのインテリジェントな要約を作成します
  • ai/categorize/spreadsheet — 列データを論理的なグループに分類します（例：費用のカテゴリ分け）

さらに、翻訳のために 独自の AI エンドポイントを持ち込む（DeepSeek、カスタムの OpenAI 互換サービス）を使用できます。これらすべては Advanced Guide に記載されています。

今すぐ始めましょう: Aspose Cloud Dashboard から認証情報を取得し、上記のサンプルを実行してください。数分で AI 搭載のスプレッドシート処理が利用可能になります。