Elektronik Tabloları Akıllı Çalışmaya Dönüştürün: Aspose.Cells Cloud AI Controller için Geliştirici Rehberi

Yapay zeka destekli çeviri, görev ayrıştırma ve metin işleme ekleyerek elektronik tablo iş akışınıza — basit REST çağrılarıyla, ML uzmanlığı gerektirmeden — güç katın.

Her geliştirme ekibi aynı duvara çarpar: elektronik tablo verileri, aşağı akış sistemleri için faydalı olmadan önce çevirilmesi, özetlenmesi, kategorize edilmesi veya yeniden düzenlenmesi gerekir. Geleneksel olarak, bu özel betikler, kırılgan regex zincirleri veya pahalı manuel çalışma anlamına geliyordu.

Aspose.Cells Cloud AI Controller bunu değiştirir. Güçlü AI yeteneklerini — çeviri, görev planlama, metin işleme — bir avuç temiz REST uç noktasına sarar. Bir elektronik tablo yükleyin veya ham metin gönderin ve akıllı sonuçları geri alın. Model barındırma yok, istem mühendisliği yok, bakım gerektiren altyapı yok.

Bu gönderi, her geliştiricinin bilmesi gereken üç temel API’yi, cURL, C# ve Python‘da çalıştırılabilir örneklerle anlatıyor.

1. AI Kontrolörü Ne İş Yapar?

AIController (kaynak: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs) AI destekli elektronik tablo ve metin işleme API’lerini sağlar. Üç temel senaryoyu ele alır:

Tüm uç noktalar v4.0/cells/ai/... önekini kullanır ve OAuth 2.0 kimlik doğrulamasını Aspose Cloud kontrol paneli üzerinden gerektirir.

2. Başlamadan Önce

1. Kimlik bilgilerini alın: Aspose Cloud Dashboard’a kaydolun, bir Uygulama oluşturun ve Client ID ile Client Secret anahtarlarınızı alın.
2. Bir SDK kurun (isteğe bağlı — cURL da sorunsuz çalışır):

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

# Python
pip install asposecellscloud

3. Uç Nokta 1: AI Görev Ayrıştırması

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

Bu uç nokta, bir proje veya görev listesinin doğal dil açıklamasını alır, ardından AI kullanarak bunu SMART kriterlerine göre yapılandırılmış bir plana dönüştürür. Çıktı, ID, Subject, Assignee, Estimated Duration, Description, Dependencies sütunlarıyla biçimlendirilmiş bir Excel dosyasıdır.

Bu, Redmine, Jira veya Trello gibi araçlar için hazır‑içe aktarılabilir bir görev listesine dönüştürmek isteyen ve kaba bir fikri (“backend, frontend ve test içeren yeni bir özellik oluştur”) gerçekleştirmek isteyen proje yöneticileri için mükemmeldir.

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

Ne elde edersiniz: Profesyonel biçimlendirilmiş bir tablo içeren bir Excel dosyası — her satır, tahmini saatler, sorumlu önerileri ve bağımlılık bağlantıları içeren bir alt görevdir.

4. Uç Nokta 2: Elektronik Tablo Çevirisi

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

Bir elektronik tabloda tüm metin içeriğini hedef bir dile çevirir. AI, hücre konumlarını, formülleri, biçimlendirmeyi ve çoklu sayfa yapısını korur. Yalnızca insan tarafından okunabilir metin çevrilir — =SUM(A1:A10) gibi formüller aynı kalır.

Desteklenen hedef diller standart ISO kodlarını kullanır: es (İspanyolca), fr (Fransızca), de (Almanca), zh (Çince), ja (Japonca), vb.

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

Temel fayda: Çok sayfalı çalışma kitapları tamamen desteklenir. Çıktı dosyası otomatik olarak {original}_translated.{ext} olarak adlandırılır.

5. Uç Nokta 3: Metin Dosyası Çevirisi

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

Düz metin içeriğini — bir dosya olarak yüklenmiş ya da doğrudan istek gövdesinde gönderilmiş — çevirir. Belgeleri, notları, CSV içeriğini veya herhangi bir metin tabanlı veriyi çevirmek için kullanışlıdır.

İki giriş modu:

• Dosya yükleme: multipart/form-data aracılığıyla bir .txt dosyası gönderin → yanıt olarak çevrilmiş bir .txt dosyası alın
• Doğrudan metin: İstek gövdesinde ham metin gönderin → yanıt içinde çevrilmiş metni alın

cURL (Dosya Yükleme)

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 (Doğrudan Metin)

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

Yanıt gövdesi doğrudan çevrilmiş metni içerir.

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. Hızlı Bakış: Çok Uluslu Bir Raporu Çevir

İngilizce bir finansal raporunuz (Q3_Report.xlsx) olduğunu ve bu raporu İspanya, Fransa ve Almanya’daki ekiplerle dağıtmanız gerektiğini hayal edin.

Adım 1: İspanyolcaya çevir:

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

Step 2: Fransızcaya çevir:

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

Adım 3: Almancaya çevirin:

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

Üç komut, üç yerelleştirilmiş rapor — formüller ve biçimlendirme korunmuş şekilde. İşte AI destekli elektronik tablo çevirisinin gücü.

7. Anahtar Avantajlar

• Sıfır AI altyapısı: Barındırılacak model yok, tahsis edilecek GPU yok. AI, Aspose’un bulutunda çalışır.
• Yapı koruması: Çeviri, elektronik tablonuzu bozmaz — formüller, grafikler ve düzen aynı kalır.
• Esnek giriş: Maksimum uyumluluk için hem dosya yüklemelerini hem de ham metni kabul eder.
• Saniyeler içinde proje planlaması: Belirsiz görev açıklamalarını yapılandırılmış, atanabilir planlara dönüştürür.
• SDK desteği: .NET, Python ve Java için resmi SDK’lar — ya da cURL ile basit REST kullanın.

8. Hata İşleme

Her zaman yanıt durumunu kontrol edin ve üretim kodunda hataları nazikçe ele alın.

9. Sonraki Adım?

AI Denetleyicisinin gelişmiş senaryolar için üç daha güçlü uç noktası vardır:

• ai/report/analysis — Elektronik tablo verilerini otomatik olarak analiz eder ve profesyonel Markdown raporları oluşturur
• ai/summarize/spreadsheet — Büyük çalışma kitaplarının akıllı özetlerini oluşturur
• ai/categorize/spreadsheet — Sütun verilerini mantıksal gruplara sınıflandırır (ör. gider sınıflandırması)

Ayrıca, çeviri için kendi AI uç noktanızı (DeepSeek, özel OpenAI uyumlu hizmetler) getirebilirsiniz. Bunun tümü Gelişmiş Kılavuz içinde ele alınmıştır.

Hemen başlayın: kimlik bilgilerinizi Aspose Cloud Dashboard üzerinden alın ve yukarıdaki örnekleri çalıştırın. Dakikalar içinde AI destekli elektronik tablo işleme sahip olacaksınız.