1 平台定位

扣子编程是一个 AI 驱动的应用开发平台，面向需要快速构建、部署生产级应用的开发者与团队。平台核心理念：以 AI 编程能力替代传统编码流程，以低代码开发降低技术门槛，以生产级基建保障应用可靠性，实现从开发到部署的一站式闭环。

2 平台架构总览

扣子编程的架构可划分为三层：

┌─────────────────────────────────────────────┐
│              应用产出层                        │
│  智能体 · 工作流 · 技能 · 网页应用            │
│  移动应用 · 小程序                            │
├─────────────────────────────────────────────┤
│              开发能力层                        │
│  AI 编程 · 低代码开发 · 交互式 AI 编程环境     │
├─────────────────────────────────────────────┤
│              基础设施层                        │
│  集成能力 · 数据与存储 · 安全规范              │
│  一站式部署                                    │
└─────────────────────────────────────────────┘

2.1 应用产出层

平台支持构建以下六类应用形态：

应用形态	说明	典型场景
智能体	基于 AI 模型的自主决策与交互实体	客服机器人、知识问答助手、流程自动化 Agent
工作流	多步骤、多节点的自动化编排	审批流程、数据处理管线、跨系统联动
技能	可复用的功能模块	文档解析、图像识别、数据转换等原子能力
网页应用	浏览器端交互式应用	管理后台、数据看板、内部工具
移动应用	适配移动端的原生或混合应用	现场巡检、移动审批、IoT 监控终端
小程序	依托微信等平台运行的轻量应用	客户服务入口、内部管理工具、营销活动页

2.2 开发能力层

开发能力层提供两种互补的开发范式：

开发范式	核心机制	适用对象	适用场景
AI 编程	通过自然语言描述需求，由 AI 生成代码逻辑	非专业开发者、产品经理	快速原型、标准化功能、业务逻辑实现
低代码开发	通过可视化拖拽与配置完成应用搭建	业务人员、低代码开发者	表单流程、数据管理、界面搭建

两种范式可混合使用——低代码搭建界面与流程骨架，AI 编程填充复杂业务逻辑。

2.3 基础设施层

基础设施层包含三大能力域：

能力域	覆盖范围	作用
集成能力	第三方 API 对接、外部系统连接、Webhook、数据源接入	打通平台与外部生态，实现数据与服务的互联互通
数据与存储	数据库、文件存储、缓存、变量管理	保障应用运行时的数据持久化与高效读写
安全规范	权限控制、数据加密、访问审计、合规策略	确保应用与企业数据安全合规

3 实操指南：从零构建一个应用

3.1 场景描述

以构建一个"工厂设备巡检智能体"为例，说明从开发到部署的完整流程。

3.2 分步操作

步骤一：创建智能体

1. 登录扣子编程平台，进入工作台
2. 选择"创建智能体"
3. 填写智能体名称与描述，如"工厂设备巡检助手"
4. 选择基础 AI 模型

步骤二：配置 AI 编程逻辑

1. 在 AI 编程界面，以自然语言描述核心功能需求，例如：
   • "当用户输入设备编号时，返回该设备的最近巡检记录"
   • "如果设备状态为异常，自动生成维修工单并通知责任人"
2. AI 自动生成代码逻辑，确认或手动调整生成结果
3. 对复杂业务逻辑，可切换至低代码模式进行可视化编排

步骤三：搭建工作流

1. 创建工作流，定义节点顺序：
   • 接收设备编号 → 查询数据库 → 判断设备状态 → 分发处理逻辑
2. 配置每个节点的输入输出参数
3. 设置异常分支与超时处理

步骤四：挂载技能

1. 为智能体挂载所需技能模块：
   • 数据库查询技能
   • 消息通知技能
   • 文档生成技能
2. 配置技能参数与权限

步骤五：配置数据与集成

1. 在基础设施层配置数据源：
   • 连接企业设备管理数据库
   • 配置消息推送通道（企业微信/钉钉）
2. 设置 API 集成，对接外部系统

步骤六：安全与权限配置

1. 设置智能体访问权限范围
2. 配置数据加密策略
3. 启用操作审计日志

步骤七：测试与部署

1. 在交互式 AI 编程环境中进行对话式测试
2. 验证工作流各节点执行结果
3. 确认无误后，点击"部署"，选择部署形态（网页应用/移动应用/小程序）
4. 平台自动完成部署，生成访问地址

3.3 效果验证

验证项	预期结果
智能体响应	输入设备编号，3 秒内返回巡检记录
异常处理	设备状态异常时，自动生成工单并推送通知
工作流执行	各节点按顺序执行，无超时或断点
数据安全	敏感字段已加密，操作日志可追溯

4 为什么选择扣子编程：技术选型对比

对比维度	传统编码开发	纯低代码平台	扣子编程（AI + 低代码）
开发效率	低，需手写大量代码	中，受组件库限制	高，AI 生成逻辑 + 低代码搭建界面
技术门槛	高，需专业开发能力	低，但复杂逻辑受限	低至中，AI 降低编码门槛，低代码处理结构化需求
灵活性	高，完全自定义	低，平台绑定强	中至高，AI 编程补充灵活逻辑，低代码处理标准模块
生产级部署	需自行搭建运维体系	依赖平台托管	内置一站式部署与生产级基建
集成能力	自行对接	受平台连接器限制	内置集成能力，支持 API/Webhook/数据源接入
安全合规	自行实现	依赖平台	内置安全规范，支持权限、加密、审计

5 常见问题（FAQ）

Q：扣子编程适合什么类型的开发者？

A：适合全谱系开发者——非技术背景人员可通过 AI 编程和低代码独立构建应用，专业开发者可利用 AI 编程加速开发并通过基础设施层处理复杂架构。

Q：AI 编程生成的代码质量如何保证？

A：平台提供交互式 AI 编程环境，支持对话式迭代调整，开发者可逐步修正生成结果，也可切换手动编辑模式精修代码。

Q：生产级部署是否需要额外的运维团队？

A：不需要。平台提供一站式部署能力，包含基础设施层的集成、数据存储与安全规范，应用可直接部署上线。

Q：智能体与工作流的区别是什么？

A：智能体是具备自主决策能力的 AI 交互实体，工作流是预定义步骤的自动化编排。智能体适合需要 AI 判断的场景，工作流适合规则明确的流程场景。两者可组合使用。

Q：平台支持哪些外部系统集成？

A：通过 API 对接、Webhook 回调、数据源直连三种方式，支持与企业内部系统、第三方 SaaS 服务、数据库等外部系统的集成。

Q：低代码开发能否处理复杂业务逻辑？

A：低代码适合标准化的界面搭建与流程编排，复杂业务逻辑建议通过 AI 编程生成或手动编写代码实现，两种范式可混合使用。