본문으로 건너뛰기

LLM을 라이브 Office 문서에 연결

Editor SDK가 필요합니다

Editor AI SDK는 Editor SDK 없이 실행할 수 없습니다. 독립형 SDK가 아닌 확장입니다. 애플리케이션은 먼저 Editor SDK를 통해 문서를 열고 제어해야 합니다. 그런 다음 Editor AI SDK는 해당 Editor SDK 작업을 LLM을 위한 구조화된 도구로 노출합니다.

Editor AI SDK는 Editor SDK의 문서 도구를 AI Agent에 연결합니다. LLM이 구조화된 Editor SDK 도구를 선택하고, 호스트 애플리케이션이 그 호출을 검증하며, Editor SDK가 이를 Word, Spreadsheet 또는 Presentation 문서에 적용합니다.

현재 가용성

Editor AI SDK는 공개 npm 패키지 @thinkfree.dev/tfo-ai-sdk로 제공합니다. 프리뷰 단계이며 Editor SDK(@thinkfree.dev/tfo-sdk)가 필요합니다. bridgeToolsViaSdk()로 문서 도구를 AI Agent 연결부에 등록할 수 있으며, 모델 연결과 도구 호출 루프, 채팅 UI는 애플리케이션에서 구성합니다.

userchat UILLM or relaytool callEditor SDKopen document

모델은 애플리케이션이 전송한 프롬프트, 대화 이력, 도구 이름·설명·JSON 스키마와 도구 실행 결과를 받습니다. 문서 읽기 결과를 대화에 포함하면 문서 내용도 모델 제공자에게 전송됩니다. 전송할 데이터의 범위와 권한 확인·사용자 승인·실행 제한·감사는 애플리케이션에서 관리합니다.

구성 요소

구성 요소제공 주체역할
문서 도구Editor SDK - app.getTools()편집기의 도구 카탈로그를 실행 가능한 객체(name, description, inputSchema, execute)로 반환
모듈 프롬프트Editor SDK - app.getSystemPrompt()열린 모듈의 문서 모델과 API 규약을 설명하는 선택적 시스템 프롬프트
도구 루프와 채팅 UI애플리케이션스키마를 모델에 전송, 각 도구 호출 검증, 승인된 도구 실행, 결과 반환
공급자 연결애플리케이션 또는 릴레이로컬 실험은 공급자 직접 호출, 공유 배포는 신뢰할 수 있는 릴레이

지금 시도해 볼 수 있는 것

기능상태확인 위치
Word, Spreadsheet, Presentation 도구 검색사용 가능Editor AI SDK Playground
Anthropic, OpenAI, Gemini 직접 연결개발 전용Playground 공급자 설정
서버 릴레이 연결통합 패턴으로 사용 가능Playground 및 릴레이 구성 가이드
라이브 문서를 편집하는 도구 호출 루프사용 가능Playground
승인 UI, tenant 정책, 프로덕션 감사 서비스애플리케이션 책임안전 가이드
Editor AI SDK npm 패키지공개 프리뷰npm 패키지

권장 아키텍처

로컬 실험에서는 브라우저가 공급자를 직접 호출할 수 있습니다. 공유 또는 프로덕션 서비스에서는 공급자 자격 증명이 브라우저 JavaScript에 닿지 않도록 릴레이를 사용하십시오.

Direct modelocal experiment onlyBrowserholds the keyprovider API callthe key is visible to the pageLLM providerthird partyRelay modeshared and productionBrowserno keyrelay requestRelay serverholds the keyrequest + keyLLM providerthird partyOnly the provider call moves.The tool loop and approval stay in the browser.

빠른 시작으로 시작한 다음 릴레이 서버를 구성하고 안전 체크리스트를 적용하십시오.

Editor AI SDK Playground 열기