스프레드시트를 스마트 워크로 전환하기: 개발자를 위한 Aspose.Cells Cloud AI Controller 가이드

AI 기반 번역, 작업 분해 및 텍스트 처리를 스프레드시트 워크플로에 추가하세요 — 일반 REST 호출만으로, ML 전문 지식이 필요 없습니다.

모든 개발 팀은 동일한 장벽에 부딪힙니다: 스프레드시트 데이터는 번역, 요약, 분류, 또는 재구성 되어야 하며, 하위 시스템에서 유용하게 사용되기 전에. 전통적으로, 이는 맞춤 스크립트, 깨지기 쉬운 정규식 체인, 혹은 비용이 많이 드는 수동 작업을 의미했습니다.

Aspose.Cells Cloud AI Controller는 이를 변경합니다. 강력한 AI 기능 — 번역, 작업 계획, 텍스트 처리 — 을 소수의 깔끔한 REST 엔드포인트에 래핑합니다. 스프레드시트를 업로드하거나 원시 텍스트를 전송하면, 지능형 결과를 반환받을 수 있습니다. 모델 호스팅도, 프롬프트 엔지니어링도, 유지 관리 인프라도 필요 없습니다.

이 게시물에서는 모든 개발자가 알아야 할 세 가지 기본 API를 살펴보고, cURL, C#, 및 Python에 대한 실행 가능한 예제를 제공합니다.

1. AI 컨트롤러는 무엇을 하나요?

AIController (source: src/Aspose.Cells.Cloud.MicroService/Controllers/AIController.cs)는 AI 기반 스프레드시트 및 텍스트 처리 API를 제공합니다. 세 가지 핵심 시나리오를 처리합니다:

# 시나리오 엔드포인트 무엇을 수행합니까
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="Aspense.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");

파이썬

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 (스페인어), fr (프랑스어), de (독일어), zh (중국어), ja (일본어) 등을 사용합니다.

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

파이썬

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 콘텐츠 또는 텍스트 기반 데이터 번역에 유용합니다.

두 입력 모드:

  • 파일 업로드: 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."

응답 본문에 번역된 텍스트가 직접 포함됩니다.

파이썬

# 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)가 있으며 이를 스페인, 프랑스 및 독일 팀에 배포해야 합니다.

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

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

세 개의 명령, 세 개의 현지화된 보고서 — 모두 수식과 서식이 유지됩니다. 이것이 AI 기반 스프레드시트 번역의 힘입니다.

7. 핵심 이점

  • Zero AI 인프라: 모델을 호스팅할 필요도 없고, GPU를 프로비저닝할 필요도 없습니다. AI는 Aspose의 클라우드에서 실행됩니다.
  • 구조 보존: 번역이 스프레드시트를 깨뜨리지 않으며 — 수식, 차트 및 레이아웃이 그대로 유지됩니다.
  • 유연한 입력: 파일 업로드와 원시 텍스트 모두를 받아 최대 호환성을 제공합니다.
  • 몇 초 만에 프로젝트 계획: 모호한 작업 설명을 구조화된 할당 가능한 계획으로 전환합니다.
  • SDK 지원: .NET, Python 및 Java용 공식 SDK — 또는 cURL을 사용한 일반 REST를 사용할 수 있습니다.

8. 오류 처리

상태 의미 일반적인 원인
400 잘못된 요청 targetLanguage가 누락되었거나 잘못되었으며, 내용이 비어 있거나 작업 설명이 잘못된 경우
401 인증되지 않음 인증 실패 또는 자격 증명 누락
500 서버 오류 AI 서비스가 일시적으로 사용 불가능하거나 스프레드시트 처리 오류

항상 응답 상태를 확인하고 프로덕션 코드에서 오류를 우아하게 처리하십시오.

9. 다음은 무엇인가요?

AI 컨트롤러에는 고급 시나리오를 위한 세 가지 더 강력한 엔드포인트가 있습니다:

  • ai/report/analysis — 자동으로 스프레드시트 데이터를 분석하고 전문적인 Markdown 보고서를 생성합니다
  • ai/summarize/spreadsheet — 대형 워크북에 대한 지능형 요약을 생성합니다
  • ai/categorize/spreadsheet — 열 데이터를 논리적 그룹으로 분류합니다 (예: 비용 분류)

또한, 번역을 위해 직접 AI 엔드포인트 (DeepSeek, 맞춤형 OpenAI 호환 서비스)를 사용할 수 있습니다. 이 모든 내용은 Advanced Guide에서 다룹니다.

지금 시작하세요: Aspose Cloud Dashboard에서 자격 증명을 가져오고 위의 예제를 실행하세요. 몇 분 안에 AI 기반 스프레드시트 처리를 사용할 수 있습니다.