开发者指南导读
准备好体验全新的应用开发方式了吗？从这里开始，你将学会使用 AI 时代的全新技术体系构建功能强大的企业级应用。
开发指南提供从组织管理、应用开发基础到业务逻辑实现的完整学习路径，以及通过真实业务场景掌握复杂应用架构设计的最佳实践。
使用建议：新手按顺序学习，有经验的开发者可直接查看场景化进阶指南。
首先，你需要完成基本的下载安装。
基础概念
掌握 JitAI 平台的核心理念和架构原理。了解平台应用、元素体系、开发框架、可视化开发工具等基础概念，为后续开发工作奠定理论基础。
平台架构与核心概念
了解 JitAI 平台架构、应用概念、JAAP 协议、元素体系和开发框架，掌握平台的基础原理。
平台安装与节点激活
完成平台安装和节点激活流程。学习下载安装方法、节点激活流程、开发者团队管理等，建立开发环境基础。
节点激活与开发者团队
了解如何激活节点和管理开发者团队，包括组织绑定、成员管理等核心操作。
开发工具与发布服务
强大的工具链助力高效开发。掌握可视化开发环境、运维管理工具和云端发布服务，实现从开发到部署的完整工具链支持。
JitAI 可视化开发工具
掌握强大的可视化开发环境，熟悉 IDE 的各个功能区域，学会在可视化和源码双模式之间自由切换。
运维管理工具
双控制台架构的全面运维管理解决方案，提供从开发到部署的完整应用生命周期管理。
创建与发布应用
从应用创建到分布式部署的完整流程。掌握应用创建、源码管理、版本发布、运行环境配置，以及如何构建无限横向扩展的分布式集群架构。
创建和部署应用
学习应用的创建、继承、数据配置和部署流程，掌握应用开发的基础工作流程。
发布与升级应用
掌握应用版本管理、发布工作流程和升级策略，学习语义化版本控制和部署配置。
运行环境管理
掌握运行环境的创建、配置和管理，学习如何使用节点集群和应用部署。
前端门户与页面
设计精美的用户界面和交互体验。从门户导航到页面构建，从组件布局到数据管理，打造功能完整、用户友好的应用界面。
创建门户
设计不同用户角色的门户界面，配置导航菜单和权限控制，创建个性化用户体验。
组件化页面
理解组件化页面——JitAI页面系统的基础，由功能组件构建，用于数据展示和用户交互。
AI 数据管理页面
AI 加持的 ai-data-management-page，智能辅助高效完成数据浏览、筛选、编辑与批量操作。
全代码页面开发
面向高级开发者的完全自定义页面开发方式，支持复杂业务逻辑和个性化界面。
在门户和页面中使用 AI
通过 AI 智能能力提升用户体验。将 AI Agent 和智能组件集成到门户和页面中，提供个性化辅助与自动化工作流。
在页面中调用业务元素
将页面连接到强大的业务逻辑和数据操作。学习如何从页面调用服务函数和数据模型函数，创建动态的、数据驱动的用户界面，具备实时业务处理能力。
页面中的全代码自定义 UI 组件
创建具有完全编程控制的高级自定义 UI 组件。构建复杂的交互元素，与页面逻辑无缝集成，处理复杂事件，提供超越标准组件的丰富用户体验。
在页面中使用功能组件
丰富的组件库是你的超级工具箱。拖拽一个表格展示数据，添加表单收集信息，插入图表让数据可视化。让复杂的前端开发变得简单直观。
查看更多组件
交叉表
多维数据透视表，支持行列交叉分析，适用于数据统计和报表展示。
统计图表
丰富的数据可视化图表组件，支持柱状图、折线图、饼图等多种图表类型。
树组件
层次化数据展示组件，支持树形结构的展示、选择和操作。
列表组件
灵活的数据列表展示组件，支持标题、摘要、按钮等配置，适用于各类列表展示场景。
卡片与媒体展示
用于展示卡片式内容和媒体文件的组件，包括看板和画廊功能。
全代码组件
基于 React 开发页面级自定义组件，自主控制界面、逻辑、样式和模型数据操作。
甘特图
项目管理和进度追踪组件，支持任务依赖关系和进度可视化。
审批组件
与工作流集成的 UI 组件，用于提交审批申请、处理审批任务和管理审批历史，具有事件驱动通知功能。
数据解析与导入
强大的数据导入和解析工具，支持 Excel 文件批量导入、数据清洗、条件筛选和主子表关联导入。
点击上方"查看更多组件"可收起
AI 大模型
接入 GPT-4、Claude、通义千问等主流大模型。支持多厂商容灾和私有化部署，为应用提供智能对话、文本生成、代码辅助等 AI 能力。
为应用接入可复用的 AI 大模型
选择适合 Agent、知识库、业务函数和多模态生成的大模型来源，配置 API Key、备用 Key、可用模型和模型能力。
在页面和后端函数中调用大模型
配置模型、提示词变量和结构化输出，并按业务需要调用文本生成、向量化、重排和多模态生成函数。
AI 知识库
将企业文档、手册、FAQ 转化为智能知识库。支持文档自动处理、智能分段、语义检索、关键词召回和重排优化，让 AI 基于企业知识精准回答问题。
创建可被 Agent 检索的 AI 知识库
创建面向 Agent 和业务函数使用的 AI 知识库，选择向量数据库、向量模型和可选重排模型，并了解向量召回与关键词召回如何配合。
管理知识库资料并验证检索效果
向 AI 知识库添加本地文档或 Web URL，并通过重排、关键词召回、查询测试等设置优化检索效果。
在业务函数中调用 AI 知识库检索和维护资料
在后端可视化编程中调用 AI 知识库，完成语义检索、关键词检索、文档新增和文档删除。
让 Agent 按场景查阅知识库
在 Agent 中启用知识库，并根据任务范围选择智能模式、自定义模式或禁用模式。
向量数据库的独立部署
企业知识的智能存储引擎。将文本转化为向量数据，实现语义级精准搜索。
AI Agent
构建具备推理和行动能力的智能代理。从创建 Agent、配置工具与知识库，到管理记忆、文件空间和运行扩展，全面掌握 AI Agent 的开发与集成。
入门路径：先选型，再做出第一个可用 Agent
认识 AI Agent
Agent 可直接调用数据模型函数、服务函数和页面函数，触及应用的各个层次。了解四种 Agent 类型，找到适合你业务场景的方案。
从一个业务任务开始搭建可用 Agent
按一条完整主线完成 Agent 创建、模型选择、提示词编写、工具配置、测试验证和上线前检查。
最通用的 ReActAgent
ReActAgent—最通用的 AI Agent，支持推理与行动交替执行，自主完成任务。
擅长任务拆解与委派的 DeepAgent
DeepAgent—擅长任务拆解与子Agent委派，多角色协作完成复杂任务。
使用 EmbeddedAgent 将 Agent 嵌入外部网页
EmbeddedAgent—将已有 Agent 实例嵌入第三方网页，支持 JS SDK 和双向交互。
工具、知识和 Skill：让 Agent 能接入业务系统
让 Agent 查阅知识库
为 Agent 集成知识库，实现检索增强生成（RAG），提升回答的准确性和时效性。
为 Agent 开启联网搜索
为 Agent 配置公开网页搜索和网页读取能力，适合查询最新资料、公开网页内容和临时外部信息。
上下文、记忆和安全：让 Agent 更稳定地长期运行
控制 Agent 访问权限
通过平台统一的 RBAC 权限体系，控制 Agent 的可见范围、数据访问和服务函数调用权限。
运行入口、程序调用和高级扩展
从建模到分析看懂内置 Agent
按任务选择内置 Agent，并理解它们如何组合 DeepAgent、Skill、文件空间、权限、隐私保护和 AI 开发助手等平台能力。
使用 AI 开发助手开发 JitAI 元素
在 IDE 中用自然语言创建、修改和修复 JitAI 元素，并通过差异预览、应用变更、构建和刷新完成开发闭环。
在聊天页面中使用 Agent
了解如何通过 URL 访问 Agent 聊天页面，直接进入指定 Agent 或选择 Agent 开始对话。
AI 技能
将可复用的业务经验、工作流程、输出规范和判断规则沉淀为 Skill，让多个 AI Agent 能够共享同一套专业能力。
学习路径
沉淀可复用的领域能力
理解 Skill 的定位：把业务流程、输出规范、判断规则和示例模板沉淀为可复用能力，供多个 Agent 安装使用。
创建标准 Skill
在 IDE 的 Skills 入口创建标准 Skill，用名称和描述说明能力边界，并进入编辑器维护 Skill 内容。
为 Agent 安装 Skill
把创建好的 Skill 安装到 Agent 中，根据任务范围选择智能模式、自定义模式或禁用模式。
场景实践
开发问数 Skill
以数据查询场景为例，学习如何围绕数据模型设计问数 Skill、组织查询模板和字段说明。
AI 文件空间
为 Agent 准备可读写的文件环境。创建 Agent 空间、个人空间和组织空间，管理团队共享资料，并规划稳定的路径、隔离和清理规则。
让 Agent 有地方保存、读取和交付文件
理解 AI 文件空间的定位，区分 Agent 空间、个人空间和组织空间，并判断什么时候需要先创建文件空间。
为 Agent 准备专属工作空间
创建 Agent 空间，用于保存某个 Agent 的工作文件、临时结果和生成内容，并按需要开启用户隔离。
为每个用户准备私有文件空间
创建个人空间，让每个用户拥有跨 Agent、跨会话可复用的私有文件区域。
管理组织空间中的共享文件
在管理区门户中使用组织文件空间管理页面上传、查看、删除和整理团队共享资料，需要用户拥有管理门户权限。
在 Agent 中配置可访问的文件空间
在 Agent 中选择可访问的 Agent 空间、个人空间和组织空间，并通过提示词约定文件路径。
规划稳定的文件路径、隔离和清理规则
理解文件空间名称、逻辑路径、根目录、隔离规则和清理策略，避免 Agent 读写到错误位置。
AI 语音识别
把用户录音转成 Agent 可处理的文本输入。创建语音识别服务，配置 API Key 和默认模型，并在 Agent 的输入输出配置中开启语音输入能力。
把现场语音变成 Agent 能处理的业务指令
理解 AI 语音识别在 Agent 链路中的位置，判断哪些移动端、现场作业和客服场景适合开启语音输入。
创建一个供 Agent 使用的语音识别服务
在 IDE 中创建硅基流动语音识别服务，配置 API Key 和默认识别模型，并用名称说明服务边界。
为 Agent 开启语音输入能力
在 Agent 的输入输出配置中选择语音识别服务，让聊天入口支持录音、转写和语音输入。
数据建模
为你的应用设计强大的数据基础。无需复杂的 SQL 知识，通过可视化方式创建数据表，设计字段类型，建立关联关系。让数据管理变得轻松高效。
扩展表模型
基于现有表的数据扩展，通过关联其他数据表实现业务字段扩展和多表数据整合。
事务管理
确保复杂业务操作中的数据一致性和可靠性。掌握数据库事务控制机制，实现原子操作，有效处理并发访问场景。
用户与权限
构建安全可靠的用户体系。支持多种登录方式，灵活设计组织架构，精细化权限分配。让不同用户各司其职，确保数据安全和操作规范。
组织架构
企业组织管理，包括部门、岗位和人员层级关系配置。
登录认证
用户身份验证和登录方式配置，支持多种认证模式，包括第三方 OAuth 和企业集成。
角色与门户菜单权限
应用角色定义和权限分配，实现细粒度的访问控制。
角色与业务元素权限
在角色中统一配置 Agent、数据模型和服务函数权限，控制用户能使用哪些业务能力。
Agent 工具暴露与角色权限边界
说明 Agent 工具暴露不是权限控制，真正的访问控制由角色权限和运行时检查承担。
业务逻辑开发
赋予应用强大的业务处理能力。通过可视化编程处理复杂业务规则，响应用户操作，执行后台任务。让逻辑编写像搭积木一样直观易懂。
创建服务元素
后端业务逻辑实现，通过服务元素封装可复用的业务函数，提供 API 接口和数据处理服务。
在服务函数中调用其它元素
学习如何在服务函数中调用其他元素，包括模型、其他服务、外部 API 和系统组件，实现全面的业务逻辑实现。
审批流程
让企业审批流程变得高效有序。通过拖拽方式设计流程图，配置审批人和条件，自动化处理流转。告别繁琐的纸质审批，拥抱数字化办公。
文件处理
轻松处理应用中的各种文件需求。支持多种格式文件上传下载，动态生成 Word、Excel 文档，让文件操作变得简单便捷。
外部 API 集成
让你的应用连接更广阔的世界。轻松接入第三方 API，集成微信支付、支付宝支付，配置短信通知服务。扩展应用能力边界，满足更多业务场景。
创建通用的外部 API 元素
无缝集成第三方 HTTP 接口，提供统一的 RESTful API 调用管理，支持标准 HTTP 方法和高级处理功能。
缓存管理
让应用跑得更快更稳定。配置智能缓存策略，优化数据访问速度，提升用户体验。确保应用在高并发访问时依然流畅运行。
内部 API 开放
将应用能力暴露给外部系统调用。一键生成标准 API 接口，管理调用权限，监控使用情况。让你的应用成为数据和服务的提供者。
各类元素的 API 暴露示例
全面展示如何将不同类型的元素暴露为 API 的示例，包括数据模型、服务和自定义函数。
国际化
让你的应用面向全球用户。支持多语言、区域设置和动态语言切换，打造真正的国际化应用程序。
前端 UI 定制
打造独特的视觉体验和品牌形象。自定义应用主题色彩，开发专属 UI 组件，让应用界面更符合企业品牌调性，提升用户体验和辨识度。
页面定制
介绍全代码页面的具体开发技术和使用方法，包括样式处理、组件使用、资源管理、数据操作等。
场景化进阶指南
基于真实业务场景的深度实践指南，帮助开发者掌握复杂应用的架构设计和最佳实践。