内置算子
内置算子是由平台维护、在 GeniSpace Worker 中执行的能力。只有在当前环境和空间启用后才会出现在目录中。实际可用能力以实时目录为准，不以本文静态清单为准。
查找算子
打开控制台 → 算子或 WorkflowStudio 节点库，按名称、描述、分类或标签搜索。检查：
- 可用方法；
- 输入输出 Schema；
- 所需连接与权限；
- 配置字段和 Secret 处理；
- 启用状态与适用场景。
数据集和数据源能力即使底层由算子执行，也可能显示在节点库的独立分类中。
启用与配置
- 在目录选择算子。
- 检查所有方法和数据访问要求。
- 配置用户可控值和必需连接。
- 敏感值存为 Secret。
- 为目标空间或环境启用算子。
- 使用非生产输入测试方法。
- 将其加入工作流，或经过授权的智能体工具目录。
系统实现配置由平台管理员管理；空间用户只配置产品开放的字段。
常见分类
根据部署配置，目录可能包含：
- 数据集查询、计数、向量搜索和全文搜索；
- 数据转换与通用工具；
- REST 与 HTTP 请求；
- 文档、文本、图片、音频或媒体处理；
- 数据库 Schema 检查与 SQL 生成工具；
- 消息、邮件或平台支持的发布集成；
- 平台数据与应用操作。
算子出现在目录中，不代表当前用户一定有执行权限。系统会同时校验算子和每个被引用资源的授权。
在工作流中使用
添加算子节点、选择方法、映射类型化输入、配置超时与错误处理，再把结构化输出连接到下游。启用触发器前，使用正常、空结果和无效输入运行测试。
应查看实际节点结果，不要只依赖“成功”标签。调用成功仍可能返回零记录或业务拒绝。
作为智能体工具使用
只有选定算子会开放给智能体。运行时会考虑智能体形态、Ask/Agent 模式、空间权限、应用本地工具和工具配置。
适合作为工具的方法应具备：
- 唯一、动作明确的名称；
- 清楚说明正确选择条件；
- 精简、类型明确的参数；
- 结构化结果和明确空状态；
- 安全错误信息；
- 破坏性操作前要求确认。
数据集工具必须区分精确查询/计数、全文搜索和向量语义搜索。向量 Top-K 仍需依据返回证据判断是否真正符合条件。
更新
平台更新可能修复或扩展内置算子。管理员在修改开放契约前，应识别正在使用它的工作流和智能体，并进行回归测试。用户不应修改平台 Runtime 代码或系统凭据。
故障排查
| 现象 | 检查项 |
|---|---|
| 找不到算子 | 环境可用性、启用状态、空间权限 |
| 找不到方法 | 选中的算子版本和方法目录 |
| 参数校验失败 | 必填字段、Schema 类型、数组/对象结构 |
| 无权限 | 用户角色、算子、连接和目标资源权限 |
| 超时 | 远端依赖、算子超时、父任务超时 |
| 智能体选错工具 | 工具描述、重名、输入契约 |
| 数据集为空 | 搜索类型、向量化状态、字段、筛选和源记录 |