文档
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、部署与其它
智能体、助手、部署方式和凭证
在 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。保留此地址以免旧链接落空。
集成