自定义Agent开发

支持二次开发吗?——自定义Agent开发FAQ

宝软数字 · FAQ知识库 · 2025-09-19

企业软件领域有一个残酷的现实:预置功能再丰富,也只能覆盖你80%的需求。剩下的20%——那些与你的行业特性、管理习惯、竞争壁垒紧密相关的需求——才是真正决定AI项目价值上限的关键。EIOS从架构第一天就考虑了这一点:我们不只是给你一套开箱即用的Agent,我们给你一座Agent工厂。本文面向技术决策者和开发团队,深度解析EIOS的二次开发能力。

Agent开发框架

问题一:二次开发需要什么技术栈?我们的Java/.NET团队能上手吗?

答:这是一个非常现实的问题——很多企业的IT团队以Java或.NET为主,担心Node.js/TypeScript的技术栈会成为障碍。我们的回答是:取决于你二次开发的深度。

轻度开发(75%的场景)——零代码配置:通过管理后台的Agent配置界面,你可以创建自定义Agent——定义它的角色、知识库范围、可调用的工具、决策规则和输出格式。这不需要任何编程。财务总监可以为自己的部门配一个"应收账款催收Agent",而不用找IT部门排队。

中度开发(20%的场景)——REST API集成:如果你需要把EIOS的Agent能力嵌入到你自己的系统(如OA门户、企业微信工作台、内部APP)中,我们提供完整的REST API和TypeScript/Python SDK。你只需要用你熟悉的任何语言调用HTTP接口即可——Java用OkHttp/.NET用HttpClient/Python用requests。API文档包括OpenAPI 3.0规范文件和Postman Collection。

深度开发(5%的场景)——Agent源码级定制:如果你要开发高度定制化的Agent逻辑(比如涉及复杂的行业算法、特殊的数据处理流程),则需要使用TypeScript。这是因为EIOS的Agent运行时是基于NestJS的,但你不需要理解全部框架——只需要在我们的Agent基类上覆写几个关键方法即可。Java/.NET开发者通常花1-2周就能适应TypeScript的语法,真正的时间成本在理解Agent的设计模式和生态,而非语言本身。

经验数据:在我们服务过的客户中,约75%的二次开发需求通过零代码配置完成,20%通过API调用完成,只有5%需要编写TypeScript代码。大多数企业的"定制化需求"其实不需要定制化开发。

问题二:开发一个自定义Agent需要多长时间?有模板参考吗?

答:取决于复杂度,但比从零开发一个AI应用快得多——因为EIOS提供了全套基础设施(权限、审计、知识库、模型路由、日志),你只需要关注业务逻辑。

模板Agent(30分钟到半天):从我们的20+预置模板中选择一个最接近的,修改知识库范围、调整提示词、配置输出格式,然后发布。比如从"通用合同审查Agent"模板派生出一个"建设工程合同审查Agent",主要改动是上传建筑行业的法规和合同范本作为知识库。

标准Agent(1到3天):创建一个全新领域的Agent,包括定义角色和知识域、配置数据源连接器、编写业务规则、设计输出模板、测试和调优。比如"供应商风险评估Agent"——需要对接ERP的供应商档案和采购记录,定义风险评分规则(注册资金、诉讼记录、交货准时率等权重)。

复杂Agent(1到2周):涉及多Agent协作、复杂业务规则引擎、自定义算法或外部系统深度集成的Agent。比如"智能排产Agent"——需要同时考虑订单优先级、设备产能、模具状态、人员排班、物料齐套等多个维度,并在多个约束条件下做最优化求解。

我们对每种复杂度级别都提供了完整的开发脚手架:模板代码、单元测试框架、本地调试环境、CI/CD流水线配置。你不需要从空白文件开始。

Agent开发时间和复杂度

问题三:自定义Agent怎么接入我们的内部数据和API?

答:这是自定义Agent最核心的能力——不是独立运行,而是和你现有的系统深度绑定。EIOS提供了三个层级的数据接入能力:

第一层——标准连接器:如果你用的是主流系统(ERP、CRM、OA、数据库),直接从连接器市场勾选即可。连接器会自动处理认证(OAuth 2.0、API Key、数据库账号)、数据模型映射、字段权限控制。

第二层——自定义连接器:如果你用的是自研系统或小众软件,可以通过自定义连接器SDK开发接入。SDK提供了一套标准接口(4个核心方法:连接测试、数据读取、数据写入、元数据获取),你只需要实现这4个方法,剩下的权限、日志、错误处理由框架搞定。一个简单的REST API连接器通常200行代码以内

第三层——Webhook和事件驱动:对于需要实时响应的场景(如ERP创建了一张新订单后自动触发AI审核),你可以注册Webhook或订阅消息队列事件。Agent会作为事件的消费者,接收到业务事件后自动执行预定义的逻辑。

重点强调:自定义Agent在接入数据时必须遵循EIOS的权限体系——你可以在Agent配置中定义"这个Agent可以访问哪些数据表/API的哪些字段"。即使Agent由开发者编写,它也无法绕过权限设置去读取不该读的数据。

问题四:我们自己开发的Agent能和预置Agent协同工作吗?

答:能,而且这是EIOS Agent体系的核心设计思想——Agent社会。你不只是在开发孤立的Agent,而是向一个已有的Agent协作网络中增加新成员。

多Agent协同通过事件总线和任务编排实现:

· 任务委派:一个Agent在完成任务时,可以将子任务委派给另一个Agent。比如"经营分析Agent"在生成月度报告时,发现报告中需要包含应收账款风险分析,它可以自动将这部分工作委派给"财务风控Agent",然后将结果合并到最终报告中。这个委派过程不需要你做任何特别配置——只要两个Agent都正确注册了自己的能力描述。

· 事件触发:一个Agent的处理结果可以作为事件触发另一个Agent的行为。比如"合同审查Agent"发现某份合同包含高风险条款后,自动发布一个事件,"任务管理Agent"监听到后自动创建一个待办任务分配给法务部门。

· 上下文共享:Agent之间可以通过共享上下文传递信息,避免重复查询同一份数据。当用户发起一个复杂问题时,主Agent会自动分析需要哪些子Agent参与,并为它们准备各自的上下文切片。

一套典型的200人企业,在运行半年后通常会沉淀出15-30个自定义Agent,它们和预置Agent一起组成了该企业特有的"AI工作流"。这些Agent是企业真正无法被复制的数字化资产。

多Agent协同架构

问题五:开发完了怎么测试?有没有沙盒环境?

答:有,而且我们把它做成了与生产环境一对一的镜像,确保"沙盒里跑得通的,生产环境一定没问题"。

每个租户都配有一个独立的沙盒环境,它的数据是完全隔离的(可以灌入脱敏的生产数据副本),但基础设施配置(服务器规格、数据库版本、中间件版本)与生产环境完全一致。你在沙盒中创建和配置Agent后,需要通过三个关卡才能发布到生产:

· 单元测试关卡:对Agent的每个工具函数做输入输出验证。我们提供了测试框架模板,你只需要编写测试用例。

· 集成测试关卡:在沙盒中用真实(脱敏)数据跑一遍完整流程。比如让"采购审批Agent"处理100份历史采购单,看它的审批建议和历史实际决策的吻合度。

· 人工评审关卡(关键Agent必需):由业务专家对AI的输出做抽样评审。如果评审通过率低于预设阈值(默认为90%),Agent不能发布。

此外,我们提供了A/B测试能力:你可以让同一Agent的两个版本分别服务5%的流量,对比它们的准确率、响应速度和用户满意度,数据驱动地选择最优版本。

问题六:我们开发的自定义Agent,知识产权归谁?

答:归你。这一点我们在合同中明确约定:你在EIOS平台上创建的自定义Agent(包括Agent的配置、提示词、业务规则、知识库内容),其知识产权100%归属于你。EIOS提供的是"工厂"和"工具",你生产出来的"产品"是你的资产。

具体来说:

· 你编写的Agent代码(TypeScript源码)归你所有。你可以自由地阅读、修改、备份。

· 你配置的Agent规则和知识库内容归你所有。如果你未来决定迁移到其他平台,可以导出这些配置(标准JSON格式)。

· 你上传的业务数据和文档始终归你所有。合同终止后,我们会在30天内彻底删除你的所有数据。

· 你基于EIOS的Agent基类和框架开发的Agent,可以打包成独立应用部署在其他环境中——不锁定在EIOS平台。

当然,EIOS平台本身(包括Agent基类、连接器框架、权限系统、审计模块等基础能力)的知识产权归宝软数字所有。这类似于你用Word写了一本书,书的知识产权归你,Word软件的产权归微软。这个边界非常清晰。

知识产权归属清晰

问题七:二次开发后会影响平台升级吗?会不会一升级我们的定制就失效了?

答:不会。这是我们在设计Agent框架时花了最多心力的工程问题之一——保证向后兼容

我们的承诺是:

· 公开API向后兼容至少两个大版本(约12-18个月)。如果你的Agent用了某个公开API,在它的弃用期内(通常6-12个月)它会继续正常工作,我们会提前通知你并给出迁移指南。

· Agent基类的扩展点是"增加"而非"修改"。基类的新版本只会增加新的可选方法和属性,不会改变已有方法的签名和行为。你的自定义Agent子类无需任何改动即可在新版本上运行。

· 版本锁定:你可以选择不跟随最新版本升级。EIOS支持你在指定版本上运行自定义Agent,你只需要在你想升级的时候升级。我们不会强制推送升级——当然,安全补丁除外,这些会强制推送。

· 自动化兼容性检测:每次平台版本发布前,我们会在CI流水线中自动跑一遍所有公开API的回归测试。如果有任何破坏性变更,构建会自动失败,不会发布。

对于中度开发(API调用),你基本上不受平台升级影响——REST API的版本策略和上述一致。对于深度开发(源码级定制),建议你把自定义Agent代码放在独立的Git仓库中,升级时只需重新安装依赖并跑一遍测试即可。

向后兼容与版本策略

问题八:我们需要一些很特殊的功能,你们能做定制开发吗?

答:可以,但我们建议优先考虑"你自己开发"而非"我们帮你开发"。这听起来反直觉——毕竟客户通常希望供应商提供"全包"服务。但我们认为:

只有你的团队才真正懂你的业务。我们帮你开发一个"供应商质量评估Agent",我们可能需要花2周去理解你的供应商分级标准、质检流程、行业特殊要求——而这些知识本来就存在于你的采购经理和质检主管的脑子里。你的团队用EIOS的Agent框架,可能3天就能搭出来。

当然,我们理解有些企业暂时没有足够的研发资源或不愿意在内部培养Agent开发能力。对于这些情况,我们提供两种合作模式

· 宝软专业服务:由我们的解决方案架构师团队为你做定制开发。以"供应商质量评估Agent"为例,报价通常在3-5万(根据复杂度),交付周期2-4周,包含完整的文档和知识转移。这个价格包括了需求调研、开发、测试、培训和3个月的支持。

· 合作伙伴生态:我们还连接了多家在特定行业有深厚经验的技术服务商。如果你需要的是一个深度结合行业Know-how的复杂解决方案(比如医疗器械行业的GMP合规Agent或建筑行业的工程造价Agent),通过合作伙伴可能比我们直接开发更合适——他们带着行业经验来,不需要从零理解你的语境。

定制开发合作模式

想动手试试Agent开发?

免费试用包含完整开发环境和沙盒,动手搭建你的第一个自定义Agent

🔧 开始试用