tmustier/pi-for-excel

Pi for Excel – AI 기반 스프레드시트 보조 도구

무엇인가요 – Microsoft Excel 내부에 대화형 AI 에이전트를 직접 통합하는 오픈소스 Office 애드인입니다. Anthropic, OpenAI, Google Gemini, GitHub Copilot 또는 사용자 정의 OpenAI 호환 엔드포인트를 포함한 원하는 LLM을 설정하면, 워크북의 읽기, 쓰기, 서식 지정, 분석이 가능합니다.

주요 기능

• 16개의 내장 스프레드시트 도구 – 예: read_range, write_cells, fill_formula, search_workbook, explain_formula, conditional_format, 수식 종속성 추적을 위한 도구 등.
• 다중 모델 지원 – 슬래시 명령어(/model)를 통해 실시간으로 제공자나 모델을 전환 가능.
• 세션 관리 – 각 워크북마다 여러 채팅 탭, 자동 저장, 기록, /resume 명령어 지원.
• 자동 컨텍스트 주입 – AI는 워크북의 구조, 현재 선택 영역, 최근 변경 사항을 자동으로 수신하므로 시트를 설명할 필요가 없습니다.
• 한 번의 클릭으로 롤백 – 모든 변경 작업 시 체크포인트 생성; 사이드바에서 즉시 변경 사항을 되돌릴 수 있습니다.
• 서식 규칙 – 통화 기호, 음수 표기 방식, 소수점 자릿수 등 하우스 스타일 규칙을 한 번 정의하면 에이전트가 자동으로 따릅니다.
• 슬래시 명령어 및 확장 기능 – /settings, /tools, /extensions 등과 함께, AI가 생성한 사전 보호된 확장 기능(미니 앱) 설치 가능.
• 외부 통합 – 선택적 웹 검색(Jina, Serper, Tavily, Brave) 및 사용자 정의 도구용 MCP 게이트웨이 제공.

설치 방법

1. 리포지토리에서 manifest.prod.xml을 다운로드하거나 Vercel 호스팅 URL을 사용합니다.
2. Excel에 매니페스트를 추가합니다 (macOS, Windows, 또는 Excel 웹 버전 – 링크된 설치 가이드 참조).
3. 리본에서 Pi 패널을 열고 API 키 또는 OAuth로 제공자에 연결한 후 채팅을 시작합니다 (예: "어떤 시트가 있나요?").

개발자용 빠른 시작

• Node ≥ 22.19 (또는 ≥ 24) 및 로컬 HTTPS용 mkcert 필요.
• 복제 후 npm install 실행, 로컬 인증서 생성 후 npm run dev 실행 (Vite가 https://localhost:3141에서 애드인 제공).
• 리포지토리의 사이드로드 지침에 따라 개발용 매니페스트를 Excel에 로드합니다.
• 옵션 헬퍼: npx pi-for-excel-proxy (OAuth용 CORS 프록시), npx pi-for-excel-python-bridge, npx pi-for-excel-tmux-bridge (로컬 Python/LibreOffice 또는 tmux 브리지용).

아키텍처 개요

• 프론트엔드 – Lit 웹 컴포넌트로 구축된 Vite 번들링 단일 페이지 작업 패널.
• 에이전트 코어 – @earendil-works/pi-agent-core는 도구 루프, 스트리밍, 상태 관리를 수행.
• LLM 추상화 – @earendil-works/pi-ai는 Anthropic, OpenAI, Gemini, Copilot 또는 사용자 정의 엔드포인트에 대해 일관된 API 제공.
• Office.js – 워크북 읽기/쓰기 및 UI 통합 관리.
• 도구 레지스트리 – 16개의 핵심 도구의 중앙 정의; UI, 프롬프트, 런타임 모두 이 레지스트리에서 파생.
• 확장 사전 보호 환경 – 신뢰할 수 없는 확장은 권한 강제 적용된 iframe에서 실행.
• 저장소 – IndexedDB는 세션 데이터, 체크포인트, 사용자 수준 규칙을 보관.

왜 중요한가요 Pi for Excel은 전통적인 생산성 앱에 고도로 기능적인 LLM 기반 에이전트를 통합하는 방법을 보여주며, 정적 스프레드시트를 상호작용 가능한 AI 강화 작업 공간으로 전환합니다. 도구 레지스트리, 자동 컨텍스트 주입, 체크포인트 기반 롤백, 사전 보호 확장 기능과 같은 실용적인 패턴은 다른 Office 애드인이나 데스크톱 앱의 AI 통합에도 재사용 가능합니다.

라이선스 – MIT (© Thomas Mustier)