# SpreadJS AI Agent

**Repository Path**: GrapeCity/spread-js-ai-agent

## Basic Information

- **Project Name**: SpreadJS AI Agent
- **Description**: spread-js-ai-agent
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-08-21
- **Last Updated**: 2025-09-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SpreadJS Agent with Langgraph - 从零开发教程

> 一个使用Langgraph和MCP技术为SpreadJS开发智能Agent的完整教程Demo

## 项目概述

SpreadJS拥有2000+个API，传统AI助手在处理复杂API时容易产生幻觉。本项目通过集成葡萄城官方的RAG搜索服务，让AI能自主查询准确的API文档，从而生成可靠的SpreadJS代码。

> 葡萄城AI搜索目前已经开源, 可以在[GC QA RAG](https://github.com/GrapeCity-AI/gc-qa-rag)项目中自行部署使用, 目前项目中使用的是context7进行搜索, 可以自行替换

### 核心特性

- 🤖 **智能搜索**：集成葡萄城AI搜索，获取准确API文档
- 🔄 **标准Langgraph**：Agent-Tools循环模式，动态条件路由
- 🌐 **实时通信**：WebSocket流式响应，展示完整执行过程
- 🛡️ **安全执行**：前后端分离，SpreadJS代码在浏览器安全执行
- 📚 **零依赖前端**：原生HTML/CSS/TS，无框架依赖

## 快速开始

### 环境要求

- Node.js 16+
- npm 或 yarn

### 安装和运行

```bash
# 克隆项目
git clone <repository-url>
cd sjs-agent-gcqa

# 安装依赖
npm install

# 配置OpenAI API Key
# 编辑 src/server/config.ts，修改 OPENAI_API_KEY

# 一键启动前后端服务
npm run dev
```

服务启动后：
- 前端页面：http://localhost:3000
- 后端API：ws://localhost:3001
- MCP Server服务端口: 3002

### 使用示例

在对话窗口中输入：
- "添加一个表格, 范围为A1:C4"