方天ERP智能体（Agent）开发实战：打造自动化业务引擎

方天ERP智能体插件开发技术白皮书

1. 智能体概述

在方天ERP生态系统中，智能体（插件）是独立于核心业务流程的自动化执行单元。它通过B9ScheduleService调度服务作为“大脑”，定时触发并执行特定的业务逻辑（如数据同步、报表生成、异常预警等），实现业务流程的无人值守自动化。

2. 开发环境与架构

为了确保智能体的稳定运行，请严格遵守以下环境配置：

3. 核心开发规范

开发一个方天智能体，本质上是实现一个符合特定契约的类库。

• 命名规范：为了防止命名冲突并保持系统整洁，建议使用以下命名空间格式：Fangdee.B9.Plugin.[YourCompanyName].[FunctionName]示例：Fangdee.B9.Plugin.MyCo.StockAlert.dll

• 接口契约：你的核心类必须实现 IScheduleService 接口。

  • 关键方法：Run

  • 执行逻辑：调度服务在触发任务时，会将你的DLL加载到服务进程中，并直接调用 Run 方法。

4. 部署与运行机制

智能体的运行依赖于 Windows 服务调度，其生命周期如下：

1. 调度检查：Web服务器上的 B9ScheduleService（调度服务）每 1分钟 检查一次任务列表。

2. 条件匹配：检查“执行计划”菜单中，哪些任务满足当前的执行条件（如时间、频率）。

3. 加载执行：服务加载对应的插件 DLL 文件，注入执行参数，并调用 Run 方法。

4. 结果反馈：执行完毕后，服务继续轮询。

部署路径：编译生成的 .dll 文件必须拷贝至系统的 /bin 目录下，否则调度服务无法加载。

5. 调试与运维指南

开发过程中，调试是关键环节，请注意以下事项：

• 环境隔离：强烈建议搭建独立的测试库和测试程序环境。严禁直接在正式生产环境中进行未经验证的代码调试，以免造成数据污染或业务中断。

• 日志追踪：

  • 路径：/logs/schedule/log.txt

  • 策略：所有的执行日志、错误信息均输出至此文件。这是排查智能体运行故障的第一手资料。

  
  

• 热更新操作（重要）：由于调度服务会长期引用 DLL 文件，直接替换文件通常会报“文件被占用”错误。

  • 正确步骤：

    1. 停止 B9ScheduleService 服务。

    2. 替换 /bin 目录下的旧版 DLL 文件。

    3. 启动 B9ScheduleService 服务。

    
    

  
  

💡 专家提示

• 线程安全：由于调度服务是单线程轮询，如果某个智能体的 Run 方法执行时间过长（超过1分钟），可能会阻塞后续任务的检查，请确保你的业务逻辑高效或采用异步处理。

• 异常捕获：务必在 Run 方法中使用 try-catch 包裹核心代码，防止插件崩溃导致整个调度服务挂起。