二次开发指南

原则： 能配置解决的，不写代码；能通过业务 API 解决的，不直接依赖业务模块源码。

企业管理智能体提供从配置到代码开发的分层扩展能力，客户可以根据技术团队和业务复杂度选择合适方式。

三种扩展方式

配置扩展

配置模型、知识库、提示词、智能体、技能和人员授权，无需修改业务代码。

低代码扩展

创建连接器、导入接口能力、配置参数映射和确认策略，将已有业务接口快速开放给智能体。

代码扩展

开发专属执行器、复杂技能、系统连接器或新的多模态处理能力，满足行业和客户个性化需求。

扩展对象怎么选

需求	推荐扩展对象
调整说话方式、补问规则和场景说明	技能提示词与配置
增加一个专业工作角色	智能体
把现有 REST API 开放给智能体	能力注册
接入一套新业务系统	连接器
处理复杂事务、幂等和回滚	业务系统领域接口
增加 OCR、语音或专用模型	模型适配器

技术栈

范围	技术栈
独立前端	Vue 3、TypeScript、Vite、Pinia、Ant Design Vue
后端服务	Java 17、Spring Boot、Spring Security、MyBatis-Plus
智能编排	智能体、技能、能力注册表、人在回路确认、上下文持久化
系统集成	REST API、OAuth2 / SSO、连接器、Webhook 与文件服务
数据与模型	独立业务库、Redis、通用大模型、OCR、语音与知识检索

架构约束

• AgentOS 保持独立部署和独立数据库。
• 不直接依赖 OA、HRM、Finance 等业务模块源码。
• 写入主线业务数据必须通过业务系统 API。
• 所有能力必须定义风险等级、权限和确认策略。
• 关键金额、状态、权限与事务由确定性代码处理。

推荐开发流程

1. 明确用户目标、成功结果和不允许发生的事情。
2. 先确认业务系统是否已有稳定接口。
3. 定义只读或写入能力、风险等级、权限和返回结构。
4. 编写技能补问、确认和失败说明。
5. 配置智能体与角色授权。
6. 使用普通员工和管理员进行正反向验证。
7. 为关键场景建立自动验证和 Evidence Bundle。

开始阅读

• 技术架构
• 能力开发
• 技能与智能体开发
• 第三方系统对接

详细内容请参阅扩展开发指南。