用途:在 Unity 中搭建 NPC/AI 决策逻辑时,查询行为图资产、为 GameObject 挂载并绑定 BehaviorGraphAgent、读写黑板变量。依赖可选包 com.unity.behavior(对照 1.0.16 验证),未安装时各技能返回 PACKAGE_NOT_INSTALLED,需先执行 package_install packageName="com.unity.behavior",安装会触发 Domain Reload,完成后再次调用 behavior_status。
主要能力:查询类技能(behavior_status、behavior_graph_list、behavior_graph_info、behavior_agent_get、behavior_agent_list、behavior_blackboard_list)为 SemiAuto,无需授权;变更类(behavior_graph_create、behavior_agent_add、behavior_agent_set_graph、behavior_blackboard_set)为 FullAuto,Approval 模式下需用户授权。behavior_graph_create 创建空图并强制重导入以烘焙运行时子资产与 Start 根节点;behavior_agent_add 可同时绑定图并校验路径;behavior_blackboard_set 支持 int/float/bool/string、enum、Vector、Color、GameObject/Component 等类型,写入 agent 级覆盖或图资产默认值。
使用方式:先 behavior_status 确认安装,再 behavior_graph_list 定位图,在 Behavior 编辑器窗口编辑节点,用 behavior_graph_info 确认拓扑与黑板契约,behavior_agent_add 绑定,behavior_blackboard_list 读取变量名与类型,最后 behavior_blackboard_set 赋值。
限制:不支持节点级图编辑(增删、连接、重配节点),需在编辑器窗口完成;黑板变量不能创建、重命名、改类型或删除;事件通道、子图动态链接、运行时序列化、Agent 生命周期控制均未暴露;对 graphAssetPath 写入会改变所有无覆盖 agent 的共享默认值。若返回 API_MISMATCH,说明包版本成员布局不同,应报告版本不匹配并改用编辑器窗口或直接编辑 .asset。