第三十八章 外部对象与设备控制接口
-
外部设备及软件执行对象的接入
-
设备属性与控制参数映射
-
执行指令的数据格式设计
-
控制接口与执行程序调用
-
外部执行结果的获取与处理
第三十八章 外部对象与设备控制接口
个体自主运行并不意味着个体只在自身软件运行环境内部完成全部处理。对于软件个体,其行为可能作用于数据库、业务系统、文件系统、应用程序和其他软件执行对象;对于机器人、无人机和工业自动化设备,其行为则需要通过本地控制器、通信接口、设备驱动程序和执行机构作用于真实物理对象。无论行为最终作用于软件对象还是实体设备,个体都需要建立从内部行为指令到外部执行对象之间的工程连接机制。
第三十七章已经建立了行为对象、行为指令、行为流程和执行结果反馈机制,解决了个体如何组织自身行为的问题。本章进一步研究行为如何通过控制接口作用于外部对象,解决个体内部方法与外部设备、软件程序之间的连接问题。其核心不是简单地建立一个设备连接程序,而是建立一套能够将知识结构中的对象定义、属性定义、方法定义与外部真实对象的属性、控制参数、接口操作和执行反馈对应起来的映射机制。
在WSaiOS工程架构中,智能控制后台负责根据需求构建知识结构和知识能力,并完成能力验证及个体赋值。个体获得相应的知识能力、方法和执行规则后,通过自身运行环境与外部设备或软件执行对象建立连接。外部接口是个体自主运行的执行边界,不是另一个独立的智能控制核心。个体不需要将后台全部结构智能逻辑复制到设备控制器中,而是通过本地运行引擎调用已经赋予的方法,并由对应的接口适配程序完成外部操作。
因此,本章需要建立三个相互关联但职责不同的工程层次。知识结构层描述外部对象及其属性、关系和方法;个体运行层根据任务、决策和行为指令形成具体操作;设备接口层将内部操作转换为外部系统能够识别的指令,并将外部返回的信息重新转换为个体运行环境能够处理的结构化数据。
这种设计既适用于机器人、无人机、工业设备等实体执行对象,也适用于数据库、业务软件、文件处理程序和其他软件系统。通过统一的对象接入、参数映射、指令组织和结果反馈机制,可以使不同类型的外部对象进入同一个个体自主运行体系,同时保留不同设备和软件系统自身的接口差异。
第一节 外部设备及软件执行对象的接入
外部对象接入是建立个体与实际执行环境之间联系的基础。个体在内部形成行为指令之后,需要明确指令最终作用于哪个外部对象、该对象通过什么接口访问、接口由哪个程序负责调用,以及外部对象返回的信息如何进入个体运行环境。
这里所说的外部对象,既包括具有物理形态的设备,也包括运行在计算机环境中的软件执行对象。实体设备可以是机器人、无人机、机械臂、工业控制器、传感器、执行机构、输送设备和其他自动化装置。软件执行对象可以是数据库实例、文件处理程序、业务系统接口、应用程序、独立进程以及其他能够接受输入并产生处理结果的软件组件。
虽然这些对象的实际运行方式不同,但从WSaiOS个体运行环境来看,它们都具有可以识别的对象身份、属性信息、运行状态和可调用操作。因此,可以在个体内部建立统一的外部对象描述机制,将不同外部对象转换为具有明确结构定义和接口关系的运行对象。
需要特别区分外部对象的结构定义与实际接入对象。结构定义描述某一类外部对象具有哪些属性、状态和可用方法,例如机器人具有位置、速度、电量、运行状态和运动控制方法。实际接入对象则是具体的机器人实例,例如
robot_device_001。结构定义可以被多个设备实例引用,但每个设备实例都需要具有独立身份、连接信息、运行状态和接口配置。这种区分与WSaiOS结构智能中的对象、属性和方法定义相一致。结构定义并不等于设备本身,设备实例也不能代替知识结构定义。个体需要根据已经赋值的结构知识识别外部设备,并通过设备实例与对应接口建立实际连接。
外部对象接入首先需要建立对象身份。建议为每个实际接入对象分配稳定的
external_object_id,用于关联对象定义、设备连接配置、接口映射和运行记录。该标识不应直接使用设备IP地址、数据库连接地址或者软件文件路径,因为这些信息可能发生变化,而对象身份需要在设备迁移、网络调整和接口升级之后仍然保持稳定。外部对象描述可以采用如下拟定JSON结构:
{ "external_object_id": "robot_device_001", "object_name": "仓库搬运机器人001", "object_type": "warehouse_robot", "object_category": "physical_device", "structure_id": "robot_structure_001", "interface_id": "robot_control_interface_001", "connection_profile_id": "robot_connection_001", "runtime_owner": "individual_001", "device_status": "disconnected", "interface_status": "registered", "object_version": "1.0.0" }这里的
external_object_id是外部对象实例的唯一标识,structure_id关联已经建立的机器人结构定义,interface_id关联控制接口定义,connection_profile_id关联实际连接参数。runtime_owner用于说明该对象由哪个个体运行环境管理。设备尚未建立连接时,可以处于disconnected状态,但这并不代表对象定义不存在或者接口配置无效。外部对象的连接方式需要根据对象类型选择。对于本地软件执行对象,可以通过类实例、函数调用、独立进程、命令行程序或本地服务接口进行连接。对于网络软件系统,可以通过HTTP接口、消息队列、数据库驱动或者其他正式接口进行访问。对于机器人和工业设备,可以通过设备驱动程序、串行接口、以太网接口、工业通信协议、设备控制器或专用SDK建立连接。
不同连接方式应当由独立的接入适配程序处理,而不应让行为执行程序直接依赖某一种具体协议。例如,机器人导航方法不应直接在业务行为代码中编写所有网络通信细节,而应调用统一的设备控制接口,由接口适配程序根据设备类型选择相应的通信协议和驱动实现。
拟定的外部对象接入程序目录如下:
IndividualRuntime/ ├── external/ │ ├── object/ │ │ ├── ExternalObjectReader.php # 读取外部对象定义和实例信息 │ │ ├── ExternalObjectRegistry.php # 管理已接入外部对象的登记信息 │ │ ├── ExternalObjectResolver.php # 根据任务和结构标识解析目标对象 │ │ └── ExternalObjectValidator.php # 检查外部对象定义及实例完整性 │ ├── connection/ │ │ ├── ConnectionProfileReader.php # 读取外部对象连接配置 │ │ ├── ConnectionManager.php # 管理连接建立、保持和释放 │ │ ├── ConnectionHealthChecker.php # 检查连接状态和可用性 │ │ └── ConnectionRecoveryManager.php # 处理连接异常和恢复 │ ├── adapter/ │ │ ├── ExternalAdapterInterface.php # 定义外部对象适配接口 │ │ ├── SoftwareObjectAdapter.php # 接入软件执行对象 │ │ ├── DeviceObjectAdapter.php # 接入实体设备 │ │ ├── NetworkObjectAdapter.php # 接入网络服务对象 │ │ └── AdapterResolver.php # 根据对象类型选择适配程序 │ └── registry/ │ ├── ExternalInterfaceRegistry.php # 管理外部接口定义 │ └── ExternalObjectBinding.php # 建立外部对象与个体的关联在这一架构中,
ExternalObjectRegistry负责管理已经建立的外部对象实例,ConnectionManager负责实际连接过程,AdapterResolver负责根据对象类型找到对应适配程序。行为执行程序不需要知道设备采用串口、以太网还是某一种工业协议,只需要按照已经定义的接口调用对应的适配程序。外部对象接入还需要建立连接配置与对象定义之间的分离关系。连接配置保存外部对象实际访问所需的信息,例如通信地址、端口、设备通道、接口类型、认证方式和连接超时参数。对象定义保存对象本身的结构、属性和方法信息。两者分离可以避免因连接地址发生变化而修改知识结构,也能够使同一个对象结构适配不同厂商和不同型号的设备。
例如,两个不同型号的机器人可能都具有移动、定位和抓取能力,但其底层控制协议、通信端口和指令格式不同。个体可以使用相同的机器人结构定义和行为组织机制,通过不同的接口适配程序完成实际控制。设备差异被限制在接入和适配层,而不必改变上层任务决策和行为组织逻辑。
外部对象接入需要经过身份确认、结构关联、连接配置读取、接口适配选择、连接建立和连接验证。对于实体设备,还需要确认设备身份和实际物理对象之间的对应关系,防止控制指令发送到错误设备。对于软件对象,则需要确认接口地址、服务身份、数据权限和操作范围。
特别是涉及工业控制、机器人和无人机时,接入成功不能直接等同于允许执行。设备连接成功只表示通信路径已经建立,不能证明设备处于安全运行状态,也不能证明当前个体获得了相应控制权限。进入实际执行阶段之前,还需要结合设备状态、个体赋值、方法适用范围和安全规则进行检查。
因此,外部对象接入机制最终需要形成一个稳定的对象实例、结构定义、连接配置和接口适配之间的关联关系,使个体运行引擎能够准确识别外部执行对象,并在运行过程中持续检查其连接状态和实际可用性。
第二节 设备属性与控制参数映射
外部对象接入之后,个体还需要解决内部知识结构与外部设备实际数据之间的对应问题。WSaiOS中的对象属性是根据知识结构定义建立的,而设备自身的数据字段可能来自厂商协议、控制器寄存器、传感器数据、软件接口参数或者数据库字段。不同设备即使具有相同的实际属性,其名称、类型、单位、数据格式和表达方式也可能完全不同。
例如,机器人在WSaiOS知识结构中可能具有
position、speed、battery_level和operation_status等属性,而某个设备接口返回的数据可能采用pos_x、pos_y、linear_velocity、battery_voltage和state_code等字段。个体不能直接假定外部字段名称与内部属性名称一致,需要通过属性映射机制建立两者之间的对应关系。属性映射的基本目标,是将外部对象的实际数据转换为WSaiOS结构定义中的属性值,同时将内部控制参数按照外部设备的接口要求转换为设备能够识别的数据格式。前者属于外部数据输入映射,后者属于控制参数输出映射。
这两个方向虽然都涉及字段对应,但处理过程并不相同。输入映射需要处理外部数据读取、字段提取、数据类型转换、单位转换、有效性检查和属性更新;输出映射则需要处理方法参数解析、参数名称转换、单位换算、数据范围检查和设备指令参数生成。
因此,属性映射不能只保存一个内部字段名称和一个外部字段名称,还应当记录数据类型、单位、取值范围、映射方向、转换规则、适用设备和版本信息。
拟定的设备属性映射数据如下:
{ "mapping_id": "robot_attribute_mapping_001", "external_object_id": "robot_device_001", "structure_id": "robot_structure_001", "mapping_version": "1.0.0", "attributes": [ { "internal_attribute": "position_x", "external_attribute": "pos_x", "direction": "input", "data_type": "number", "internal_unit": "meter", "external_unit": "millimeter", "conversion": "external_value / 1000" }, { "internal_attribute": "position_y", "external_attribute": "pos_y", "direction": "input", "data_type": "number", "internal_unit": "meter", "external_unit": "millimeter", "conversion": "external_value / 1000" }, { "internal_attribute": "speed", "external_attribute": "linear_velocity", "direction": "input", "data_type": "number", "internal_unit": "meter_per_second", "external_unit": "meter_per_second" }, { "internal_attribute": "battery_level", "external_attribute": "battery_percent", "direction": "input", "data_type": "number", "internal_unit": "percent", "external_unit": "percent" } ] }以上仅为属性映射结构示例。实际映射规则不能通过字段名称相似性自动确定,必须依据设备接口文档、设备实际数据和知识结构定义确认。特别是单位、数据范围和状态编码,不能仅凭字段名称推测。
对于设备状态,映射程序还需要处理外部状态编码与内部状态定义之间的关系。例如,设备可能返回整数
0、1、2和3,分别表示待机、运行、暂停和故障。个体内部则可能使用ready、running、suspended和error等状态定义。映射程序需要建立明确的状态值对应关系,并且对未知状态码保留原始数据,不能随意转换成某个已知状态。控制参数映射则需要反向处理。例如,内部导航方法的参数为目标位置
target_position,而设备接口要求使用goal_x、goal_y和goal_theta。映射程序需要根据方法参数定义和设备接口规范完成字段转换,并检查坐标系、角度单位和参数范围。拟定的控制参数映射如下:
{ "mapping_id": "robot_control_parameter_001", "external_object_id": "robot_device_001", "method_id": "robot_navigation", "parameter_mapping": [ { "internal_parameter": "target_x", "external_parameter": "goal_x", "data_type": "number", "unit_mapping": { "from": "meter", "to": "millimeter", "factor": 1000 } }, { "internal_parameter": "target_y", "external_parameter": "goal_y", "data_type": "number", "unit_mapping": { "from": "meter", "to": "millimeter", "factor": 1000 } }, { "internal_parameter": "target_angle", "external_parameter": "goal_theta", "data_type": "number", "unit_mapping": { "from": "degree", "to": "radian" } } ], "validation": { "coordinate_system_required": true, "parameter_range_check": true, "assignment_scope_check": true } }对于不同设备,属性映射和控制参数映射可能存在一对一、一对多和多对一关系。一个内部属性可能需要从多个传感器字段组合得到,例如设备当前位置可能需要结合位置坐标和坐标系标识才能形成有效数据;一个内部控制参数也可能需要转换为多个设备字段,例如运动目标可能需要同时生成位置、速度和运动模式参数。
这种情况下,映射程序不能只进行简单字段复制,而需要调用专门的数据转换方法。转换方法本身应当具有明确的输入、输出和适用条件,并且纳入个体已经赋予的方法或受控接口适配程序中。对于涉及实际控制的转换,必须保证转换结果符合设备技术规范。
属性映射还需要处理数据时间和数据有效性。设备传感器可能返回上一周期的数据,网络接口可能返回缓存数据,业务软件也可能返回延迟更新的记录。即使数据类型正确,如果数据已经过期,也不能直接用于当前控制决策。属性映射程序应当同时保存数据来源、采集时间、接收时间、数据版本和有效状态。
例如,机器人当前坐标在五秒前获取,而机器人已经持续移动。此时坐标值虽然在数据结构上有效,但不一定能够代表当前真实位置。对于要求高精度定位的控制行为,应当重新获取位置数据,而不是直接使用过期值。
为了实现属性映射的独立管理,建议建立以下程序目录:
IndividualRuntime/ ├── external/ │ ├── mapping/ │ │ ├── mapping_definition/ │ │ │ ├── AttributeMappingReader.php # 读取属性映射定义 │ │ │ ├── ParameterMappingReader.php # 读取控制参数映射定义 │ │ │ └── MappingVersionResolver.php # 确定映射定义版本 │ │ ├── input/ │ │ │ ├── ExternalDataParser.php # 解析外部设备原始数据 │ │ │ ├── AttributeValueConverter.php # 转换外部属性值 │ │ │ ├── AttributeUnitConverter.php # 处理属性单位转换 │ │ │ └── AttributeValueValidator.php # 验证属性值和数据范围 │ │ ├── output/ │ │ │ ├── ControlParameterResolver.php # 解析内部控制参数 │ │ │ ├── ControlParameterConverter.php # 转换控制参数及数据单位 │ │ │ └── ControlParameterValidator.php # 检查输出参数合法性 │ │ └── state/ │ │ ├── DeviceStateMapper.php # 映射设备状态编码 │ │ └── ObjectAttributeUpdater.php # 更新外部对象的结构化属性其中,
AttributeMappingReader和ParameterMappingReader负责读取不同方向的映射定义;输入处理程序负责将外部数据转换为内部属性值;输出处理程序负责将内部参数转换为设备接口参数;状态映射程序负责处理设备状态编码。在数据组织上,还应当区分属性定义、属性映射和属性实例值。属性定义属于知识结构,描述属性的含义、类型、约束和关系;属性映射描述内部属性与外部字段之间的转换关系;属性实例值则是某一个具体设备在某一时刻的实际数据。三者不能混存在同一份配置中。
例如,
position_x是知识结构中的属性定义,position_x对应外部pos_x是映射定义,而机器人当前横坐标为12.5则是实际属性值。设备位置发生变化时,只需要更新属性实例值,不需要修改属性定义和映射定义。这种分离能够使同一知识结构适配不同设备,也能够使设备更换控制器或通信协议时,只调整对应的映射和接口适配配置,而不影响上层知识能力和行为定义。
第三节 执行指令的数据格式设计
外部设备和软件执行对象接入之后,个体需要将内部形成的行为指令转换为外部对象能够接收的执行指令。由于不同设备和软件系统的接口形式差异较大,不能要求所有外部对象使用同一种底层通信协议,但可以在WSaiOS个体运行环境内部建立统一的执行指令数据结构,再由接口适配程序完成外部协议转换。
这一设计需要明确内部执行指令和外部设备指令之间的关系。内部执行指令是WSaiOS运行环境中的标准数据对象,包含任务、个体、行为、方法、目标对象、参数、执行条件和约束信息。外部设备指令则是根据实际接口要求生成的数据,例如某种机器人协议中的导航指令、工业控制器中的寄存器写入请求,或者软件系统的API请求。
两者之间不能直接等同。内部指令具有WSaiOS工程体系中的任务和方法语义,外部指令则具有具体设备或软件接口的技术格式。通过指令转换程序,可以使上层行为组织不依赖外部协议的具体实现。
统一执行指令需要具有稳定标识,以便在指令生成、传输、接收、执行和反馈过程中保持关联。建议至少包含指令标识、任务标识、个体标识、行为实例标识、方法实例标识、外部对象标识、操作类型、参数、执行约束、版本和指令状态。
拟定的内部标准执行指令如下:
{ "command_id": "external_command_000128", "task_id": "task_000128", "individual_id": "robot_001", "behavior_instance_id": "behavior_instance_000128", "method_instance_id": "method_instance_001", "external_object_id": "robot_device_001", "command_type": "navigation", "operation": "move_to", "parameters": { "target_x": 12.5, "target_y": 8.2, "target_angle": 90 }, "execution_context": { "assignment_version": "assignment_001", "method_version": "1.0.0", "mapping_version": "1.0.0" }, "constraints": { "operation_scope": "assigned_area", "safety_check_required": true, "timeout_seconds": 30 }, "idempotency_key": "robot_001_task_000128_step_001", "command_status": "prepared" }该指令是个体内部标准格式,不代表外部机器人能够直接接收。真正发送之前,还需要检查指令是否属于当前个体、目标设备是否正确、参数是否符合设备要求,以及方法和映射版本是否匹配。
指令转换程序根据
external_object_id读取设备接口定义,根据method_id读取方法映射,再根据参数映射规则生成设备协议所需要的字段。对于软件执行对象,可能需要将内部参数转换为HTTP请求体、数据库操作参数或进程启动参数;对于工业设备,则可能需要转换为对应的寄存器地址、控制码或设备专用消息格式。例如,内部导航指令可以被转换为某种机器人控制接口所要求的数据:
{ "device_message_id": "device_message_000128", "operation_code": "NAVIGATE", "device_target": { "goal_x": 12500, "goal_y": 8200, "goal_theta": 1.5708 }, "execution_options": { "speed_limit": 0.8, "collision_check": true } }这里的坐标和角度转换仅用于说明数据转换关系,具体数值和单位必须依据实际设备接口规范确定。尤其是坐标系、角度方向、原点位置、速度单位和运动范围,必须在设备接入时完成确认,不能依赖通用假设。
统一指令还需要支持不同操作类型。查询类指令用于读取设备属性和运行状态;控制类指令用于改变设备状态或驱动执行机构;配置类指令用于修改允许调整的设备参数;停止类指令用于要求设备进入规定的停止过程;复位类指令则需要根据设备定义和安全规则单独管理。不同操作类型应当具有不同的权限和执行约束,不能统一采用相同的调用规则。
对于设备控制,停止指令尤其需要明确其实际含义。软件层面发送停止请求,只能证明停止请求已经发出,不能证明设备已经停止。设备可能需要一定时间完成减速,也可能因控制器异常而没有响应。因此,停止操作同样需要接收设备反馈,并通过实际状态验证确认停止结果。
执行指令还需要具有超时、取消和幂等控制机制。超时表示在规定时间内没有获得预期响应,不等于设备没有执行;取消表示个体不再希望继续当前操作,也不等于设备动作已经撤销。对于已经产生物理动作的设备指令,取消后还需要根据设备实际状态确定后续处理方式。
幂等标识用于识别重复请求。同一执行步骤因为通信异常被重复提交时,外部适配程序应当优先查询原指令的执行状态,避免对非幂等操作重复执行。对于设备本身不支持幂等控制的情况,需要在个体运行环境中通过本地执行记录和设备状态核实实现重复请求保护。
在工程实现上,建议将标准指令定义、设备协议转换和指令发送分离管理:
IndividualRuntime/ ├── external/ │ ├── command/ │ │ ├── definition/ │ │ │ ├── CommandDefinitionReader.php # 读取内部指令定义 │ │ │ ├── CommandBuilder.php # 建立标准执行指令 │ │ │ └── CommandValidator.php # 验证标准执行指令 │ │ ├── conversion/ │ │ │ ├── CommandProtocolResolver.php # 确定目标设备协议 │ │ │ ├── CommandProtocolConverter.php # 转换内部指令与外部协议 │ │ │ └── CommandPayloadBuilder.php # 组织外部设备指令数据 │ │ ├── dispatch/ │ │ │ ├── ExternalCommandDispatcher.php # 发送外部执行指令 │ │ │ ├── CommandDeliveryManager.php # 管理指令发送状态 │ │ │ └── CommandIdempotencyManager.php # 管理指令重复提交 │ │ └── control/ │ │ ├── CommandTimeoutManager.php # 管理指令响应超时 │ │ ├── CommandCancellationManager.php # 管理指令取消过程 │ │ └── CommandSafetyGate.php # 执行发送前的安全检查内部指令格式的统一,使个体运行引擎不必针对每种设备重复编写完整的行为执行逻辑。设备差异由协议转换和适配程序处理,上层行为仍然按照统一的任务、行为、方法和对象关系组织。
但是,统一数据格式并不意味着所有设备必须采用完全相同的执行语义。不同设备可能具有不同的动作生命周期、参数约束、响应方式和安全机制。因此,内部标准指令还需要保留设备类型、接口类型、方法类型和执行规则等信息,允许适配程序根据实际对象进行专门处理。
对于软件执行对象,统一指令也可以形成相同的工程入口。例如,个体需要调用一个业务系统中的数据处理方法时,可以将内部方法参数转换为该系统API所要求的请求数据;调用本地文件处理程序时,可以将参数转换为程序入口需要的输入结构;执行数据库操作时,则由对应的数据库适配程序根据操作定义执行。无论外部对象是软件还是设备,均需要保留调用标识、输入数据、执行状态和结果反馈。
第四节 控制接口与执行程序调用
执行指令完成标准化之后,还需要通过控制接口进入实际执行程序。控制接口是WSaiOS个体运行环境与外部对象之间的程序边界,它负责接收已经验证的内部操作请求,将其转换为外部对象能够执行的调用,并将外部返回结果重新交给个体运行引擎。
控制接口不能与具体业务行为程序混为一体。行为程序负责组织当前任务需要完成的行为步骤,方法程序负责实现具体操作,接口适配程序负责与外部对象进行技术层面的交互。三者应当保持相对独立。
例如,机器人执行导航行为时,行为程序只需要知道当前需要调用
robot_navigation方法,并提供已经验证的目标位置和执行上下文。方法实现程序根据方法定义调用对应的控制接口,控制接口再根据机器人设备型号选择具体的通信适配程序,完成导航指令转换和发送。设备返回的执行状态由适配程序解析后,沿原调用链返回方法执行程序和行为执行管理程序。这一过程可以表示为:
BehaviorExecutionManager | v MethodCallExecutor | v MethodImplementation | v ExternalControlGateway | v ExternalObjectResolver | v ProtocolAdapter | v DeviceDriver / SoftwareConnector | v External Device / Software Object | v External Result Adapter | v Method Result | v BehaviorResultCollector其中,
ExternalControlGateway是个体内部统一的外部控制入口。它不直接实现所有设备协议,而是根据外部对象标识、接口定义和操作类型选择具体适配程序。ProtocolAdapter负责处理外部协议,DeviceDriver或SoftwareConnector负责执行实际的底层调用。为了使不同类型的外部对象能够被统一调用,可以建立一个基础接口。以下为PHP 7.0.10兼容的拟定程序示例:
<?php interface ExternalAdapterInterface { public function connect($profile); public function execute($command); public function readState($objectId); public function disconnect(); }实体设备适配程序和软件对象适配程序分别实现该接口。对于不同设备,
execute()内部的具体实现可以完全不同,但对上层方法程序保持一致的调用入口。例如,一个软件执行对象适配程序可以采用如下形式:
<?php class SoftwareObjectAdapter implements ExternalAdapterInterface { private $connector; public function __construct($connector) { $this->connector = $connector; } public function connect($profile) { return $this->connector->connect($profile); } public function execute($command) { if (empty($command['operation'])) { throw new InvalidArgumentException( '缺少软件操作标识' ); } return $this->connector->invoke( $command['operation'], isset($command['parameters']) ? $command['parameters'] : array() ); } public function readState($objectId) { return $this->connector->readState($objectId); } public function disconnect() { return $this->connector->disconnect(); } }这个程序通过
connector调用实际软件连接组件。它本身不负责解释业务任务,也不负责决定是否应该执行某项操作,而是根据已经验证的指令调用外部软件对象。实体设备适配程序也可以采用相同的接口,但其内部需要处理设备通信、控制器响应、设备状态和实际执行反馈。以下为简化的程序组织示例:
<?php class DeviceObjectAdapter implements ExternalAdapterInterface { private $driver; public function __construct($driver) { $this->driver = $driver; } public function connect($profile) { return $this->driver->open($profile); } public function execute($command) { if (empty($command['operation_code'])) { throw new InvalidArgumentException( '缺少设备操作代码' ); } return $this->driver->sendCommand( $command['operation_code'], isset($command['parameters']) ? $command['parameters'] : array() ); } public function readState($objectId) { return $this->driver->getDeviceState( $objectId ); } public function disconnect() { return $this->driver->close(); } }这里的
driver是具体设备驱动程序的抽象依赖,实际开发时必须根据设备提供的协议、SDK或控制接口编写相应实现。上述示例不代表已经实现了任何具体机器人或工业设备的驱动程序。在统一接口之上,还需要建立
ExternalControlGateway,负责从当前执行上下文中解析外部对象、检查调用范围、选择适配程序并执行请求。拟定的程序示例如下:
<?php class ExternalControlGateway { private $objectResolver; private $adapterResolver; private $permissionChecker; public function __construct( $objectResolver, $adapterResolver, $permissionChecker ) { $this->objectResolver = $objectResolver; $this->adapterResolver = $adapterResolver; $this->permissionChecker = $permissionChecker; } public function execute($command, $context) { $object = $this->objectResolver->resolve( $command['external_object_id'] ); if (empty($object)) { throw new RuntimeException( '外部执行对象不存在' ); } $allowed = $this->permissionChecker->check( $object, $command, $context ); if (!$allowed) { throw new RuntimeException( '外部对象操作权限检查失败' ); } $adapter = $this->adapterResolver->resolve( $object['object_category'], $object['interface_id'] ); if (empty($adapter)) { throw new RuntimeException( '没有找到对应的外部接口适配程序' ); } return $adapter->execute($command); } }在实际工程中,
ExternalControlGateway还需要执行接口状态检查、方法版本检查、设备状态检查、参数验证和安全规则检查。对于高风险设备控制,还需要在最终发送前再次执行安全检查,不能仅依靠行为指令生成阶段的一次验证。控制接口的程序调用需要建立明确的调用记录。每次外部操作都应当保存调用标识、外部对象标识、方法标识、指令标识、输入参数摘要、接口版本、适配程序版本、调用时间和返回状态。对于需要持续执行的设备动作,还应当记录外部设备任务标识,以便后续查询执行进度和取消状态。
接口调用也需要处理同步与异步两种执行模式。同步调用适合能够在较短时间内返回结果的操作,例如读取设备状态、查询业务数据和执行简单软件方法。异步调用适合需要持续运行的操作,例如机器人导航、无人机飞行、工业设备加工和长时间业务处理。异步调用通常先返回一个外部任务标识,个体随后通过状态查询、事件接收或者回调机制获取执行进展。
不能因为接口返回了任务标识,就将行为标记为完成。任务标识只说明外部对象接受或建立了某个执行请求,实际操作仍然需要后续查询和验证。
因此,控制接口需要支持任务状态读取、执行结果查询和必要的取消操作。对于通信中断后的恢复,还需要根据原有调用标识和外部任务标识核对实际执行情况,防止重新建立一个与原操作重复的外部任务。
拟定的控制接口程序目录如下:
IndividualRuntime/ ├── external/ │ ├── gateway/ │ │ ├── ExternalControlGateway.php # 统一外部控制调用入口 │ │ ├── ExternalCallContext.php # 建立外部调用上下文 │ │ ├── ExternalCallValidator.php # 检查外部调用参数和约束 │ │ └── ExternalCallRecorder.php # 保存外部接口调用记录 │ ├── adapter/ │ │ ├── AdapterFactory.php # 创建对应接口适配程序 │ │ ├── AdapterResolver.php # 根据外部对象选择适配程序 │ │ ├── ProtocolAdapterInterface.php # 定义协议适配接口 │ │ └── AdapterVersionChecker.php # 检查适配程序版本 │ ├── driver/ │ │ ├── DeviceDriverInterface.php # 定义设备驱动调用接口 │ │ ├── SerialDeviceDriver.php # 串行设备驱动适配 │ │ ├── NetworkDeviceDriver.php # 网络设备驱动适配 │ │ └── IndustrialDeviceDriver.php # 工业设备接口适配 │ ├── software/ │ │ ├── SoftwareConnectorInterface.php # 定义软件对象连接接口 │ │ ├── HttpServiceConnector.php # 接入HTTP服务对象 │ │ ├── DatabaseConnector.php # 接入数据库执行对象 │ │ └── LocalProcessConnector.php # 接入本地程序或独立进程 │ └── execution/ │ ├── ExternalExecutionManager.php # 管理外部对象执行过程 │ ├── ExternalTaskMonitor.php # 查询外部任务执行状态 │ ├── ExternalCommandCanceller.php # 管理外部指令取消 │ └── ExternalCallRecovery.php # 恢复中断的外部调用上述目录中的具体驱动程序需要根据实际设备和软件系统确定,不应在尚未确定接口协议时预先写入固定的厂商字段、设备参数或通信格式。
接口调用还必须遵循个体赋值边界。即使某个外部设备接口能够提供大量操作,也不意味着当前个体能够调用全部操作。个体只能使用已经赋予的知识能力、方法和执行规则所允许的接口。接口适配程序负责技术调用,个体运行引擎负责执行范围判断,智能控制后台负责整体知识能力构建和赋值管理。这三个层次不能相互替代。
第五节 外部执行结果的获取与处理
外部控制接口完成调用之后,个体需要获取外部对象的实际执行结果,并将其转换为内部能够识别和处理的数据。外部对象返回的结果可能是一个简单状态码、一组传感器数据、一个软件接口响应、一个异步任务标识,也可能是一段持续变化的设备运行信息。
因此,外部执行结果不能直接作为最终行为结果使用,而应当经过接收、解析、转换、验证、关联和反馈处理。
首先需要区分接口调用结果与外部执行结果。接口调用结果反映个体与外部对象之间的调用过程,例如连接成功、请求发送成功、请求格式错误或接口超时。外部执行结果反映外部对象实际完成的操作,例如机器人是否到达目标位置、机械臂是否完成抓取、数据库是否完成写入、软件程序是否生成目标文件。
这两个结果可能一致,也可能不一致。例如,接口请求成功发送,但设备没有执行;设备已经执行动作,但反馈数据在返回过程中丢失;软件接口返回成功状态,但实际业务数据没有发生预期变化。因此,必须将调用状态和业务执行状态分别保存。
外部执行结果的标准数据模型可以包含外部调用标识、外部对象标识、原始返回数据、解析结果、设备实际状态、业务结果、结果来源和验证状态。
拟定的外部执行结果数据如下:
{ "external_result_id": "external_result_000128", "command_id": "external_command_000128", "external_object_id": "robot_device_001", "individual_id": "robot_001", "task_id": "task_000128", "call_status": "accepted", "execution_status": "completed", "result_source": "device_feedback", "raw_result": { "device_code": 200, "device_task_id": "device_task_00128" }, "normalized_result": { "operation": "move_to", "target_position": { "x": 12.5, "y": 8.2 }, "actual_position": { "x": 12.48, "y": 8.19 }, "device_state": "ready" }, "verification_status": "pending", "received_at": "2026-11-15 10:05:00" }在该示例中,
call_status表示外部接口调用状态,execution_status表示外部对象执行状态,verification_status表示个体是否已经完成结果验证。即使外部对象返回completed,个体仍然需要检查实际位置是否符合任务要求,并确认对象状态和执行约束没有发生异常。结果获取方式需要根据外部对象类型和接口特征确定。对于同步软件接口,可以在调用返回时获取结果;对于异步软件任务,可以通过任务查询接口获取状态;对于设备控制,可以通过控制器反馈、状态查询、传感器信息和事件通知获取结果;对于本地程序,则可以通过进程退出码、标准输出、错误输出和结果文件获取处理结果。
不同结果获取方式应当统一转换为内部结果结构。这样,行为执行程序不需要分别理解每种设备的原始响应格式,而是通过统一结果接口获取已经解析的数据。
外部结果处理需要建立专门的解析和验证程序。原始数据应当保留,转换后的结构化结果则用于后续认知、判断和行为状态更新。两者都应当与原始调用标识关联,确保出现异常时可以重新检查外部响应。
拟定的结果处理程序目录如下:
IndividualRuntime/ ├── external/ │ ├── result/ │ │ ├── ExternalResultReceiver.php # 接收外部对象返回结果 │ │ ├── ExternalResultParser.php # 解析不同接口的原始响应 │ │ ├── ExternalResultNormalizer.php # 转换为内部统一结果结构 │ │ ├── ExternalResultValidator.php # 验证返回结果完整性 │ │ ├── ExternalStateResolver.php # 解析外部对象实际运行状态 │ │ ├── ExternalResultVerifier.php # 验证实际执行结果 │ │ └── ExternalResultRepository.php # 保存外部执行结果 │ ├── feedback/ │ │ ├── ExternalFeedbackBuilder.php # 建立外部结果反馈数据 │ │ ├── ObjectStateFeedback.php # 将外部状态变化反馈到对象实例 │ │ ├── BehaviorFeedbackAdapter.php # 转换为行为执行反馈 │ │ └── CapabilityGapFeedback.php # 记录方法或能力不足信息 │ └── recovery/ │ ├── ExternalResultRecovery.php # 恢复未完成的结果获取过程 │ ├── ExternalStateRechecker.php # 重新读取外部对象实际状态 │ └── ExternalResultConflictHandler.php # 处理外部结果与内部状态冲突外部结果验证需要根据操作类型确定验证条件。对于设备位置控制,需要检查目标位置和实际位置之间的关系;对于抓取操作,需要确认物料是否已经被设备实际抓取;对于软件数据写入,需要重新读取相关数据并确认写入结果;对于文件处理,需要检查文件是否存在、内容是否符合预期以及处理程序是否正常结束。
对于一些持续性设备动作,结果不能只在操作开始时获取一次,而应当在运行过程中持续监测。例如机器人导航过程中,需要持续检查当前位置、移动状态和障碍物情况;无人机执行飞行任务时,需要持续检查位置、姿态、电量和飞行状态;工业设备运行时,需要根据设备控制要求检查运行参数和安全状态。
这意味着外部结果获取不仅是一次性的函数返回过程,还可能是持续运行的状态监测过程。个体运行环境需要将实时反馈与当前行为实例关联,并根据状态变化触发行为流程中的继续、暂停、停止、恢复或重新判断处理路径。
外部执行结果与行为状态之间也需要建立严格的转换关系。只有当结果经过验证,且满足行为流程定义中的完成条件时,才能更新第三十七章中的行为执行状态。如果外部结果不完整、存在冲突或者无法确认,则应当保留未知状态并等待进一步检查。
例如,机器人执行移动操作后,控制器返回导航任务完成,但位置传感器反馈显示实际位置仍然距离目标区域较远。此时不能直接把行为步骤标记为完成,而应当进一步检查坐标映射、定位数据、设备状态和导航结果。如果确认设备定位数据异常,则应当暂停后续依赖该位置的行为步骤,并重新获取信息和判断。
外部结果处理还需要考虑异常分类。连接异常、协议解析异常、参数错误、设备故障、执行超时、反馈冲突和业务结果不符合预期,是不同层次的问题,不能统一处理为一个接口调用失败。
连接异常通常需要检查连接状态和恢复条件;协议解析异常需要检查接口版本和数据格式;参数错误需要重新检查属性映射和控制参数;设备故障需要根据设备状态和安全规则采取处理措施;执行超时需要核实设备是否仍在运行;反馈冲突则需要重新读取外部对象状态,必要时重新进行认知和判断。
尤其需要注意,外部对象已经开始执行操作之后,不能因为接口超时就直接重新发送同一条控制指令。对于可能产生物理动作的请求,应当先通过原调用标识、设备任务标识和实际设备状态核实操作是否已经执行。如果无法确定,应当进入未知状态处理,而不是自动重复执行。
外部结果还需要反馈给第三十七章的行为执行管理程序。行为执行管理程序根据外部结果更新当前步骤状态,判断后续行为是否可以继续,并将必要的对象状态变化反馈给个体运行上下文。
对于知识能力不足的情况,外部结果也可以形成能力缺口反馈。例如,设备返回某种未知状态码,个体当前赋值的状态映射结构无法识别;或者设备提供了新的属性信息,但现有知识结构中没有对应定义。这些情况应当保存为结构或能力缺口信息,提交WSaiOS智能控制后台分析,而不能由个体未经验证直接修改知识结构定义。
后台接收到相关反馈后,可以根据实际需求分析是否需要扩展对象结构、属性定义、状态关系、方法定义或设备接口映射,并在完成知识能力构建和验证之后,决定是否向相关个体重新赋值。
在数据库组织方面,建议将外部对象信息、连接信息、属性映射、控制接口、执行指令、调用记录和结果反馈分别保存。拟定的数据库表可以包括
external_objects、external_connections、external_attribute_mappings、external_parameter_mappings、external_interfaces、external_commands、external_call_records和external_execution_results。external_objects保存外部对象身份和结构关联;external_connections保存连接配置和连接状态;属性映射表保存内部属性与外部字段之间的关系;参数映射表保存内部方法参数与设备控制参数之间的关系;接口表保存协议类型、接口版本和适配程序标识;指令表保存标准化执行指令;调用记录表保存实际接口调用过程;结果表保存外部返回数据及其验证状态。其中,连接密码、密钥和访问令牌等敏感信息不应以明文直接保存在普通业务数据表中,而应通过受控凭据管理机制保存。外部接口还需要采用最小权限原则,限制个体只能访问已经赋予的设备对象和操作范围。
外部结果与行为执行记录之间应当通过
command_id、behavior_instance_id和method_instance_id建立关联。这样,当行为执行出现异常时,可以从行为步骤追溯到具体方法调用,再追溯到外部设备指令和原始响应。对于设备状态发生变化但调用记录不完整的情况,也可以通过设备任务标识和外部对象标识进行辅助核对。在个体运行过程中,外部接口还需要支持通信与无通信两种运行模式。在通信模式下,个体可以通过本地设备接口或网络服务连接外部对象,并向中央控制后台同步相关状态和结果。在无通信模式下,个体仍然可以调用本地已经部署的设备驱动程序和软件执行组件,按照已赋值的知识能力和执行规则完成允许的任务。
无通信自主运行并不意味着外部设备必须完全脱离本地控制接口。它表示个体在无法与中央控制后台通信时,仍然能够依靠本地运行环境、已部署结构、方法、接口适配程序和执行规则完成自身职责范围内的任务。设备与个体之间的本地控制连接仍然可以存在。
当通信恢复后,个体需要将外部执行记录、行为状态、对象状态变化、异常信息和本地版本信息同步到中央控制后台。后台再根据整体任务和其他个体的运行情况,判断是否需要调整任务组织、知识能力或设备控制关系。
本章建立的外部对象与设备控制接口机制,使WSaiOS个体运行环境能够从内部知识结构和行为方法进一步连接到实际软件对象与物理设备。通过外部对象接入,个体获得了与实际执行环境建立关联的工程基础;通过属性与控制参数映射,内部知识结构与设备实际数据形成对应关系;通过统一指令格式,不同设备和软件系统可以进入一致的调用组织体系;通过控制接口和适配程序,内部方法能够作用于不同类型的外部对象;通过结果获取和反馈处理,外部实际状态又能够返回个体运行环境,形成完整的执行反馈链。
这一机制进一步明确了WSaiOS智能控制后台、个体运行环境和外部执行对象之间的工程边界。后台负责知识能力构建、验证、赋值和整体组织,个体负责依据已经赋予的能力和方法自主运行,外部设备及软件对象则按照接口指令执行具体操作并返回实际结果。三者通过明确的数据关系和调用接口构成完整的工程运行体系。
下一章将进一步研究个体自主控制与执行约束,重点解决个体在实际设备控制过程中如何管理操作权限、控制范围、安全条件、执行限制和人工干预,使自主运行能力能够在明确的控制边界内可靠实施。