수동 Excel 계산은 느리고 오류가 발생하기 쉬우며, 엔터프라이즈 데이터 워크플로로 확장하는 것이 불가능합니다. 재무 보고 도구, 비즈니스 분석 대시보드 또는 일괄 데이터 처리 시스템을 구축하든, .NET으로 Excel에서 계산 자동화하기는 인적 오류를 제거하고 워크플로 속도를 높이며 애플리케이션 전반에서 스프레드시트 로직을 표준화합니다.
VBA, Interop 또는 레거시 라이브러리와 같은 기존 Excel 자동화 방법에는 설치된 Microsoft Office에 대한 의존성, 제한적인 크로스 플랫폼 지원, 경직된 수식 스크립팅, 대용량 데이터셋에 대한 낮은 성능 등 상당한 한계가 있습니다.
이 가이드에서는 Spire.Agent.Office를 소개합니다. 이는 Office 설치와 완전히 독립적으로, 동적이고 지능적으로 Excel에서 계산을 자동화할 수 있게 해 주는 최신 .NET AI 에이전트 라이브러리입니다.
- 기존 Excel 자동화가 부족한 이유
- Spire.Agent.Office 소개 – AI 솔루션
- 전제 조건 및 설치
- 단계별: Spire.Agent.Office로 Excel에서 계산 자동화하기
- 고급 자동화: 수백 개 파일 일괄 처리
- 자주 묻는 질문(FAQ)
기존 Excel 자동화가 부족한 이유
기존 방식은 현대 엔터프라이즈 배포에 치명적인 한계가 있습니다.
| 방법 | 단점 |
|---|---|
| VBA | Windows 전용, Office 설치 필요, 대용량 데이터셋에서 느림, AI 없음. |
| Interop | 메모리 누수 발생 가능, 서버 안전하지 않음, 비싼 라이선스. |
| Open XML SDK | 저수준, 복잡함, 수식 생성 없음, AI 없음. |
| Spire.XLS | 수식 생성에는 탁월하지만 AI 추론 기능이 없습니다. 모든 IF 또는 VLOOKUP 문자열을 하드코딩해야 합니다. |
해결책은? 비즈니스 규칙을 일반 영어로 이해하고 대규모로 실행하는 최신 .NET AI 에이전트 SDK입니다.
Spire.Agent.Office 소개 – AI 솔루션
Spire.Agent.Office는 .NET용 고급 AI 기반 문서 자동화 라이브러리로, Excel, Word, PowerPoint 및 PDF 처리를 간소화하도록 설계되었습니다. 전용 Spire.Agent.XLS 모듈은 수식 생성, 자동 계산, 데이터 분석 및 스프레드시트 변환을 포함한 지능형 Excel 자동화를 전문으로 합니다.
정적 라이브러리와 달리 Spire.Agent.Office는 동적 계산 기능을 추가합니다. 원하는 내용을 설명하면 AI가 이를 정확한 Excel 수식으로 변환하고 실행합니다.
어떻게 작동하나요?
이 라이브러리는 최신 LLM(대규모 언어 모델) 강화 워크플로에서 작동합니다. 기술 파이프라인은 다음과 같습니다:
Developer Input (Workbook + Plain-Text Prompt)
↓
Spire.Agent.Office (AI Translation Layer)
↓
Structured Computation Plan
↓
Spire.Office (Execution Engine)
↓
Updated Excel File or Data Output
- 입력 계층: 개발자는 .xls 또는 .xlsx 파일, 일반 텍스트 프롬프트, AI 인증용 SpireToken을 제공합니다.
- 의미 분석: Spire.Agent.Office AI가 통합 문서 메타데이터를 스캔하고 프롬프트와 함께 LLM으로 전송합니다.
- 구조화된 계획: AI는 원시 수식 텍스트가 아닌 결정적 계산 계획, 즉 순서가 지정된 엔진 작업 집합을 생성합니다.
- 실행 엔진: Spire.Office가 계획을 실행하고, Excel을 실행하지 않고 셀에 수식을 직접 작성하며, 종속성 체인의 전체 재계산을 강제합니다.
- 출력: 업데이트된 통합 문서가 디스크에 저장되거나 직접 API 응답용 MemoryStream으로 반환됩니다.
핵심 Excel 계산 기능
- 코드 또는 자연어 프롬프트를 통해 Excel에서 수식(SUM, AVERAGE, VLOOKUP, IF 함수) 자동 생성 및 추가
- 프로그래밍 방식으로 전체 통합 문서/워크시트 재계산 강제
- 여러 Excel 파일 및 대용량 데이터셋에 대한 일괄 계산 자동화
- 정확한 결과를 보장하기 위한 계산 전 AI 기반 데이터 정리
- 데이터셋 변경에 따른 동적 수식 조정
- 계산된 Excel 파일을 PDF, CSV 및 기타 형식으로 원활하게 내보내기
전제 조건 및 설치
.NET 프로젝트에서 Spire.Agent.Office로 스프레드시트 자동화를 시작하려면 다음 설정을 준비하세요:
- .NET 프로젝트(Console, ASP.NET, WinForms 또는 .NET Core)
- 필수 NuGet 패키지 설치: Spire.Agent.Office
- AI 에이전트 기능 활성화를 위한 임시 Spire Token 요청
NuGet 설치 명령:
Install‑Package Spire.Agent.Office
전체 설정 지침은 .NET 프로젝트에 Spire.Agent.Office 통합하기를 참조하세요.
단계별: Spire.Agent.Office로 Excel에서 계산 자동화하기
다음은 이 .NET AI Agent SDK를 사용하여 영업 수수료 계산을 동적으로 자동화하는 개발자 중심 워크플로입니다.
1단계: AI 에이전트 초기화 및 문서 로드
코드에서 Spire.Agent를 인스턴스화하고 대상 Excel 통합 문서를 로드합니다. 에이전트는 기본 Spire.Office 엔진을 사용하여 통합 문서의 메타데이터를 스캔합니다.
using Spire.Agent.Office.AI;
using Spire.Agent.Office.Extensions;
using Spire.Xls;
AIOptions options = new AIOptions();
options.SpireToken = "your_spire_token";
Workbook workbook = new Workbook();
workbook.LoadFromFile("SalesData.xlsx");
AIDocumentProcessor processor = workbook.AI(options);
2단계: 자연어로 계산 로직 정의
여기에서 AI의 마법이 일어납니다. 모든 행에 대해 복잡한 IF 문을 수동으로 작성하는 대신, 에이전트에 프롬프트를 보냅니다:
string instruction = @"
In this input sales dataset. Column A is 'Sales Rep', Column B is 'Revenue', Column C is 'Target'.
Add a Column D with the same style and set its header as 'Commission' in D1
Create a calculation rule for Column D (Commission):
If Revenue exceeds Target, calculate 15% of Revenue. Otherwise, calculate 5%.
Apply this formula to the entire data range dynamically.
";
3단계: 계획 실행
에이전트는 정적 수식 텍스트가 아닌 구조화된 계산 계획을 생성합니다. Spire.Office는 계산된 필드를 워크시트 셀에 직접 적용합니다.
AIResult result = processor.ExecuteInstruction(
workbook,
instruction,
"Calculated_data.xlsx"
);
전체 C# 코드 예제:
using Spire.Agent.Office.AI;
using Spire.Agent.Office.Extensions;
using Spire.Xls;
AIOptions options = new AIOptions();
options.SpireToken = "spireToken";
using (Workbook workbook = new Workbook())
{
workbook.LoadFromFile("SalesData.xlsx");
AIDocumentProcessor processor = workbook.AI(options);
string instruction = @"
In this input sales dataset. Column A is 'Sales Rep', Column B is 'Revenue', Column C is 'Target'.
Add a Column D with the same style and add a header 'Commission' in D1
Create a calculation rule for Column D (Commission):
If Revenue exceeds Target, calculate 15% of Revenue. Otherwise, calculate 5%.
Apply this formula to the entire data range dynamically.
";
AIResult result = processor.ExecuteInstruction(
workbook,
instruction,
"Calculated_data.xlsx"
);
}
핵심 API 개요
-
AIOptions: AI 에이전트의 구성 컨테이너입니다.
SpireToken(인증에 필요)을 설정하고,TimeoutMs(선택 사항)를 조정하며, 임시 파일용WorkDir를 지정하는 데 사용합니다. -
AIDocumentProcessor: 문서 처리를 담당하는 AI 에이전트 인스턴스입니다. 지원되는 모든 문서 객체(
Workbook,Document,Presentation또는PdfDocument)에서.AI()확장 메서드를 호출하여 얻습니다. -
AIResult:
ExecuteInstruction의 반환 객체입니다. 실행 상태와 출력 경로를 포함하므로 성공 여부를 확인하거나 프로그래밍 방식으로 오류를 처리할 수 있습니다.
결과:
출력 파일에서 D열은 올바른 Excel 수식으로 채워집니다: =IF(B2>C2, B2*0.15, B2*0.05)
고급 자동화: 수백 개 파일 일괄 처리
월별 반복 보고서의 경우, 로직을 루프로 감싸 전체 폴더를 처리하세요:
using System.IO;
using Spire.Agent.Office.AI;
using Spire.Agent.Office.Extensions;
using Spire.Xls;
// 1. Configuration
string inputFolder = @"C:\reports\inbox";
string outputFolder = @"C:\reports\output";
string spireToken = "your_spire_token";
// Ensure the output directory exists
Directory.CreateDirectory(outputFolder);
// 2. Setup AI Options
AIOptions agentOptions = new AIOptions();
agentOptions.WorkDir = outputFolder; // Sets the working/temp directory
agentOptions.SpireToken = spireToken;
// 3. Define your calculation logic (Natural Language Prompt)
string calculationPrompt = @"Input your calculation logic";
// 4. Loop through all Excel files
foreach (string file in Directory.GetFiles(inputFolder, "*.xlsx"))
{
// Define the output path (keeps the same filename)
string outputPath = Path.Combine(outputFolder, Path.GetFileName(file));
// Dispose the workbook after each file to free memory
using (Workbook workbook = new Workbook())
{
// Load the source Excel file
workbook.LoadFromFile(file);
// Execute the AI instruction
AIResult result = workbook.AI(agentOptions).ExecuteInstruction(
workbook, // Pass the document instance
calculationPrompt, // The prompt
outputPath, // Full path to save the processed file
new string[] { } // Additional options (empty array)
);
}
}
✅ 엔터프라이즈 자동화의 주요 이점
- 100% 서버 측: 야간 일괄 작업으로 수천 개의 .xlsx 파일을 처리합니다. UI 팝업도, 렌더링 지연도 없습니다.
- Office 설치 불필요: CI/CD 파이프라인 또는 웹 서버에서 Office 라이선스를 제거합니다.
- AI 기반 로직 변환: 복잡한 규칙을 에이전트에게 일반 영어로 설명하면, 에이전트가 Spire.Office가 적용할 기본 수식 또는 C# 로직을 생성합니다.
- 고성능: .NET Core/.NET 6+ 기반으로 구축되어 최적화된 메모리 관리로 대규모 데이터 처리를 처리합니다.
마무리 생각
Excel에서 계산 자동화는 더 이상 키 입력을 기록하는 것이 아니라 소프트웨어 인프라에 지능형 로직을 통합하는 것입니다. Spire.Agent.Office는 인간의 비즈니스 요구 사항(자연어)과 기계 실행(Spire.Office의 강력한 .NET API) 사이의 간극을 연결합니다.
이 아키텍처를 채택하면 데스크톱에 대한 의존성을 제거하고, 인적 오류를 크게 줄이며, Excel 보고를 완전 자동화된 서버 측 파이프라인으로 전환할 수 있습니다.
차세대 스프레드시트 자동화를 구축할 준비가 되셨나요? NuGet 패키지를 추가하고, SpireToken을 요청한 다음, 몇 분 안에 첫 프롬프트를 작성하여 엔드투엔드 데이터 파이프라인을 재구성하세요.
자주 묻는 질문(FAQ)
질문: INDEX/MATCH 또는 XLOOKUP 같은 복잡한 Excel 수식을 자동화할 수 있나요?
답변: 예. Spire.Agent.Office는 대부분의 최신 Excel 함수를 지원합니다. "Product ID를 기준으로 Sheet2에서 가격을 찾으려면 XLOOKUP을 사용하세요"와 같이 프롬프트할 수 있으며, 라이브러리가 정확한 중첩 구문을 생성합니다.
질문: Microsoft Excel을 설치하지 않고 .NET에서 Excel 계산을 자동화할 수 있나요?
답변: 예. Spire.Agent.Office는 Microsoft Office 설치 없이 Excel 계산 자동화를 지원하는 완전 독립 실행형 라이브러리입니다.
질문: AI 프롬프트 해석은 얼마나 정확한가요?
답변: Spire.Agent.Office는 스프레드시트 자동화 워크플로에 최적화된 고급 언어 모델을 사용합니다. 복잡한 로직, 시트 간 참조, 동적 범위를 높은 정확도로 처리합니다. 그러나 프로덕션 배포 전에 샘플 데이터로 프롬프트를 테스트하는 것이 좋습니다.
질문: Spire.Agent.Office는 일괄 처리를 지원하나요?
답변: 예. Excel 파일이 있는 전체 폴더를 반복하면서 각 파일에 동일한 AI 지침을 적용할 수 있으므로, 월별 반복 보고서 및 대량 데이터 처리 파이프라인에 이상적입니다.