Duaer

文档

Duaer 文档。数字员工按您的标准交付。说清要什么,您来验收,满意才算交付。

数字组织与数据

画布上会碰到的事

画布

在 Duaer 里使用节点

在 Duaer 里,节点是取数入口、处理数据的一步,或把数据送出去的出口。

画布

在 Duaer 里把节点连在一起

在 Duaer 里,连线在节点之间建立链接,让数据沿数字组织流动。

画布

在 Duaer 里添加便签与说明

在 Duaer 里,用画布上的便签给数字组织加注解。

画布

在 Duaer 便签里用 Markdown

在 Duaer 里,便签支持 Markdown。标题、强调、列表、链接和代码会按版式显示。

结构

在 Duaer 里转成子数字组织

在 Duaer 里,在数字组织里选中一段节点,把它们收成可复用的子数字组织。

执行

在 Duaer 里自定义执行数据

在 Duaer 里,用 Code 节点或 Execution Data 节点给这次执行加上自定义数据,之后可在执行列表里按这些值筛选。

执行

在 Duaer 里隐藏执行数据

在 Duaer 里,控制执行记录里能否看见节点处理过的数据,用来保护敏感信息并满足合规要求。

数据

理解 Duaer 的数据结构

在 Duaer 里,弄清节点之间如何传数据,是搭数字组织的基础。本页说明数据格式,以及数据如何在节点间流动。

数据

在 Duaer 里固定数据

在 Duaer 里,开发数字组织时,把某一步的输出钉住,之后的测试用这份数据,而不反复去拉外部系统。

数据

在 Duaer 里编辑节点输出数据

在 Duaer 里,在 JSON 视图里改节点输出,用来测边界情况,而不必每次都从外部系统重发。

数据

在 Duaer 里使用输入面板映射

在 Duaer 里,数据映射是引用前面节点的数据,不是改写数据本身。

数据

在 Duaer 里处理文件和图片

理解并使用 Duaer 里的二进制数据。

数据

在 Duaer 里数据项如何对应

在 Duaer 里,每个输出项都带着元数据,指向生成它的输入项,形成可回溯的链条。

数据

在 Duaer 里数据项对应错误

在 Duaer 里,用 .item 引用更早的节点时,若对应链条断了,或指向多项,运行会报错。

数据

在 Duaer 的 Code 节点里保留对应

在 Duaer 里,引用前面节点时,需要知道该用哪一项。大多数节点会自动链接;Code 节点在某些情况下要你自己写 pairedItem。

表达式与代码

表达式、变量和转换方法

变量

在 Duaer 里定义自定义变量

在 Duaer 里用自定义变量存值,并在多条数字组织中复用。

表达式

在 Duaer 里用表达式转换数据

Duaer 表达式写在 {{ }} 里,可在支持表达式的参数中调用转换方法。只做字段整理时,先用 Edit Fields(Set)。

表达式

在 Duaer 里使用内置方法和变量

Duaer 在表达式里提供读取数据的变量和按类型调用的方法。Code 节点跑的是普通 JavaScript 和原生 Luxon。

表达式

在 Duaer 表达式里使用快捷方法

在 Duaer 表达式里用 $json 读当前项,用 $("节点名") 读前面的节点,用 $now 和 $if() 处理时间和条件。

表达式

在 Duaer 里使用 HTTP 节点分页变量

Duaer 的 HTTP Request 节点在分页表达式里提供 $pageCount、$request 和 $response。这三个名字只在该节点里有效。

转换

在 Duaer 里使用数据转换方法

在 Duaer 表达式里,在值后面调用转换方法,例如 {{ $json.name.toTitleCase() }}。按数组、布尔、日期、数字、对象、字符串分组。

转换

Duaer 数组上的转换方法

在 Duaer 表达式里,数组方法写在数组后面,例如 {{ $json.ids.unique() }}。average、max、min 遇到非数字会报错。

转换

Duaer 布尔值上的转换方法

在 Duaer 表达式里,布尔值可以判断空不空,也可以转成数字或字符串。true 转成数字是 1,false 是 0。

转换

Duaer 日期上的转换方法

Duaer 表达式里,$now 和 $today 是 Luxon 的 DateTime。字符串或数字要先 toDateTime(),再调用 format、plus、setZone。

转换

Duaer 数字上的转换方法

在 Duaer 表达式里,数字方法做取整、奇偶判断,以及转成布尔、字符串或 DateTime。round 取最接近的数,ceil 向上,floor 向下。

转换

Duaer 对象上的转换方法

在 Duaer 表达式里,对象方法用来判断字段、删字段、合并,以及把对象编成查询字符串。

转换

Duaer 字符串上的转换方法

在 Duaer 表达式里,字符串方法做大小写、截取、判断邮箱和网址,以及 base64 和 URL 编解码。

查询

在 Duaer 里用 JMESPath 查询 JSON

在 Duaer 里用 $jmespath(对象, "查询") 查询 JSON。表达式和 JavaScript Code 节点可用;Python Code 节点没有。

日期

在 Duaer 里用 Luxon 处理日期

Duaer 表达式里的日期是 Luxon 的 DateTime。$now 和 $today 直接就是。Code 节点用原生 Luxon,format() 和 plus(数量, 单位) 不能照搬。

示例

Duaer 表达式示例

这些 Duaer 示例都在表达式模式里:读当前项、补默认值、格式化日期,并在字段很多时改用 Edit Fields(Set)。

示例

Duaer 方法和变量对照

Duaer 表达式里最常用的名字:当前项用 $json,前面的节点用 $("节点名"),变量用 $vars,转换方法按数据类型分到各自的页面。

流程、账号与托管

失败、登录、自托管和版本变化

流程

在 Duaer 里妥善处理错误

在 Duaer 里设计数字组织时,预先考虑失败,并决定失败后怎么告警或改道。

流程

修复 Duaer 的内存问题

Duaer 不限制每个节点能取多少数据。执行需要的内存超过可用量时会出错。这一页说明如何识别并避免。

流程

在 Duaer 里使用循环

需要按多条数据重复处理时,用 Duaer 的循环。多数节点会自动按条目执行;少数情况要自己建循环。

流程

在 Duaer 里拆成子数字组织

用 Execute Sub-workflow 把一段流程拆成可复用的 Duaer 子数字组织。被调用方必须以 Execute Sub-workflow Trigger 开头。

账号

在 Duaer 里管理用户与访问

在 Duaer 实例里邀请同事一起工作,包括登录、角色与项目权限。

账号

把 LDAP 接到 Duaer

在 Duaer 里使用 LDAP。

账号

为 Duaer LDAP 映射角色

把目录组映射到 Duaer 实例角色或项目角色。

账号

为 Duaer OIDC 预配角色

完成 OIDC 登录后,把提供方的组映射到 Duaer 角色。

账号

为 Duaer SAML 预配角色

完成 SAML 登录后,把断言里的组映射到 Duaer 角色。

账号

在 Duaer 里要求两步验证

如何为 Duaer 账户启用两步验证。

账号

Duaer 里的自定义角色

Duaer 自定义角色概览:项目级与实例级。

账号

在 Duaer 里使用外部密钥库

把外部密钥库接到 Duaer。

托管

在 Duaer 里使用源代码管理与环境

Duaer 源代码管理与环境概览。

托管

为 Duaer 设置源代码管理

把 Duaer 实例连到你的 Git 提供方。

托管

在 Duaer 里使用环境

理解 Duaer 里环境背后的概念。

托管

在 Duaer 里使用 Git

Duaer 里的 Git 概念与限制。

托管

在 Duaer 里推送与拉取改动

把工作送到 Git,并从 Git 拉回你的 Duaer 实例。

托管

把 Duaer 日志流到外部系统

把 Duaer 事件流到你的日志工具。

托管

用 Insights 跟踪 Duaer 用量

Duaer Insights 让实例所有者与管理员看到数字组织一段时间里的表现。

接口

使用 Duaer 公开 API

用 API 密钥调用 Duaer 公开 REST API。

接口

Duaer 公开 API 的身份验证

Duaer 用 API 密钥鉴权公开 REST API。

接口

Duaer 公开 API 端点参考

对照你这台 Duaer 实例上的公开 REST API。文档站不另存一份会过期的路由表。

版本

Duaer 变更日志

Duaer 版本说明入口。破坏性变更另有专页。

版本

Duaer 发行说明

这一版 Duaer 带来了什么,以及升级时要核对的项。

版本

Duaer v3 破坏性变更

升级到 Duaer v3 后会改变的行为。

版本

Duaer 1.0 迁移清单

从 Duaer 1.0 之前迁上来时要核对的项。

版本

Duaer 2.0 破坏性变更

升级到 Duaer 2.0 后会改变的行为。

托管

在 Duaer 里启用队列模式

按需要用不同模式跑 Duaer。队列模式可扩展性最好。

托管

控制 Duaer 并发

限制自托管 Duaer 同时跑多少生产执行。

托管

修复自托管 Duaer 的内存问题

自托管 Duaer 的内存相关错误:如何识别与避免。

托管

在 Duaer 里处理二进制数据

处理大文件而不拖慢 Duaer。

托管

比较 Duaer 版本

比较自托管 Duaer 的社区版、注册社区版、Business 与 Enterprise。

托管

为自托管 Duaer 配置用户管理

配置自托管 Duaer 以支持用户管理,并开始邀请用户。

托管

Duaer 加密密钥

Duaer 用加密密钥保护写入数据库的凭证。首次启动会自动生成;也可用 DUAER_ENCRYPTION_KEY。

托管

为 Duaer 设置自定义加密密钥

为 Duaer 设置自定义加密密钥,用于安全加密凭证。

托管

Duaer 环境变量

用环境变量配置自托管 Duaer 进程。

托管

用环境变量管理 Duaer 设置

从进程环境、.env 或容器注入配置自托管 Duaer。

托管

Duaer 支持的数据库

自托管 Duaer 可用 SQLite 或 Postgres。

托管

为 Duaer 设置 task runners

配置 Duaer task runners,用内部或外部进程执行任务。

托管

用 OpenTelemetry 追踪 Duaer 执行

把 Duaer 数字组织与节点执行的追踪发到 OpenTelemetry 采集端。

托管

使用 Duaer 命令行

自托管 Duaer 内置命令行可用的命令。

托管

更新 Duaer

更新自托管 Duaer 的最佳实践。

托管

在 Duaer 上运行安全审计

对你的 Duaer 实例运行安全审计。

AI、部署与其它

智能体、助手、部署方式和凭证

AI

在 Duaer 里跑通第一个 AI Agent

在 Duaer 里用 AI Agent 接上聊天模型,再按需要接工具。这一页是最小可跑通的数字组织。

AI

在 Duaer 里使用 Chat hub

Chat hub 给人一个对话入口,不必进画布。Duaer v3 起默认关闭,可用 DUAER_ENABLED_MODULES 暂时打开。

AI

在 Duaer 里用 RAG 检索相关上下文

把文档写入向量库,提问时再检索片段交给模型。Duaer 的 RAG 通常分成加载和检索两条分支。

AI

在 Duaer 里用 $fromAI 填工具参数

在 Duaer 里,$fromAI 标出由 AI Agent 在调用工具时填写的参数。键名只能含字母、数字、下划线和连字符。

AI

在 Duaer 里用指标衡量质量

在 Duaer 里,按测试集跑 AI 数字组织,把算好的分数记进评估结果,用来对照不同版本。

AI

在 Duaer 里修好评估里常见问题

在 Duaer 里,多个触发器、字段对不上、或聊天输出被评估节点抢走时,先查接线。

AI

打开 Duaer MCP 服务端

在 Duaer 里,把实例暴露为 MCP 服务端,让外部客户端按授权操作数字组织。先在实例里打开访问。

AI

用 AI 起草 Duaer 数字组织

在 Duaer 里,用自然语言描述目标,构建器生成或修改数字组织节点。仍要你在画布上确认。

AI

把 MCP 客户端连到 Duaer

在 Duaer 打开 MCP 访问后,把连接地址和鉴权写进客户端配置。

AI

使用 Duaer 云上的 AI 助手

Duaer 云上的 AI 助手在 Settings 里开关,用来协助改数字组织。

AI

管理 Duaer 云上的 MCP 访问

在 Duaer 云实例上打开 MCP 访问后,外部客户端才能连接。

部署

在 Duaer 里为自托管配置实例 AI

在 Duaer 里,自托管在 Settings 的实例 AI 向导里配置助手,可选沙箱和网页搜索。环境变量要在启动前准备好。

部署

用 Docker 托管 Duaer

Duaer v3 起,Docker 是唯一支持的部署方式。实例检查若发现没在容器里跑,会打开这一页。

部署

在 Duaer 里把 task runner 设成外部进程

Duaer 弃用内部 task runner。应单独跑 runner,设为 external,并与启动器共享 DUAER_RUNNERS_AUTH_TOKEN。

部署

在 Duaer 里用环境变量配置二进制存储

在 Duaer 里,用环境变量指定二进制数据的存储模式和路径。主进程和 worker 必须同一套配置。

部署

在 Duaer 里配置安全相关环境变量

在 Duaer 里,SSRF 等安全开关可通过环境变量配置。v3 起默认拦截的 IP 段更宽,检查会链到这一页。

部署

在 Duaer 里配置数字组织相关环境变量

在 Duaer 里,可用环境变量设默认调用策略等行为。默认仍是 any 时,v3 检查会报并打开这一页。

部署

在 Duaer 里管理安全策略

在 Duaer 里,Settings 的安全页把文档指到这里,说明实例级安全策略入口。

其它

在 Duaer 里创建和编辑凭证

在 Duaer 里,凭证保存在实例里并用加密密钥保护。节点引用凭证,不把密钥写进参数。

其它

在 Duaer 里使用终端用户凭证

在 Duaer 里,终端用户凭证属于最终使用者自己的连接。运行时用触发者的账号,而不是共享那一把。

其它

在 Duaer 里配置数字组织设置

在 Duaer 里,设置里包括时区、错误处理和调用策略等。v3 去掉 “Any workflow” 后,检查会链到可被谁调用这一节。

其它

在 Duaer 里配置嵌入部署

把 Duaer 嵌进其它产品时,可用配置覆盖凭证等行为。

其它

在 Duaer 里打开课程入口

在 Duaer 里,产品里的 Courses 链接打开这一页。这里是练习说明的入口,不是单独的录播平台。

其它

在 Duaer 里理解条目如何流动

在 Duaer 里,这一章说明一条输入是什么结构,以及多条目时节点默认怎么执行。

其它

在 Duaer 里循环说明已搬家

在 Duaer 里,旧地址。按条目执行和 Execute Once 的说明在流程文档的循环页。

其它

在 Duaer 里改用 Code 节点

在 Duaer 里,Function 节点已移除。在 Code 节点里写 JavaScript。保留此地址以免旧链接落空。

集成

内置节点、凭证和社区包