Skip to Content
实操指南桌面端

桌面端

产品概述

产品定义

DeepWorks 是面向个人用户及企业用户的端云协同、本地优先 AI 员工工作台。产品以工作区承载本地文件和任务上下文,以专家与专家团承载岗位化能力,以 Skill、MCP 和扩展连接工具与企业系统,并通过企业知识底座、协作空间和自动化任务支持持续执行与组织协同,通过 IM 频道连接即时通讯平台。

DeepWorks 的核心工作闭环是:完成工作—沉淀知识—复用能力—持续增强。用户既可以像使用通用 AI 助手一样发起对话,也可以把复杂任务交给具备岗位职责、知识边界、工具权限和执行策略的智能体持续完成。

主要能力

DeepWorks 主要包含以下能力:

  • 本地AI对话:围绕工作区开展多轮对话、文件处理、模型切换和任务执行。

  • 专家与专家团:按业务场景召唤单一专家或多角色专家团处理专业任务。

  • Skill 与扩展:安装并调用可复用技能,通过 MCP 或插件连接外部能力。

  • 企业知识中心:接入企业知识和业务系统,以企业本体为统一语义基础。

  • 自动化:将重复性工作设置为按计划执行的任务,集中管理运行计划、启停状态和执行结果。

  • 协作:在协作空间中管理成员、任务、文件版本与交付成果,衔接本地执行和云端 AI 处理。

  • IM 频道:连接钉钉、飞书等即时通讯平台,通过机器人发送任务、接收回复,并在桌面端查看对应会话。

典型使用场景

  • 在指定工作区中读取项目材料,形成方案、报告、PPT、表格或代码等交付物。

  • 召唤数据治理、设备运维、销售分析、门店运营等专家或专家团完成专业分析。

  • 将新闻整理、工作简报或每周复盘设置为自动化任务,按计划执行并查看结果。

  • 在协作空间中集中管理项目资料,通过任务跟踪进度、文档标注反馈意见,并保存可追溯的交付成果。

  • 在钉钉或飞书中向机器人提交工作要求,接收处理回复,并在 DeepWorks 桌面端继续查看和跟进会话。

手册范围

本手册重点说明进入 DeepWorks 后的桌面端操作,涵盖工作区与对话、AI 同事、Skill 与扩展、自动化、IM 频道、协作及账号与系统设置。客户端下载安装、企业开通和登录认证、服务端部署与后台运维,以及模型、数据源和第三方系统的底层配置,通常由企业管理员或技术支持人员负责,本版不展开说明。IM 频道所需的钉钉、飞书机器人接入配置见对应章节。此外,企业知识中心相关内容不在该手册展开,由单独手册进行介绍。

名词说明

工作区(Workspace):DeepWorks 开展任务的基础工作环境。工作区关联本地目录、文件、对话和权限范围,AI 默认只在已授权范围内读取或写入内容。

对话(Conversation):用户与通用助手、专家或专家团围绕某一主题形成的连续交互记录。

专家(Expert):针对特定业务领域预配置的专业智能体,适合由单一专业角色完成的任务。

专家团(Expert Team):由多个专业角色协同组成的执行组合,适合跨专业、跨步骤或需要相互校验的复杂任务。

Skill(技能):标准化、可复用的能力说明和执行方法。对话时可以根据任务需要加载并调用已安装 Skill。

插件(Plugin):为 DeepWorks 增加浏览器、电脑控制、图片生成、需求摘要、周报等附加能力的连接组件。

MCP:用于连接外部系统、工具或企业数据服务的标准化能力接口。是否可用取决于企业环境和连接配置。

CLI(Command Line Interface,命令行接口):通过命令调用程序或服务能力的接口。完成所需安装、配置和登录授权后,用户可在会话中用自然语言提出任务,由 AI 结合相关 Skill 调用 CLI 执行,无需手动编写命令。

沙箱(Sandbox):限制智能体运行时文件、系统和网络访问范围的隔离环境。

快速入门

认识工作台

进入 DeepWorks 后,页面主要分为左侧导航区、中央工作区和底部任务输入区。 Pasted image 20260810135449

  • 左侧导航区:进入新对话、智能体、专家·技能·扩展、协作、自动化、工作区、长程任务和 Deepexi 底座。

  • 中央工作区:显示当前对话、任务运行过程或功能管理页面。

  • 底部任务输入区:输入任务要求,并选择模型、推理力度、工作区、专家、Skill、MCP 或扩展。

  • 账号入口:切换账号、设置主题、检查更新、进入帮助文档或退出登录。

完成第一个任务

建议按照以下步骤发起任务:

  1. 在左侧选择已有工作区,或点击创建工作区建立新的工作区。 Pasted image 20260810140158 Pasted image 20260810140215
  2. 点击新对话或在工作区发起新对话。 Pasted image 20260810142037 Pasted image 20260810142142
  3. 在底部确认当前工作区、执行权限和模型。 Pasted image 20260810142255
  4. 如需处理材料,点击附件按钮添加文件;如需调用专用能力,打开工具菜单选择 Skill、MCP 或扩展。 Pasted image 20260810142347
  5. 在输入框中说明任务目标、已有材料、输出要求和限制条件,点击发送。 Pasted image 20260810142455

工作区与对话

新建和切换对话

新建对话

点击左侧导航顶部的新对话,即可在当前工作区创建新对话。新对话不会删除原有历史记录。 Pasted image 20260813154749

切换历史对话

工作区下方展示该工作区的历史对话。点击对话名称即可继续原任务。长程任务区域展示专家与专家团执行过的持续性任务和历史记录。 Pasted image 20260813155350

使用历史对话时,应先确认其工作区和任务主题,避免在错误上下文中继续操作。

搜索对话

点击搜索按钮,可按对话或任务内容进行检索。适合在对话较多时快速定位历史工作。 Pasted image 20260813155415 Pasted image 20260813155442

归档聊天

暂时不需要继续处理的对话,可以归档后集中管理。

操作路径: 左侧工作区下的目标对话→右侧…→归档聊天。

  1. 在左侧工作区中找到需要归档的对话。
  2. 点击该对话右侧的…,打开会话操作菜单。
  3. 点击归档聊天,将该对话移入已归档的聊天。

归档聊天-01-操作入口

归档后,可进入设置 > 已归档的聊天查找或取消归档,具体操作见9.13 已归档的聊天。

会话置顶

常用或需要持续跟进的会话,可以置顶到左侧置顶区域,方便快速打开。

操作路径: 左侧工作区下的目标会话→会话右侧图钉按钮置顶。

  1. 在左侧展开目标工作区,找到需要置顶的会话。
  2. 将鼠标移到该会话上,显示右侧操作按钮。
  3. 点击图钉按钮(悬停提示为置顶)。

会话置顶-01-置顶入口

  1. 置顶后,该会话显示在左侧置顶区域,位于我的工作区上方。点击会话名称即可打开并继续对话。

取消置顶: 在置顶区域,将鼠标移到目标会话上,点击右侧图钉按钮(悬停提示为取消置顶),即可取消该会话的置顶状态。

会话置顶-02-取消置顶

会话导航

会话内容较长时(会话轮次超过3轮),可使用会话内容区左侧的导航标记,快速预览并定位历史消息。

操作路径: 打开目标会话→会话内容区左侧导航标记→悬停预览→点击定位。

  1. 打开需要查看的会话,在会话内容区左侧找到由多条短横线组成的导航标记。
  2. 将鼠标悬停在某条导航标记上,查看弹出的内容预览。预览中展示对应的用户提问和 AI 回复片段,便于识别要查找的内容。
  3. 确认目标内容后,点击对应的导航标记,跳转到该位置,阅读完整消息及上下文。
  4. 需要返回最新内容时,点击输入框上方的↓ 跳到最新,即可快速回到会话底部。

会话导航-01-预览与定位

工作区管理

操作路径: 左侧工作区→目标工作区右侧更多按钮。

工作区用于绑定项目目录、文件和对话上下文。点击工作区右侧的更多按钮可打开操作菜单。 Pasted image 20260813160446 工作区支持以下操作:

  • 新建对话:在该工作区中新建对话。

  • 置顶:将常用工作区固定在列表前部。

  • 编辑名称:修改工作区显示名称。

  • 权限设置:管理工作区可以访问的文件夹。

  • 在 Finder 中显示:打开工作区对应的本地目录。Windows 环境中的实际名称以客户端为准。

  • 移除工作区:从 DeepWorks 工作区列表中移除该工作区。执行前应确认是否影响本地目录或未完成任务,具体行为以正式版本提示为准。

创建工作区

操作路径: 左侧工作区→创建工作区。
使用前提: 当前用户具备本地目录访问权限。

  1. 点击左侧工作区标题旁的创建工作区。 Pasted image 20260813160015
  2. 选择需要作为工作区的本地目录。 Pasted image 20260813155634
  3. 按照页面提示确认名称和访问范围。 Pasted image 20260813160258
  4. 创建完成后,在左侧工作区列表中选择该工作区。

建议一个工作区对应一个相对独立的项目、客户或长期事项,避免把无关文件和对话混在同一上下文中。

设置工作区权限

操作路径: 目标工作区右侧更多按钮→权限设置。

进入工作区菜单,点击权限设置,可以查看和维护当前工作区已授权的文件夹。 Pasted image 20260813160905

添加授权文件夹

Pasted image 20260813160932

  1. 点击添加文件夹。

  2. 在系统文件选择器中选择需要授权的目录。

  3. 确认后,目录将显示在已授权文件夹列表中。

移除授权文件夹

在已授权文件夹右侧点击移除。移除后,当前工作区将不能继续访问该目录,但不会删除目录中的本地文件。 Pasted image 20260813161025

建议遵循最小授权原则,只授权完成任务所必需的目录,不要将个人全部文件或包含敏感信息的上级目录整体授权。

选择模型

操作路径: 任务输入区右下角→当前模型名称。
使用前提: 当前账号具有相应模型的使用权限。

平台内置的模型提供商为 DeepFoundry,使用其模型将消耗用户积分。点击任务输入区右下角的当前模型名称,即可打开模型选择列表,可选择模型及强度。

选择模型-V1.4-01-模型与推理强度

添加文件和调用工具

添加文件

添加文件可将本地材料作为任务附件,供 AI 结合任务要求进行内容分析、信息提取或总结。

操作路径: 任务输入区左下角+→上传文件。

  1. 点击任务输入区左下角的+,打开功能菜单。
  2. 选择上传文件,在系统文件选择窗口中选择需要添加的本地文件并确认。
  3. 文件添加后,在输入框中说明处理要求,例如总结这份材料的主要内容或提取文件中的关键数据,然后点击发送。

添加文件-V1.4-01-上传文件入口

支持的文件类型、单文件大小和总容量限制以当前页面提示及企业配置为准。

调用 Skill、扩展或 MCP

操作路径: 任务输入区→工具按钮→选择Skills``插件或MCP。
使用前提: 相关能力已经安装、连接或获得授权。

点击工具按钮,打开命令与 Skills 菜单。 Pasted image 20260813161635

菜单可按以下类型查看能力:

  • 命令:执行预设命令;

  • Skills(技能):加载已安装的标准化技能;

  • 扩展:调用浏览器、电脑控制、图片生成等扩展能力;

  • MCP:调用已连接的外部工具或企业服务。

如未找到所需 Skill,可点击配置按钮进入 Skill 管理页面。

发送与运行任务

输入任务要求后,点击发送进行常规对话,或启动需要工具调用和多步骤处理的任务。 Pasted image 20260813161840

任务执行过程中应关注以下信息:

  • 是否使用了正确的工作区、模型和专家;

  • 是否需要用户补充文件、参数或确认;

  • 是否涉及写入业务系统、外部发送或其他高风险操作;

  • 结果文件是否保存到预期目录。

对于重要任务,建议在结果生成后要求 AI 列出信息来源、关键假设、未验证事项和输出文件位置。

AI同事

AI 同事包括面向特定领域的专家和由多个专业角色组成的专家团。用户可根据工作需求选择合适的 AI 同事,在会话中提交任务和材料,获得专业分析与交付成果。

按分类查找 AI 同事

操作路径: 左侧我的AI同事。

按业务领域或产品分类查找 AI 同事,适合已明确任务所属领域的情况。

  1. 点击我的AI同事,进入同事列表。
  2. 根据任务选择通用``装备制造``零售``科研教育``公共服务``数据治理等分类,筛选相关专家与专家团。
  3. 阅读同事的职责说明和能力标签,判断其专业范围是否符合任务要求;可结合产品归属进一步选择。
  4. 同一分类下的同事较多时,使用列表底部的页码或前后翻页按钮继续查找。

AI同事-V1.4-01-分类浏览

常见通用任务可按以下方式选择专家:

工作需求推荐专家适用任务
处理办公文档文档处理专家处理 Word、Excel、CSV、PPT、PDF 和 Markdown 等材料,进行格式转换、内容整理或脱敏预览。
制作演示文稿PPT制作专家将文档、想法和业务素材整理为客户方案、经营汇报、培训课件等演示文稿。
开展研究分析深度研究专家进行竞品分析、文献综述、事实核验、行业研究和技术选型。

需要查阅共享知识资料时,点击打开共享知识库进入知识库。

根据需求匹配 AI 同事

需求匹配用于根据自然语言描述推荐相关专家或专家团,适合不熟悉同事分工或不确定应选择哪个角色的情况。

  1. 在顶部输入框中描述希望完成的工作,例如我想了解数据治理。
  2. 点击帮我匹配,系统根据需求推荐相关 AI 同事。
  3. 对照推荐同事的职责、能力标签和产品归属,选择适合当前任务的专家或专家团。
  4. 推荐结果不符合预期时,补充或修改需求描述,点击重新匹配。
  5. 如需取消本次推荐,点击清除;也可继续通过分类查找同事。

AI同事-V1.4-02-需求匹配

匹配结果可同时包含专家和专家团。例如,数据治理工作可根据任务范围选择治理诊断与体系专家、数据开发与质量专家,或选择数据治理专家团开展跨专业协作。推荐结果随需求和可用同事变化。

召唤专家或专家团

使用专家

专家适合专业范围明确、主要由单一角色完成的任务。

  1. 通过分类查找或需求匹配选定专家。
  2. 在专家卡片上点击召唤,进入专家会话。
  3. 输入任务目标、已有材料、期望输出和限制条件,并按需添加相关文件。
  4. 根据专家回复补充信息,逐步完成任务并检查交付成果。

例如,召唤文档处理专家后,可提交待整理的文档,并说明需要转换的格式、保留的内容和脱敏要求。

使用专家团

专家团适合需要多个专业角色共同分析、分工执行或交叉校验的综合任务。

  1. 通过分类查找或需求匹配选定专家团。
  2. 阅读专家团的组成和职责说明,确认其覆盖任务所需的专业范围。
  3. 召唤专家团,在会话中提交整体目标、业务背景、相关材料和交付要求。
  4. 根据任务进展补充信息,确认各阶段成果。

例如,数据治理专家团由治理诊断与体系专家、资产与标准专家、开发与质量专家、交付与文档工坊组成,可协同完成治理体系建设、资产盘点、标准制定、数据采集、数据开发与质量管理等工作。

了解 DeepexiSense 产品与协作方式

操作路径: 左侧我的AI同事→右上角DeepexiSense →。

DeepexiSense 帮助用户了解不同产品的业务定位,并通过典型场景和对话示例熟悉与 AI 同事协作的方法。可切换DataSense``DeepSense``FDESense,按业务需求了解相应能力。

点击了解这个产品可进一步了解所选产品;完成浏览后,点击返回我的AI同事返回同事列表,选择适合的专家或专家团。

DataSense:商业运营决策智能体

DataSense 面向商业运营分析与决策,帮助用户分析经营表现,优化商品、门店和供应链,并形成可执行的业务行动建议。

  1. 选择DataSense。
  2. 根据工作目标选择预算滚动纠偏或门店经营诊断,点击看看怎么一起工作,了解相应场景的协作方式。
  3. 如需围绕自己的业务需求搭建场景,点击自建业务场景,按引导继续操作。

AI同事-V1.4-03-DataSense

业务场景对应专家功能用途
预算滚动纠偏经营计划专家支持销售目标测算、商品预算拆解和进销存滚动平衡,帮助识别经营偏差并开展纠偏。
门店经营诊断门店运营专家支持门店数据体检、横向对标和方案沙盘推演,帮助发现经营差距、验证改进方案。

DeepSense:工业智能体

DeepSense 面向设备维修团队,依据本体和设备机理模型开展故障排查、定位根因并生成可执行的维修工单。通过工单回流和本体迭代,持续积累设备诊断与维修知识。

  1. 选择DeepSense,点击看看工作示例了解设备故障诊断的工作方式。
  2. 根据使用需求选择本地或线上设备诊断运维专家示例。
  3. 点击展开对话示例,了解如何围绕故障问题开展对话,以及可获得的诊断与维修成果。

AI同事-V1.4-04-DeepSense

  • 本地设备诊断运维专家:支持双向对接 MES、设备运维问答和个人故障诊断知识库的持续优化。
  • 线上设备诊断运维专家:提供在线故障诊断支持,协助制定诊断方案和生成维修工单,服务产线设备健康管理。

FDESense:企业数据治理智能体

FDESense 面向企业数据负责人、治理团队与数据工程师,通过 AI 专家协同开展治理诊断、资产盘点、标准制定、数据建模、数据开发与质量管理,推动治理成果落地。

  1. 选择FDESense,点击看看工作示例了解数据治理的协作方式。
  2. 根据当前治理阶段,选择现状诊断与体系建设``资产盘点与标准制定或数据开发与质量管理。
  3. 点击展开对话示例,了解任务所需的业务材料、专家协作过程和预期成果。

AI同事-V1.4-05-FDESense

业务场景对应专家功能用途与成果
现状诊断与体系建设治理诊断与体系专家基于调研纪要与访谈记录,梳理业务、系统与数据的现状问题,形成诊断报告与问题清单。
资产盘点与标准制定资产与标准专家根据诊断报告与业务调研,分层建立数据资产目录(L1—L5),形成数据元标准清单与指标清单。
数据开发与质量管理数据开发与质量专家基于资产目录与指标清单制定质量规则,指导数仓开发与平台落地。

SKILL

Skill Hub

Skill Hub 用于查找和安装企业或系统提供的技能,帮助用户为文档处理、数据分析等任务补充所需能力。

操作路径: 左侧发现→技能→Skill Hub。

SkillHub-V1.4-01-查找与安装技能

查找技能

  1. 进入Skill Hub,浏览可用技能,根据名称、功能简介、版本和技能标识判断是否符合任务需要。
  2. 在搜索Skill输入框中输入关键词,查找目标技能。
  3. 如需缩小范围,使用全部分类筛选技能类别,或通过安装状态筛选框选择全部``未安装``已安装。
  4. 技能较多时,可使用列表底部的页码或翻页按钮继续浏览,也可调整每页显示条数。

安装技能

找到需要的技能后,点击该技能右侧的+发起安装,并按页面提示完成操作。安装前应阅读技能说明,确认其用途及所需文件、网络、外部服务和数据权限。

安装完成后,可切换到已安装查看和管理技能,具体操作见 6.2 管理已安装 Skill。

需要重新获取技能列表时,点击刷新。

管理已安装 Skill

切换到已安装,可以按系统、个人和 Skill Hub 来源查看当前已安装 Skill。 Pasted image 20261023111418

  • 系统 Skill:由企业或系统统一提供;

  • 个人 Skill:由当前用户安装或创建;

  • Skill Hub Skill:从 Skill Hub 安装的能力。

点击 Skill 的更多操作,可以定位文件或卸载。卸载前应确认是否被自动化任务或日常流程引用。 Pasted image 20261023111431

添加 Skill

点击添加技能,可以选择安装技能或创建技能。 Pasted image 20261023111445

创建 Skill

点击创建按钮,进入会话,自动调用skill-creator技能进行技能创建。 Pasted image 20260813163524

适合将稳定、重复的工作方法沉淀为可复用能力。创建时应明确适用场景、输入材料、执行步骤、输出要求和安全边界。

安装 Skill

点击安装Skill,可上传Skill安装包,支持安装到全局或指定工作区。 Pasted image 20260813163956 适合导入已有的标准 Skill 包。上传前应确认来源可信、内容可审查,并符合企业安全要求。

发布 Skill

支持将本地 Skill 提交至 Skill Hub,审核通过后供其他企业成员使用。可通过技能管理页面手动发布,也可在会话中发起发布。

手动发布 Skill

选择已安装→个人 Skill,点击目标 Skill 的发布按钮,输入中文名称和描述,并选择分类。提交后由企业管理员审核,审核通过后发布到 Skill Hub。

Pasted image 20260813164309 Pasted image 20260813164347

在会话中发布 Skill

操作路径: 工作区会话→发送发布指令→确认发布信息→查看预览→确认提交。

使用前提: 已登录企业账号,且本地已有可定位的 Skill;发布工作区内的 Skill 时,应进入对应工作区。

准备待发布的 Skill

完成 Skill 创建或修改后,确认待发布的内容已保存。若刚在会话中完成优化,可继续在同一会话中发起发布,无需重新创建 Skill。

Skill发布-01-准备技能

发起发布

在输入框中明确提出发布要求并发送,例如把刚才优化的技能发布到 SkillHub。若当前会话未明确目标,应同时提供 Skill 名称。

等待系统识别目标并检查发布资料,随后按会话提问补充信息。

Skill发布-02-发起发布

选择发布分类

在发布分类提问中选择符合 Skill 用途的分类;需要查看其他选项时,滚动分类列表。推荐项可作为参考,应按实际用途确认。

Skill发布-03-选择分类

确认发布目标

存在多个同名 Skill 时,在发布目标提问中根据来源和修改情况选择要发布的版本。例如,要发布当前工作区中的修改内容,应选择相应工作区副本。无法从选项确定目标时,可在自定义回答中补充说明。

完成分类和目标等问题的选择后,提交回答,继续生成发布预览。

Skill发布-04-确认目标

核对预览并确认提交

在右侧打开的Skill 发布预览.md中核对目标、名称、描述、分类和变更说明。该预览为只读;如需调整,在会话中提出修改要求,待预览更新后重新核对。

Skill发布-05-发布预览

核对无误后,在会话中发送确认提交,正式提交到 Skill Hub 进入审核。仍需修改时,先完成调整,再对最新预览确认提交。

生成预览时尚未上传。新建或更新由服务端在提交时最终校验,候选 Hub 版本由服务端生成,无需手动填写。提交后以会话返回的实际结果为准;进入审核不代表已发布,审核通过后才可在 Skill Hub 使用。

技能清理

操作路径: 左侧我的AI同事→技能→已安装→技能清理。

需要整理已安装技能时,可选择批量清理清理指定技能,或选择一键卸载清理所有本机工作区及用户全局范围内的个人和 Skill Hub 技能。个人技能会删除本地内容,Skill Hub 技能仅在本地卸载,线上内容和发布记录保留;系统技能不参与清理。

技能清理-01-操作入口

批量清理

  1. 在已安装页面先设置搜索关键词,并选择全局或指定工作区,确定本次清理范围。
  2. 点击技能清理→批量清理,进入选择状态。当前筛选结果中可清理的个人和 Skill Hub 技能默认全选,可按需取消或重新勾选具体技能。
  3. 核对已选数量,点击清理所选(N)。如需修改搜索或工作区范围,先点击退出清理,调整筛选后重新进入。

技能清理-02-选择技能

  1. 在确认批量清理弹窗中核对筛选范围、所选总数及来源数量,确认是否包含需要保留的技能;如需调整,点击取消返回列表。
  2. 按下节说明设置备份,核对无误后点击开始清理。未选择备份目录时,还需按提示再次确认。

技能清理-03-确认批量清理

进入批量清理后,搜索和工作区筛选会锁定。系统技能及其他不可清理项不纳入本次清理,实际清理对象以确认弹窗为准。

清理前备份

批量清理和一键卸载均可在确认弹窗中设置备份。需要保留技能内容时,点击选择备份目录,选择本地文件夹。个人和 Skill Hub 技能使用同一备份目录,保存完整技能备份及备份清单文件 manifest.json。

选定后核对目录路径;需要调整时点击更换备份目录,不再备份时点击取消备份。备份目录应具有写入权限和足够空间,且不要放在待清理的技能目录内。

技能清理-04-设置备份

选择备份后,系统先备份再清理;备份失败的技能不会被删除或卸载。未选择备份目录时,需再次确认后才会直接清理,且无法通过本功能恢复,请先确认重要内容已妥善保存。

一键卸载

  1. 在已安装页面点击技能清理→一键卸载,直接进入确认弹窗,无需逐项勾选。
  2. 核对待清理数量和影响范围。一键卸载覆盖所有本机工作区及用户全局范围,不受当前搜索词或工作区筛选限制,系统技能会保留。
  3. 按需点击选择备份目录设置备份,确认后点击确认一键卸载;未选择备份目录时,按提示再次确认。如不执行,点击取消或关闭弹窗。

技能清理-05-确认一键卸载

查看清理结果

清理结束后,核对成功、已跳过和失败数量。存在跳过或失败项时,应检查这些技能是否仍保留在已安装列表中,结合页面提示处理后再决定是否重试。

已设置备份时,可点击打开备份文件夹检查备份内容。点击完成返回技能列表,确认清理结果。

技能清理-06-清理结果

扩展

管理插件

插件用于为 AI 任务接入额外能力。通过扩展页面,可进入插件列表,查找所需插件并完成连接或授权。

操作路径: 左侧发现→扩展→插件。

  1. 点击左侧发现,选择扩展,进入扩展管理页面。
  2. 点击插件页签,查看可用插件。扩展页面按MCP``插件``CLI分别管理不同类型的能力,请根据需要切换到对应页签。
  3. 在搜索扩展…输入框中输入关键词,查找目标插件;需要更新列表时,点击刷新。
  4. 阅读目标插件的功能说明,确认符合任务需要后,点击连接,并按页面提示完成所需授权或企业环境配置。

扩展管理-V1.4-01-功能入口

使用浏览器、电脑控制或外部发送类插件执行操作时,应留意授权和确认提示。

如需接入或管理 MCP 服务,请切换到MCP,具体操作见 7.2 MCP 管理。

MCP 管理

MCP连接

MCP 用于接入外部工具和服务。通过 MCP 管理页面,可查找已配置的服务、查看连接方式与状态,并添加新的 MCP 服务。

操作路径: 左侧发现→扩展→MCP。
使用前提: 添加或连接服务前,已取得相应连接信息和使用授权。

  1. 点击左侧发现,选择扩展,切换到MCP页签。
  2. 查看目标服务的连接方式、登录方式和连接状态。连接方式与登录方式可帮助确认服务的接入配置,例如远程 URL 和 OAuth 登录;具体信息以该服务的配置为准。
  3. 若服务状态为异常,应先检查连接配置、授权情况及服务可用性,不能仅凭服务已出现在列表中判断连接成功。需要重新获取列表和状态时,点击刷新。
  4. 如需接入新服务,点击右上角添加MCP,按 7.2.2 MCP添加 完成配置。

MCP连接-V1.4-01-服务管理

连接服务前,应确认服务来源、允许访问的数据范围及凭据保存方式,并了解服务可执行的操作和断开连接后的影响。

MCP添加

DeepWorks 支持接入自定义 MCP(Model Context Protocol)服务。用户可以通过表单配置或JSON 配置两种方式添加 MCP,并根据服务类型连接远程 MCP 服务或本地 MCP 服务。

点击添加MCP

进入 MCP 管理页面,点击添加 MCP,打开 MCP 配置窗口。 Pasted image 20261023152921

系统提供两种添加方式:

  • 表单:通过可视化表单填写 MCP 配置信息,适合常规 MCP 服务接入。

  • JSON:直接粘贴 MCP JSON 配置,适合已有配置文件或需要批量填写参数的场景。

通过表单添加 MCP

在添加方式中选择表单,根据 MCP 服务的实际情况填写配置信息。 Pasted image 20260813170116

基本信息
配置项说明
MCP 名称MCP 在 DeepWorks 中显示的名称,用于后续识别和管理。
描述简要说明该 MCP 的能力或适用场景,建议填写便于用户理解的用途描述。
类型支持**远程(URL)和本地(命令)**两种连接方式。
远程 MCP

选择**远程(URL)**后,在服务器 URL中填写 MCP 服务提供的访问地址,例如:

https://api.example.com/mcp/

如果该 MCP 服务需要通过浏览器完成账号授权,可勾选添加后自动打开登录。

  • 勾选后:MCP 添加完成后,系统会自动进入登录或授权流程。

  • 不勾选:系统先保存 MCP 配置,之后可进入 MCP 详情页手动完成登录。

填写完成后,点击添加 MCP保存配置。

本地 MCP

选择**本地(命令)**后,根据页面提示配置 MCP 服务的本地启动命令及相关参数。

本地 MCP 通常适用于需要在当前设备上运行的 MCP Server。配置完成后,点击添加 MCP保存。

通过 JSON 添加 MCP

如果已经从 MCP 服务提供方、开源项目或其他客户端获得 MCP 配置,可以使用 JSON 方式快速添加。

在添加方式中选择JSON,将 MCP 配置粘贴至MCP JSON输入区域。 Pasted image 20260813170302

DeepWorks 支持以下几种常见 JSON 配置形式:

  • mcpServers 配置对象;

  • mcp 配置对象;

  • 单个 MCP Server 配置对象。

例如:

{ "mcpServers": { "demo": { "url": "https://example.com/mcp/sse", "headers": { "Authorization": "Bearer token" }, "transportType": "sse" } } }

填写 JSON 后:

  1. MCP 名称可手动填写;留空时,系统可根据 JSON 配置推断名称。

  2. 可补充描述,说明该 MCP 的主要能力和使用场景。

  3. 检查 JSON 格式及服务器配置是否正确。

  4. 点击添加 MCP完成添加。

对于已经在 JSON 中配置 headers 等认证信息的 MCP,系统将按照配置保存认证参数,无需再次通过浏览器完成登录。

添加完成

MCP 添加成功后,将出现在 MCP 列表中。用户可进入 MCP 详情查看连接状态、配置信息及可用能力。

Pasted image 20261023153033

对于需要账号授权但添加时未完成登录的 MCP,可进入详情页继续完成登录或授权。

MCP 正常连接后,其提供的工具和能力即可供 DeepWorks 在相应场景中调用。

注意事项
  • MCP Server 地址、启动命令及认证信息应以 MCP 服务提供方提供的配置为准。

  • 使用 JSON 添加时,请确保 JSON 格式完整、字段名称正确。

  • headers 中可能包含 Token、API Key 等敏感认证信息,请妥善保管,避免将配置提供给无关人员。

  • MCP 无法正常连接时,可优先检查服务器地址、本地启动命令、网络环境及认证状态。

CLI 管理

操作路径: 左侧发现→扩展→CLI。

CLI(命令行工具)用于连接外部平台,让 DeepWorks 根据用户的自然语言任务调用相应服务。用户可在 CLI 页面查找工具、了解用途并检查安装和连接状态,完成所需配置后,在会话中提出任务。

查看和搜索 CLI 工具

  1. 点击左侧发现,选择扩展,切换到CLI页签。
  2. 展开CLI 工具分组,根据工具名称和功能说明选择适合任务的工具;也可在右上角搜索扩展…中输入关键词,查找目标工具。
  3. 查看工具状态,判断是否需要安装或连接。点击目标工具列表项,可打开详情,按提示完成所需配置。
  4. 完成安装或连接后,点击刷新,重新获取工具信息和当前状态。

CLI-V1.4-01-工具管理

按任务选择工具

工具名称主要用途
FastData CLI通过 @fastdata 使用 FastData CLI 与 Agent Kit。
DeepSense CLI从 MES 获取故障单,或结合引用的知识库和故障描述进行诊断。
CAXA MES通过 @deepsense 连接数码大方 MES,完成告警查询、诊断与建单。
FastAGI CLI通过 @fastagi 管理项目空间、知识库、工作流和智能体。
钉钉 CLI处理钉钉消息、日程和审批,连接后按任务需要使用。
飞书 CLI处理飞书消息、文档、日历和多维表格。

可用工具以当前环境提供的列表为准。

根据状态完成准备

状态含义与后续操作
已就绪工具已准备就绪,可按其使用说明在会话中发起任务;实际操作范围取决于账号权限。
未安装需要先完成工具安装,再按要求配置和授权。
未连接尚未完成服务连接,应进入工具详情检查连接或授权配置。

不同工具的安装和连接步骤以各自详情页面为准。FastData CLI 的安装可由会话引导完成;飞书 CLI 的安装与授权流程见下文。

飞书 CLI

安装和配置飞书 CLI

以下以飞书 CLI 为例说明安装与授权流程。其他工具的配置项以各自详情页面为准。

  1. 在 CLI 列表中找到飞书 CLI,点击安装,进入详情弹窗。
  2. 阅读工具说明和请确认飞书数据访问范围提示。授权后,Agent 可按你的指令访问消息、文档、日历、邮箱等飞书数据,并以你的身份执行操作;发送、修改或删除内容前仍需遵循 DeepWorks 的确认要求。
  3. 如需配置飞书开放平台应用,在“飞书应用配置(可选)”中填写 App ID 和App Secret。可点击打开飞书开放平台获取或查看应用信息。该区域为可选配置,按实际应用接入需要填写。
  4. 点击弹窗底部一键安装,启动 CLI、Skill 的安装或复用,并按提示完成应用配置与飞书用户授权。

CLI-02-飞书应用配置

飞书 CLI 会复用或安装当前用户的官方 lark-cli、全局 Skill 和登录状态。App ID、App Secret 仅在本次安装请求中传入主进程,不写入界面日志;请勿将 App Secret 粘贴到普通会话中。

安装过程中,弹窗底部显示当前进度,例如正在下载 CLI 资源...。一键安装等相关按钮会进入加载或不可点击状态,等待当前步骤完成即可。

CLI-03-安装进度

完成飞书用户授权

安装流程打开飞书官方授权页面后,按以下步骤操作:

  1. 确认授权应用和当前登录账号。
  2. 阅读申请的权限列表。页面提示,授权后应用将以你的名义访问和操作相关数据。
  3. 如需一并开通页面列出的免审权限,勾选对应选项;需要调整时,点击修改查看和调整授权范围。
  4. 确认后点击开通并授权。

CLI-04-飞书授权页面

  1. 页面显示开通并授权成功后,返回 DeepWorks 查看最终状态。

CLI-05-授权成功

飞书授权页面提供应用授权管理入口,可用于查看和撤销授权。实际可调用的能力取决于已授予的权限和当前账号的数据访问范围。

查看安装和授权结果

在飞书 CLI 详情中向下滚动,可查看当前用户全局状态。

状态项说明
当前版本、最低兼容版本查看已检测到的 CLI 版本及兼容要求;未检测到当前版本时可显示–。
安装来源查看 CLI 的安装来源,例如npm 全局包;未安装时显示未安装。
版本兼容性查看当前版本是否兼容。
PATH 状态查看 DeepWorks 是否能找到 CLI 命令,例如DeepWorks 已为当前会话补全。
CLI 状态查看 CLI 程序是否已安装。
Skill 状态查看配套 Skill 是否已安装。
授权状态查看当前用户是否已完成授权。
凭据存储查看凭据保存方式,例如系统安全存储。
当前用户授权后显示当前使用的账号,便于确认身份。
安装路径、配置目录、Skills 目录查看 CLI 程序、配置和技能在当前设备上的位置。

安装和授权全部完成后,弹窗显示“飞书 CLI、Skill 和授权已全部完成。”,CLI 状态和 Skill 状态均为已安装,授权状态为已授权,底部操作切换为一键卸载和关闭。

CLI-06-安装授权完成

macOS 默认优先使用系统钥匙串保存凭据。仅当检测到凭据无法读取时,DeepWorks 才会自动执行飞书官方本地主密钥降级并重新验证。

浏览器显示授权成功后,还应返回 DeepWorks 确认 CLI、Skill 和授权均已完成;仅 CLI 安装成功并不表示全部配置已就绪。

在会话中使用 CLI

完成安装和授权后,在工作区中新建或打开对话,直接输入任务要求,无需手动编写命令行指令。

例如:

帮我在飞书上新建一个测试文档。

DeepWorks 会根据任务加载相关 Skill,调用 CLI 执行操作,并在会话中展示处理过程和结果。涉及发送、修改或删除内容时,按会话提示确认相关操作;任务信息不足时,补充必要参数后继续。

CLI-07-会话使用示例

在上述示例中,创建完成后会返回文档标题、文档链接、文档 ID 和内容摘要。点击文档链接,即可前往飞书查看和编辑。

也可以直接提出查看我今天的飞书日程``查询需求管理多维表格中的待办项等任务。可执行范围取决于对应 CLI、Skill 和账号权限。若提示尚未安装或授权未完成,可返回我的AI同事→扩展→CLI,进入对应工具详情完成配置后继续任务。

卸载飞书CLI

不再需要飞书 CLI 时,打开其详情弹窗,点击底部一键卸载,按页面提示完成操作,然后刷新检查状态。该入口用于卸载,请先确认其他任务是否仍需使用当前用户的 CLI 和全局 Skill;需要撤销飞书应用授权时,可通过飞书应用授权管理处理。

钉钉 CLI

安装钉钉 CLI

操作路径: 左侧我的AI同事→扩展→CLI→钉钉 CLI。

使用前提: 企业管理员已为所在钉钉组织开通 CLI 权限,当前用户可登录并授权相应组织。

钉钉 CLI 会复用或安装当前用户的官方 dws CLI、全局 Skills 和登录状态。完成安装与授权后,DeepWorks 可查询当前用户、组织与工作区信息,并在授权范围内调用知识库、日历、联系人、群聊、任务和审批等钉钉能力。涉及企业权限、成员信息或写入动作时,仍需遵循钉钉授权和确认要求。

  1. 进入 CLI 工具列表,找到钉钉 CLI,点击右侧安装。

钉钉CLI-01-安装入口

  1. 在详情弹窗中阅读设置和启用的能力,确认安装内容与授权要求。
  2. 查看扩展清单中的资源。
  3. 点击底部一键安装,按提示安装官方 dws CLI 与 Skills,随后完成钉钉登录和组织授权。

钉钉CLI-02-安装详情

安装前,详情区域的状态显示为未安装,可见性显示为已显示。可见性仅表示扩展是否显示,不代表已经安装或授权。

登录并授权钉钉组织
  1. 安装流程打开钉钉登录页面后,确认页面显示的账号。若页面提示“此账号已在使用,可直接登录 DingTalk-Workspace”,点击立即登录;尚未登录时,按页面提示完成登录。

钉钉CLI-03-账号登录

  1. 按钉钉页面提示完成相应组织的授权。若提示未开通 CLI 权限,应联系企业管理员开通后再继续。
  2. 页面显示授权成功,并提示“请返回终端继续操作。此页面可以关闭。”后,可关闭该授权页面,返回发起安装的 DeepWorks 窗口继续查看结果。

钉钉CLI-04-授权成功

  1. 返回钉钉 CLI 详情,确认安装结果;如果状态尚未更新,可返回 CLI 列表点击刷新,再打开详情查看。
查看钉钉 CLI 状态

安装完成后,钉钉 CLI 图标显示绿色完成标记,详情中的状态变为绿色已安装,底部按钮切换为一键卸载和关闭。

钉钉CLI-05-安装完成

详情弹窗提供以下信息:

页面区域说明
设置说明安装官方 dws CLI、Skills 及授权钉钉组织的要求,并提示需要企业管理员开通 CLI 权限。
扩展清单展示 CLI、配套 Skills 等资源及扩展贡献项,用于了解扩展包含的内容。
详情展示安装状态和可见性。
启用的能力说明可查询的信息、授权范围及相关操作要求。
底部操作未安装时提供一键安装,安装后提供一键卸载;点击关闭或右上角关闭图标退出详情。

已安装表示安装状态,实际业务访问还取决于账号登录、组织授权及相应数据权限。完成授权后,可通过下述查询任务检查实际使用情况。

在会话中使用钉钉 CLI

完成安装和组织授权后,在工作区中新建或打开对话,直接用自然语言描述钉钉任务,无需手动输入 CLI 命令。

以查询知识库为例:

  1. 在输入框中输入任务并发送:

    帮我查下我的钉钉上有哪些知识库。

  2. DeepWorks 根据任务加载钉钉知识库相关技能,调用 CLI 查询当前账号可访问的知识库。

  3. 在会话中查看查询结果。

钉钉CLI-06-知识库查询示例

还可根据需要输入以下任务:

  • “查看我今天的钉钉日程。”
  • “帮我查找数据平台项目群。”
  • “查看我当前待处理的审批。”
  • “给项目群发送一条进度提醒。”

涉及发送消息等写操作时,应按会话提示确认目标、内容等关键参数;存在同名群或目标不明确时,先补充信息再继续。若任务提示尚未登录或缺少权限,按提示完成登录、授权或联系管理员处理后继续。

卸载钉钉 CLI

不再需要钉钉 CLI 时,进入其详情弹窗,点击一键卸载,按页面提示完成操作,再刷新查看状态。卸载前应确认正在执行的任务是否仍依赖该 CLI 或全局 Skills,具体卸载范围以操作提示为准。

FastData Agent Kit

进入 FastData Agent Kit 安装引导

操作路径: 左侧我的AI同事→扩展→CLI→FastData Agent Kit→安装。

FastData Agent Kit 通过 @fastdata 在 DeepWorks 会话中提供 FastData CLI 与配套技能能力,支持数据查询、任务运行分析、元数据发现、数据治理、建模与 SQL 等工作。安装和登录由会话中的 FastData 官方动态指令引导完成。

  1. 进入 CLI 列表,找到FastData Agent Kit,点击右侧带会话图标的安装按钮,跳转到引导会话。

FastData-01-安装入口

也可先点击工具列表项查看详情,再点击弹窗底部安装进入会话。

FastData-02-扩展详情

  1. 跳转后,输入框中显示 @fastdata。确认当前工作区,在其后补充安装,然后发送。

FastData-03-跳转引导会话

例如:

@fastdata 安装

发送请求后,按会话提示完成确认和安装。

在会话中确认并完成安装

收到安装请求后,DeepWorks 会检查当前用户环境,并在会话中说明检测结果、官方安装来源和安装计划。

支持从 FastData Agent Kit 官方 stable 发布通道获取安装资源,校验安装包后安装用户级 CLI 与 Skills。若检测到旧环境,会提示可能需要处理旧版本;清理运行上下文可能导致登录状态丢失,需要重新进行 Agent Login。

  1. 阅读会话展示的安装计划。
  2. 在确认安装卡片中选择确认安装(推荐)并提交回答,继续执行;选择取消则暂不执行安装。也可在或输入自定义回答中补充要求。
  3. 如发现旧环境,先查看会话展示的清理范围和影响,再按提示处理。

FastData-04-会话确认安装

  1. 等待安装及可用性校验完成,在会话中查看最终结果。

FastData-05-安装结果

安装成功后,会话会返回 FastData Agent Kit 的版本、CLI 位置、PATH 更新情况和当前登录状态。 按安装结果提示,重新启动 DeepWorks 或新建会话,让系统重新加载 FastData Agent Kit Skills,随后可继续通过 @fastdata 发起任务。

查看安装状态与完成登录

返回我的AI同事→扩展→CLI,必要时点击刷新。安装完成后,FastData Agent Kit 列表项显示已安装。

FastData-06-列表已安装

已安装表示 CLI 与相关组件的安装状态。若会话结果显示尚未登录,首次业务操作时会引导完成登录授权,按会话提示继续即可。需要查看账号状态时,可打开 FastData Agent Kit 详情,查看当前登录用户区域并点击刷新图标更新信息。

安装完成后仍未加载相关能力时,可按安装结果提示新建会话或重启 DeepWorks;如果登录状态因旧环境清理而失效,应重新完成登录。

使用 FastData Agent Kit

在会话中输入 @fastdata 并发送,可查看 FastData 能力概览;也可在其后直接描述具体任务。系统会根据任务加载相关技能,并在当前账号授权范围内处理。

FastData-07-能力概览

FastData Kit的能力概览涵盖以下查询、分析和方案生成场景:

能力功能说明
数据源与项目查询数据源、授权范围、项目与流程。
任务运行查看实例、失败任务、运行历史与趋势。
元数据发现搜索库表、字段、结构及候选数据。
数据治理查询血缘、上下游影响和异常根因。
数据资产盘点物理表、逻辑实体和目录关系。
数据质量分析质量现状并设计监控方案。
数据建模与 SQL生成模型草案、SQL 或数仓规划。
故障诊断联合分析任务、Spark/YARN 和采集链路。
产品问答解答 FastData 功能、配置和操作问题。

例如:

  • “@fastdata 查询最近失败的任务。”
  • “@fastdata 查找订单相关表。”
  • “@fastdata 查看订单表的字段和数据类型。”

可在任务中补充项目、数据源、表名或时间范围,帮助系统定位目标。会话需要补充信息时,按提示继续回答;涉及业务数据访问时,先完成所需登录授权。

自动化

自动化用于将重复性工作设置为按计划执行的任务,例如每日新闻整理、工作简报、每周复盘和会议提醒。创建任务时,可以配置任务内容、工具、审批策略、工作区、模型和执行时间;创建后可集中查看运行情况,或随时立即运行、暂停、编辑和删除任务。

进入自动化页面

操作路径: 左侧导航→自动化。

点击左侧自动化,进入自动化任务页面。页面右上角提供查看模板和创建任务,下方显示筛选栏和任务卡片。

自动化-01-任务列表

每张任务卡片展示任务名称、任务描述、运行计划、启停状态和最近执行结果。已启用且存在后续计划的任务还会显示下次执行时间。

卡片右侧从左到右提供以下操作:

操作说明
启用/暂停开关蓝色表示已启用,灰色表示已暂停,点击切换后续计划的启停状态。
三角形运行图标立即运行一次任务。
铅笔图标编辑任务配置。
红色删除图标删除任务,停止后续计划。

点击卡片的名称、描述等非按钮区域,可打开右侧自动化任务详情面板。

从模板创建任务

操作路径: 自动化→查看模板→选择模板。

  1. 点击右上角查看模板,打开自动化模板窗口。
  2. 根据需要选择模板,例如每日工作简报``每日重要新闻推送``每周工作复盘或项目会议提醒。模板卡片显示任务名称、描述和计划时间摘要。

自动化-02-模板选择

  1. 点击模板后,进入创建自动化任务窗口,系统回填任务名称、描述、调度方式和执行时间。
  2. 检查并调整回填内容,选择实际使用的工作区、模型、工具和审批策略。每周、每月或一次性任务还需核对具体执行日期。
  3. 点击完成创建保存任务。

选择模板仅填写表单,不会直接创建或运行任务。模板中的时间和描述均可修改;涉及日历、消息或其他外部数据时,还需要配置可访问这些数据的工具及授权。

自定义创建任务

操作路径: 自动化→创建任务。

使用前提: 已有可访问的工作区和可用模型;任务所需的技能、扩展或 MCP 已安装、连接并完成相应授权。

填写任务名称和描述

点击创建任务,打开创建自动化任务窗口。也可从模板进入同一窗口后修改内容。

自动化-03-创建任务

配置项填写说明
任务名称必填,最多 50 个字符。使用便于识别的名称,例如每日工作简报。
任务描述必填,最多 5000 个字符。说明每次运行需要完成的事项、数据来源和输出要求。
工作区选择任务执行所使用的工作区,确认相关目录和材料可访问。
模型可选择沿用工作区默认模型,或在下拉列表中选择可用模型。

任务描述会在每次运行时作为执行指令,建议写清楚处理范围和结果保存位置,避免只写按上次要求处理等不明确的表述。例如:

读取当前工作区中的项目进度和待办清单,整理当天需要推进的事项、临近截止日期的任务及风险,按优先级生成工作简报,并保存到工作区每日简报目录,文件名包含当天日期。

选择工具

在任务描述区域底部点击选择工具,打开工具选择菜单。

自动化-04-选择工具

  1. 在左侧选择命令``技能``扩展或MCP。
  2. 在右侧查看可用项目,也可通过搜索当前列表查找需要的能力。
  3. 选择任务需要使用的项目,通过底部已选数量核对选择结果;需要重新选择时,可点击清空。
  4. 完成选择后返回创建窗口,继续配置其他内容。

工具应与任务描述相匹配。例如,汇总外部日历和消息前,应先连接对应服务并完成授权;未找到所需能力时,可先到我的AI同事中安装或配置,再返回创建任务。

设置审批策略

点击选择工具右侧显示当前审批策略的按钮,选择任务运行时如何处理权限请求,创建时应检查并按任务需要选择。

自动化-05-审批策略

审批策略说明
每次询问每个需要确认的操作都会弹窗询问。
自动批准常规操作安全且由用户明确指定的操作会自动放行,仅高影响操作需要询问。
完全放开除被平台硬性阻止的操作外,全部自动放行。

自动化按计划触发并不代表所有步骤都无需人工参与。任务遇到需要确认的操作时,应及时处理权限请求;完全放开也不会解除平台的硬性限制和数据访问边界。

配置调度方式

调度方式提供周期性和一次性两种选择。

每天执行

选择周期性,在计划时间中选择每天,再设置执行时刻。例如每天 08:30表示每天在该时间运行一次。

每周执行

  1. 选择周期性,将频率切换为每周。
  2. 点击星期选择框,选择需要执行的星期,支持多选,至少选择一天。
  3. 设置执行时刻。蓝色表示该星期已选中,再次点击可取消选择。

自动化-06-每周计划

例如,选择周一至周五并设置为 08:30,表示每周一至周五的 08:30 各执行一次。该设置按星期执行,不会自动排除落在周一至周五的法定节假日。

每月执行

  1. 选择周期性,将频率切换为每月。
  2. 点击日期选择框,在 1~31 日中选择执行日期,或选择最后一天;需要多个日期时可多选。
  3. 设置执行时刻。

自动化-12-每月日期选择

日期选择面板中的蓝色数字表示已选日期,选择框会显示日期摘要。最后一天按每个月实际的最后一天执行,适合月末总结等任务。

例如,选择1 日并设置为 08:30,表示每月 1 日的 08:30 执行。需要在月末执行时,可选择最后一天。如果选择固定日期,而当月不存在该日期,则当月跳过该日期,不提前或顺延执行。

自定义 Cron

需要通过表达式设置周期计划时,可选择自定义 Cron。

  1. 在调度方式中选择周期性。
  2. 在计划时间左侧下拉框中选择自定义 Cron。
  3. 在右侧输入 Cron 表达式。此时不再单独显示执行时刻输入框,执行时间由表达式确定。

自动化-13-自定义Cron

Cron 使用五段格式,各段以空格分隔,依次为:分钟 小时 日期 月份 星期,不填写秒字段。例如,界面中的示例 0 9 * * 1-5 表示每周一至周五的 09:00 执行。

表达式执行计划
0 9 * * *每天 09:00 执行。
0 9 * * 1-5每周一至周五 09:00 执行,不自动排除法定节假日。
30 17 * * 5每周五 17:30 执行。
0 9 1 * *每月 1 日 09:00 执行。

其中,* 表示该字段不作限制,1-5 在星期字段中表示周一至周五。填写后点击完成创建;如提示表达式无效或无法计算下一次执行时间,应修正后再提交。创建成功后,在任务列表中核对下次执行时间。

一次性执行

适合会议提醒、临时资料整理等只需按计划执行一次的事项。

  1. 在调度方式中点击一次性。
  2. 在计划时间左侧日期框中输入执行日期,或点击日历图标选择日期。
  3. 在右侧时间框中设置执行时刻,例如 09:00,可通过时钟图标选择时间。
  4. 核对日期和时刻,点击完成创建。

自动化-14-一次性日期与时间

日期和时间组合后必须晚于当前时间;仅设置时间、未填写日期时不能完成创建。创建前应再次核对,避免使用模板中的过期日期。一次性计划结束后不会自动重复执行。

完成创建

  1. 核对任务名称、描述、工具、审批策略、工作区和模型。
  2. 核对调度方式、执行日期和时刻;选择自定义 Cron时,核对表达式对应的执行计划。
  3. 点击完成创建。如页面提示必填项缺失、时间无效或配置不可用,按提示修正后再次提交。
  4. 创建成功后,返回任务列表,确认新任务显示为已启用,并检查下次执行时间。

创建任务本身不会立即执行;如需测试,可点击任务卡片右侧的三角形运行图标。点击取消或右上角关闭按钮可退出创建,尚未保存的配置不会成为自动化任务;如出现未保存提示,按提示选择是否放弃修改。

筛选任务

点击列表上方的筛选项,可快速查找不同状态或类型的任务。

筛选项说明
全部查看所有任务。
已启用查看已开启计划调度的任务,包括已启用的一次性任务。
已暂停查看已经暂停后续计划的任务。
一次性任务查看调度方式为一次性的任务。

已启用: 卡片开关为蓝色,并显示后续计划的下次执行时间。

自动化-08-已启用任务

已暂停: 卡片开关为灰色,仍可查看最近一次执行结果。

自动化-09-已暂停任务

一次性任务: 集中查看只执行一次的计划,例如项目会议提醒。

自动化-10-一次性任务

筛选只影响当前显示范围,不会修改任务的配置或启停状态。

启用和暂停任务

操作路径: 目标任务卡片→右侧启用/暂停开关。

  • 暂停任务: 点击蓝色开关,成功后显示灰色开关和已暂停。后续计划不再触发,任务配置和历史记录保留;已经开始的运行会继续完成。
  • 启用任务: 点击灰色开关,成功后显示蓝色开关和已启用,并重新计算下次执行时间。暂停期间的计划不会补执行。

已启用/已暂停表示是否继续按计划运行,执行成功/执行失败表示最近一次运行结果,两者相互独立。例如,任务可以同时显示已暂停和执行成功,表示任务此前运行成功,目前已暂停后续计划。

如果启用失败,应检查计划时间、工作区、模型和工具授权。一次性计划结束后不会再次自动执行;需要重新安排时,应编辑为新的未来时间并启用。

立即运行任务

操作路径: 目标任务卡片→运行图标。

  1. 找到需要测试或临时执行的任务,点击三角形运行图标。
  2. 系统按任务当前配置执行一次。
  3. 点击任务卡片打开详情,查看本次执行状态和结果。

立即运行会额外执行一次,不改变原运行计划、下次执行时间或启停状态。已暂停的任务也可立即运行,运行后仍保持暂停。

同一任务正在执行时,不能再次立即运行,应等待当前运行结束后再操作。

编辑任务

操作路径: 目标任务卡片→铅笔图标。

  1. 点击编辑按钮,打开编辑自动化任务窗口。
  2. 根据需要修改任务名称、描述、工具、审批策略、工作区、模型或计划时间。
  3. 点击保存修改。
  4. 返回列表,核对更新后的任务内容和下次执行时间。

修改后的配置从下一次运行生效,不会改写历史执行记录。任务正在运行时保存修改,当前运行仍使用开始时的配置。修改调度计划后,旧的未触发计划会被取消,系统按新计划重新计算下次执行时间。

查看任务详情和执行结果

查看执行记录

操作路径: 点击任务卡片的非按钮区域→自动化任务详情。

自动化-11-任务详情与执行记录

详情面板包含任务名称、启停状态、运行计划、工作区、模型、完整任务描述,以及任务执行记录和记录数量。

执行记录按时间倒序展示,便于查看最近的运行情况。每条记录可包含执行状态、时间、结果摘要和耗时:

  • 执行成功: 以绿色标识显示,表示该次任务已完成。
  • 执行失败: 以红色标识显示,可通过结果摘要了解失败原因,例如需要检查工作区和运行环境。
  • 执行中: 表示任务尚未结束,等待执行完成后再查看最终结果。

查看完整结果

操作路径: 左侧我的工作区→任务所选工作区→对应任务会话。

  1. 根据任务详情中的工作区信息,在左侧展开对应工作区。
  2. 在会话列表中点击对应任务名称。
  3. 在中央会话区查看任务指令和 AI 生成的完整结果。
  4. 会话较长时,可滚动阅读,或点击跳到最新定位最新内容。结果上方的已处理·用时显示本次处理情况和耗时。

自动化-15-会话执行结果

如果工作区中出现多个同名会话,可结合列表旁的时间提示和会话中的任务内容,核对所查看的记录。任务详情中的执行记录用于查看状态和摘要,会话中可阅读完整输出;如任务生成了文件,还可按任务描述中的保存位置查找交付物。

任务首次运行时会创建同名会话,后续运行继续复用该会话,每次运行仍单独保存执行记录。关联会话被删除后,会在下一次实际运行时重新创建;旧执行记录仍保留原会话关联。

删除任务

操作路径: 目标任务卡片→删除按钮。

  1. 点击删除按钮。
  2. 在确认提示中核对任务名称和删除影响。
  3. 确认删除后,任务从列表移除,后续计划停止;如需保留任务,取消删除即可。

删除自动化任务不会删除已经生成的工作区会话和结果;已开始的运行仍会继续结束。如果只是暂时停用,使用暂停开关即可,无需删除配置。

IM 频道

IM 频道用于连接钉钉、飞书等即时通讯平台,让 DeepWorks 接收你与平台机器人的新消息。你可以连接平台账号,创建或接入机器人,也可以查看企业机器人并联系创建人申请使用权限。

页面分为频道连接和机器人两个页签:前者用于连接或解绑平台账号,后者用于添加、配置和管理机器人。

进入 IM 频道

操作路径: 点击左下角用户头像,打开用户菜单,选择IM频道。

  1. 进入IM频道页面。
  2. 查看右上角工作区,通过下拉框选择需要使用的工作区。
  3. 根据操作需要,切换到频道连接或机器人页签。

IM频道-V1.4-01-频道连接

连接与解绑频道

查看频道连接状态

在频道连接页签中,分别查看飞书、钉钉的平台卡片。

状态页面显示可执行操作
未连接显示连接说明和连接按钮点击连接,按弹窗提示完成连接
已连接显示已连接和脱敏后的绑定手机号核对绑定手机号,或点击解绑解除连接

频道连接用于绑定平台账号;机器人需要在机器人页签中单独添加或查看。使用机器人时,还需具有对应机器人的使用权限。

连接频道

  1. 在频道连接页签中,点击频道卡片右侧的连接。
  2. 在弹窗中,核对手机号,确保这是你在钉钉中使用的手机号。
  3. 点击确认完成连接;如需放弃,点击取消或右上角关闭图标。
  4. 返回频道列表,检查卡片是否显示已连接,并核对绑定手机号。

IM频道-V1.4-03-连接钉钉

连接后,DeepWorks 可接收你与钉钉或飞书机器人的新消息。接下来可进入机器人页签,添加自己的机器人或查看可使用的企业机器人。

解绑频道

  1. 在已连接的频道卡片右侧点击解绑。
  2. 在二次确认弹窗中,核对待解绑的手机号,并阅读解绑影响。
  3. 点击确认解绑解除连接;如需保留连接,点击取消。

IM频道-V1.4-02-解绑频道

解绑后,将停止接收该频道的机器人新消息。恢复使用时,需要重新绑定手机号。

解绑会保留历史对话,不影响 DeepWorks 登录手机号、其他频道绑定及已启动的任务。

查看机器人

进入机器人页签,可查看我的机器人和企业机器人两个列表。

IM频道-V1.4-04-机器人管理

我的机器人

我的机器人用于管理你在 DeepWorks 中创建或接入的机器人。

项目说明
机器人名称显示机器人名称及平台图标
平台显示所属平台,可通过列标题旁的筛选图标筛选
ID显示机器人应用标识,点击右侧复制图标可复制
启用机器人通过开关调整机器人的启用状态
配置打开配置弹窗,修改机器人名称、应用凭据和启用状态
移除移除对应机器人的入口

点击右上角添加机器人,可选择飞书或钉钉。列表底部显示总条数,并提供翻页按钮。

企业机器人

企业机器人用于查看企业内的机器人。列表展示机器人名称、所属平台、ID、创建人及状态。

  1. 在列表中找到需要使用的机器人,可通过平台列旁的筛选图标筛选平台。
  2. 查看机器人状态和创建人信息;需要复制应用标识时,点击 ID 右侧的复制图标。
  3. 在对应平台中使用该机器人。如没有使用权限,可联系创建人申请。

添加机器人

在IM频道中连接平台账号后,可使用自己或他人已接入的机器人。如需接入自己的机器人,可在机器人页签中添加;如需使用企业已有机器人,可在企业机器人列表中查看,并联系创建人申请所需权限。

进入添加页面

  1. 确认IM频道右上角的工作区,并在频道连接页签中完成对应平台的账号连接。
  2. 切换到机器人页签,点击添加机器人。
  3. 选择钉钉或飞书,打开对应的创建弹窗。

IM频道-V1.4.5-05-我的机器人与企业机器人

选择接入方式

  • 手机扫码接入:点击创建弹窗顶部的一键扫码接入入口,使用对应平台的手机应用扫描当前页面生成的二维码,按提示完成创建或选择应用。返回 DeepWorks 后,核对自动填入的应用凭据和机器人名称。
  • 手动填写凭据:填写机器人名称、Client ID 和 Client Secret。钉钉对应 Client ID(AppKey)和 Client Secret(AppSecret);飞书对应 App ID 和 App Secret。

机器人名称应与平台中的实际名称保持一致。扫码接入同样需要满足对应平台的账号权限、应用权限和发布要求。具体步骤见下方 9.5 钉钉接入配置指引和9.6 飞书接入配置指引。

创建并启用

  1. 核对信息,按需设置启用机器人开关,点击创建。
  2. 返回我的机器人列表,确认机器人已添加;需要使用时,确保其处于启用状态。
  3. 在对应平台中打开机器人会话,发送消息并检查回复。

如需放弃添加,点击取消或关闭弹窗。后续配置修改、启停和移除操作见 9.7 管理我的机器人。

钉钉接入配置指引

本指南将帮助您在钉钉中配置 DeepWorks 机器人,让您可以通过钉钉随时随地远程操控电脑上的 DeepWorks 完成编程任务。

前提条件

在开始之前,请确保您已满足以下条件:

  • 已在电脑上安装 DeepWorks,并开启了 IM频道 远程控制功能
  • 拥有一个具有企业管理员权限的钉钉账号

如果您还没有钉钉账号,请前往 钉钉官网  下载客户端并创建团队。

创建钉钉应用

登录开发者后台

打开浏览器,访问 钉钉开发者后台 ,使用管理员账号登录。

Pasted image 20261028162448

选择一个已加入的组织,如果系统提示该账号还未加入组织,您可以创建一个个人企业,按需填写信息即可。

Pasted image 20261028162538

创建应用
  1. 在开发者后台首页,进入钉钉开发,并点击创建应用

Pasted image 20261028163013

  1. 在弹出的创建窗口中,填写以下信息:
配置项说明
应用名称自定义名称
应用描述简单描述用途
应用类型可为空

Pasted image 20261028163055

  1. 填写完成后,点击保存
添加机器人能力

应用创建成功后,会自动跳转到添加应用能力页面:

  1. 找到机器人选项,点击添加机器人
  2. 填写机器人的基本信息,消息接收模式推荐使用Stream模式
  3. 点击确认发布

Pasted image 20261028163307

配置应用权限

为了让机器人能够正常收发消息,需要开通以下权限:

  1. 在应用详情页左侧菜单中,点击权限管理
  2. 在搜索框中分别搜索以下权限,并点击立即开通:
    • 企业员工手机号信息
    • 成员信息读权限
    • 企业内机器人发消息权限
    • 互动卡片实例写权限
    • AI卡片流式更新权限

Pasted image 20261028163502 Pasted image 20261028163513

发布应用

完成应用配置后,需要创建并发布版本,使配置正式生效。发布前,请确认应用可用范围包含需要使用机器人的人员。

创建版本

在应用详情页左侧菜单中,选择版本管理与发布,点击创建新版本。

Pasted image 20261028164159

填写版本信息与设置可用范围
  1. 填写应用版本号和版本描述,简要说明本次发布内容。
  2. 在应用可用范围中,按实际需要选择全部员工``部分员工``仅限管理员或仅我可见。如仅向指定人员开放,选择部分员工并设置对应人员。
  3. 确认使用人员在可用范围内后,点击保存。

Pasted image 20261028164215

确认发布
  1. 保存后,在版本详情页点击发布。
  2. 在确认弹窗中,点击确认发布。
  3. 返回版本管理与发布,检查该版本状态是否为已上线。

Pasted image 20261028164252

获取应用凭证

查看凭证信息
  1. 在应用详情页左侧菜单中,点击凭证与基础信息
  2. 在页面中找到以下两个重要信息:
    • Client ID(也叫 AppKey)
    • Client Secret(也叫 AppSecret)

请务必妥善保存该凭证信息,不要泄露给他人!

在 DeepWorks 中配置钉钉

支持通过手机扫码创建钉钉应用并接入,也可以手动填写已有应用的凭证。

接入前提: 两种方式均需具备钉钉企业管理员权限,并确保机器人所属应用已开通第 9.5.3 节配置应用权限中列出的全部权限。扫码接入不免除管理员权限和应用权限要求。

进入机器人配置
  1. 点击 DeepWorks 左下角用户头像,选择IM频道,确认需要配置的工作区。
  2. 在频道连接页签中完成钉钉账号连接,具体参见 IM频道。
  3. 切换到机器人页签,点击添加机器人→钉钉,打开创建钉钉机器人弹窗。

钉钉接入-V1.4.5-创建机器人

选择接入方式

方式一:手机扫码接入

  1. 点击一键创建钉钉应用扫码接入。
  2. 使用手机钉钉扫描 DeepWorks 当前页面生成的二维码,并使用具备企业管理员权限的账号,按手机页面提示确认创建。
  3. 完成后,系统会自动填入应用凭据。返回创建弹窗,检查凭据,并填写与实际机器人名称一致的机器人名称。
  4. 在钉钉开发者后台检查该应用的权限,确保第 9.5.3 节列出的权限均已开通,并按第 9.5.4 节完成所需的版本发布。

钉钉接入-V1.4.5-手机扫码接入

方式二:手动填写凭证

已在钉钉开发者后台创建应用的,可直接填写以下信息:

配置项填写说明
机器人名称与钉钉中实际机器人名称保持一致。
Client ID填写该应用的 Client ID(AppKey)。
Client Secret填写该应用的 Client Secret(AppSecret)。

应用凭证的获取方式见前文获取应用凭证。接入前,请确认已完成应用权限配置和版本发布。

创建并启用机器人
  1. 确认机器人名称和应用凭据填写完整,打开启用机器人开关,点击创建。
  2. 返回我的机器人列表,确认机器人已添加且处于启用状态。后续可通过配置修改信息,或通过启用机器人开关调整启用状态。
  3. 在钉钉中打开对应机器人会话,发送消息并检查是否收到回复。

连接钉钉账号后,也可直接使用自己或他人已接入的机器人,无需重复创建;如没有使用权限,可在企业机器人列表中查看创建人并联系申请。

开始使用

完成钉钉账号连接和机器人接入后,可通过群聊或单聊发送任务并接收回复。使用前,请确认机器人已启用、应用已发布,且使用人员在应用可用范围内;电脑需保持开机并运行 DeepWorks。

在群聊中使用

第一步:将机器人添加到群聊

  1. 在钉钉中打开需要使用机器人的群聊,确认群聊所属组织与机器人所属组织一致。
  2. 点击群聊右上角的设置图标,在群设置中找到机器人。
  3. 进入机器人管理页面,按提示添加已接入 DeepWorks 的机器人;如果机器人已在群内,可直接开始对话。

Pasted image 20261028170232

第二步:@机器人发送任务

在群聊输入框中输入 @ 并选择对应机器人,再输入问题或任务要求并发送。DeepWorks 处理后,机器人会将回复返回当前群聊。后续发送任务时,同样需 @ 对应机器人。

Pasted image 20261028170312

第三步:在 DeepWorks 中查看会话

如需查看对应任务的处理情况,可返回 DeepWorks,在所选工作区的会话列表中找到带钉钉图标的会话,点击后查看任务内容、处理状态及回复结果。

Pasted image 20261028170345

单聊使用

单聊适合直接向机器人发送个人任务,无需先将机器人添加到群聊,也无需 @ 机器人。

第一步:打开机器人会话

在钉钉顶部搜索框中输入机器人名称,选择对应机器人,进入单聊窗口。已有会话时,可直接从消息列表打开。

第二步:发送任务并查看回复

在输入框中描述问题或任务要求并发送,DeepWorks 处理后会将回复返回当前会话。如需补充要求,可在同一会话中继续发送消息。

钉钉机器人单聊发送任务与接收回复

第三步:查看任务处理过程

如需查看详细处理过程,返回 DeepWorks,在对应工作区中打开带钉钉图标的会话,查看任务内容、处理状态、回复过程及最终结果。

DeepWorks查看对应会话与处理过程

常见问题

使用机器人时,如收到以下提示,可按对应方法处理,完成后重新发送消息验证。

提示“权限尚未配置,无法与机器人互动”怎么办?

未配置机器人使用权限

请联系管理员检查应用可用范围,确保包含您的账号。管理员可在钉钉开发者后台进入对应应用的版本管理与发布,调整应用可用范围,保存并发布版本。具体步骤见第 9.5.4 节发布应用。

提示“无法读取渠道手机号,无法核验已有绑定”怎么办?

无法读取渠道手机号

请联系机器人管理员检查应用权限及通讯录可访问范围:

  1. 按第 9.5.3 节配置应用权限核对所需权限是否全部开通,重点检查企业员工手机号信息和成员信息读权限。
  2. 确认通讯录可访问范围包含您的账号,使应用能够读取您的手机号并核验绑定关系。
  3. 如配置变更需要发布,完成版本发布后,再重新发送消息验证。
提示“当前手机号尚未绑定 DeepWorks 渠道账号”怎么办?

尚未绑定频道账号

请在 DeepWorks 中连接钉钉账号:

  1. 点击左下角用户头像,选择IM频道,确认需要使用的工作区。
  2. 在频道连接页签中,点击钉钉卡片上的连接。
  3. 填写您在钉钉中实际使用的手机号,按提示完成连接。
  4. 确认卡片显示已连接后,返回钉钉重新发送消息。

如已连接,请核对绑定手机号是否与当前钉钉账号的手机号一致;如不一致,先解绑,再使用正确手机号重新连接。

飞书接入配置指引

本指南将帮助您在飞书中配置 DeepWorks 机器人,让您可以通过飞书随时随地远程操控电脑上的 DeepWorks 完成编程任务。

前提条件

在开始之前,请确保您已满足以下条件:

  • 已在电脑上安装 DeepWorks,并开启了 IM频道 远程控制功能
  • 如需创建企业机器人需拥有一个飞书企业账号(需要有创建应用的权限)。

创建飞书应用

登录开发者后台

打开浏览器,访问 飞书开放平台 ,使用企业账号登录后,点击创建企业自建应用。 这里使用的是具备收发消息能力的应用机器人。群聊中的仅 Webhook 通知机器人不能替代该接入方式。

Pasted image 20261028171428

填写应用信息

在弹出的创建窗口中,填写以下信息:

配置项说明
应用名称给应用起一个名字,如DeepWorks 助手
应用描述简单描述应用的功能
应用图标上传一个应用图标

Pasted image 20261028171454

填写完成后,点击创建按钮。

进入应用详情

应用创建成功后,会自动跳转到应用详情页面,点击添加应用能力,找到机器人卡片,点击添加按钮。

Pasted image 20261028171633

配置事件与回调

在应用详情页左侧菜单中,点击事件与回调,分别配置事件和回调的接收方式,并添加接收消息事件。

第一步:配置事件接收方式

  1. 进入事件配置页签,在订阅方式中选择使用长连接接收事件。
  2. 确认显示连接成功后,点击保存。

Pasted image 20261028174924

第二步:配置回调接收方式

  1. 切换到回调配置页签,在订阅方式中选择使用长连接接收回调。
  2. 验证连接状态,确认显示连接成功后,点击保存。

Pasted image 20261028175648

第三步:添加接收消息事件

  1. 返回事件配置页签,在已添加事件区域点击添加事件。
  2. 选择接收消息事件(im.message.receive_v1),完成添加。
  3. 确认事件已出现在列表中,并按第 9.6.3 节配置应用权限开通单聊消息及群内 @ 消息所需权限。

添加该事件后,应用可接收权限范围内的用户消息,包括发给机器人的单聊消息和群聊中 @ 机器人的消息。

Pasted image 20261029100729

可参考飞书官方的长连接接收事件 和消息事件说明 。

配置应用权限

为了让机器人能够正常收发消息,需要为应用添加必要的权限。

进入权限管理

在应用详情页左侧菜单中,点击权限管理

Pasted image 20261028171752

搜索并配置如下权限:

权限用途
接收单聊消息 im:message.p2p_msg:readonly接收用户发给机器人的单聊消息
接收群内 @ 消息 im:message.group_at_msg:readonly接收群中 @ 机器人的消息
以应用身份发消息 im:message:send_as_bot向用户或群回复消息
获取用户基本信息识别使用者
获取用户手机号手机号字段授权和通讯录数据范围均需覆盖使用者
获取与上传资源 im:resource处理消息中的图片、文件等资源
创建与更新卡片 cardkit:card:write使用流式卡片功能时需要

开通权限后,按飞书提示完成审批和版本发布。应用可用范围与通讯录数据范围需要分别检查。

批量导入权限

更多常用权限见如下清单,可直接进行批量导入。

在弹出的窗口中:

  1. 清空输入框中的所有内容
  2. 将下方的权限列表完整复制并粘贴进去
  3. 点击确定新增权限

需要导入的权限列表:

{ "scopes": { "tenant": [ "contact:contact.base:readonly", "docx:document:readonly", "im:chat:read", "im:chat:update", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message.pins:read", "im:message.pins:write_only", "im:message.reactions:read", "im:message.reactions:write_only", "im:message:readonly", "im:message:recall", "im:message:send_as_bot", "im:message:send_multi_users", "im:message:send_sys_msg", "im:message:update", "im:resource", "application:application:self_manage", "cardkit:card:write", "cardkit:card:read" ], "user": [ "contact:user.employee_id:readonly", "offline_access", "base:app:copy", "base:field:create", "base:field:delete", "base:field:read", "base:field:update", "base:record:create", "base:record:delete", "base:record:retrieve", "base:record:update", "base:table:create", "base:table:delete", "base:table:read", "base:table:update", "base:view:read", "base:view:write_only", "base:app:create", "base:app:update", "base:app:read", "board:whiteboard:node:create", "board:whiteboard:node:read", "calendar:calendar:read", "calendar:calendar.event:create", "calendar:calendar.event:delete", "calendar:calendar.event:read", "calendar:calendar.event:reply", "calendar:calendar.event:update", "calendar:calendar.free_busy:read", "contact:contact.base:readonly", "contact:user.base:readonly", "contact:user:search", "docs:document.comment:create", "docs:document.comment:read", "docs:document.comment:update", "docs:document.media:download", "docs:document:copy", "docx:document:create", "docx:document:readonly", "docx:document:write_only", "drive:drive.metadata:readonly", "drive:file:download", "drive:file:upload", "im:chat.members:read", "im:chat:read", "im:message", "im:message.group_msg:get_as_user", "im:message.p2p_msg:get_as_user", "im:message:readonly", "search:docs:read", "search:message", "space:document:delete", "space:document:move", "space:document:retrieve", "task:comment:read", "task:comment:write", "task:task:read", "task:task:write", "task:task:writeonly", "task:tasklist:read", "task:tasklist:write", "wiki:node:copy", "wiki:node:create", "wiki:node:move", "wiki:node:read", "wiki:node:retrieve", "wiki:space:read", "wiki:space:retrieve", "wiki:space:write_only" ] } }

Pasted image 20261028172013

Pasted image 20261028172123

根据实际情况确定权限可访问范围。

Pasted image 20261028172151

发布应用

应用必须发布后才能在飞书中使用。

创建版本

点击页面上方的创建版本按钮,进入详情页创建或更新版本。

Pasted image 20261028172611

Pasted image 20261028172746

发布版本

创建成功后,点击版本右侧的发布按钮。

如果您是企业管理员或创建个人应用,应用通常会自动审批通过。如果需要审批,请联系您的企业管理员。

Pasted image 20261028172818

获取应用凭证

在应用详情页左侧菜单中,点击凭证与基础信息。

在页面中,您会看到两个重要的凭证信息:

  • App ID:应用的唯一标识
  • App Secret:应用的密钥(点击查看)

请务必妥善保管 App Secret,不要泄露给他人!

Pasted image 20261028173018

在 DeepWorks 中配置飞书

支持通过手机扫码创建或选择飞书应用并接入,也可以手动填写已有应用的凭证。

接入前提: 创建企业应用需具备相应的创建权限。接入前,请按前文完成机器人能力、订阅方式及所需应用权限的配置,并完成版本发布;企业机器人的应用可用范围、手机号授权及通讯录数据范围需覆盖使用人员。扫码接入后也需核对这些配置。

进入机器人配置
  1. 点击 DeepWorks 左下角用户头像,选择IM频道,确认需要配置的工作区。
  2. 在频道连接页签中完成飞书账号连接,具体参见 IM频道。
  3. 切换到机器人页签,点击添加机器人→飞书,打开创建飞书机器人弹窗。

IM频道-V1.4-05-创建飞书机器人

选择接入方式

方式一:手机扫码接入

  1. 点击一键创建飞书应用扫码接入。
  2. 在飞书创建或选择机器人二维码弹窗中,使用手机飞书扫描 DeepWorks 当前页面生成的二维码,按手机页面提示创建机器人或选择已有应用,并完成确认。
  3. 完成后,系统会自动填入应用凭据。返回创建弹窗,检查凭据,并填写或核对机器人名称,确保与实际机器人名称一致。
  4. 在飞书开放平台核对该应用的机器人能力、订阅方式及第 9.6.3 节列出的所需权限,并按第 9.6.4 节完成所需的版本发布。

IM频道-V1.4-06-飞书扫码接入

需要重新获取二维码时,点击刷新二维码。请扫描实际操作页面生成的二维码,不要扫描本指引中的示例图片。

方式二:手动填写凭证

已在飞书开放平台创建应用的,可直接填写以下信息:

配置项填写说明
机器人名称与飞书中实际机器人名称保持一致。
Client ID填写该飞书应用的 App ID。
Client Secret填写该飞书应用的 App Secret。

应用凭证的获取方式见第 9.6.5 节获取应用凭证。接入前,请确认已完成机器人能力、订阅方式、应用权限配置和版本发布。

创建并启用机器人
  1. 确认机器人名称和应用凭据填写完整,打开启用机器人开关,点击创建。
  2. 返回我的机器人列表,确认机器人已添加且处于启用状态。后续可通过配置修改信息,或通过启用机器人开关调整启用状态。
  3. 在飞书中打开对应机器人会话,发送消息并检查是否收到回复。

连接飞书账号后,也可直接使用自己或他人已接入的机器人,无需重复创建;如没有使用权限,可在企业机器人列表中查看创建人并联系申请。

开始使用

找到机器人

在飞书的搜索框中,输入刚才创建的机器人名称进行搜索。

开始对话

点击机器人进入对话窗口,或者点击打开应用开始使用,并发送任务。

Pasted image 20261029103911

在DeepWorks接收到消息

切换到DeepWorks中,也可接收到该消息。

Pasted image 20261029104048

管理我的机器人

修改机器人配置

以钉钉机器人为例:

  1. 在我的机器人列表中,找到需要修改的钉钉机器人,点击配置。
  2. 在配置弹窗中修改机器人名称、App ID 或 App Secret,也可调整启用机器人开关。
  3. 点击保存,更新当前机器人的配置。

IM频道-V1.4-08-配置钉钉机器人

点击取消不会修改已保存的信息。App Secret 右侧提供显示状态切换图标,可按需查看或隐藏密钥。

扫码更新应用凭据

  1. 在钉钉机器人的配置弹窗中,点击扫码更新应用凭据。
  2. 按页面提示使用钉钉扫码并完成确认。
  3. 返回配置弹窗,核对系统自动回填的应用凭据。
  4. 点击保存使修改生效。

也可以直接修改表单中的应用凭据,然后保存。

启用或停用机器人

在我的机器人列表中,通过目标机器人所在行的启用机器人开关调整状态。也可以点击配置,在弹窗中调整启用机器人开关后,点击保存。

机器人启用后才可被自己或他人使用。

移除机器人

在我的机器人列表中,找到目标机器人,点击移除,按后续页面提示完成操作。

移除是机器人管理入口;如需解除平台手机号绑定,应前往频道连接页签执行解绑。

在即时通讯平台中使用机器人

完成频道连接和机器人接入后,可以在即时通讯平台中发送任务、接收回复,并在 DeepWorks 桌面端查看对应会话。以下以钉钉为例。

使用前检查

  1. 在频道连接页签中,确认钉钉已连接,绑定手机号与当前使用的钉钉账号一致。
  2. 确认目标机器人已接入并处于启用状态,且当前账号具有使用权限。
  3. 核对 IM 频道页面右上角选择的工作区,便于后续在桌面端查找对应会话。

在钉钉中发送任务和查看回复

  1. 在钉钉中打开对应机器人的聊天窗口。示例中的机器人名称为DeepWorks。
  2. 在底部输入框中输入问题或任务要求。
  3. 点击发送,等待机器人处理。
  4. 在同一聊天窗口中查看机器人回复。

IM频道-V1.4-09-钉钉发送任务与回复

也可以输入文档整理、信息检索等任务需求。实际可执行范围取决于工作区的文件授权、已配置的工具和相关账号权限。

在 DeepWorks 桌面端查看对应会话

  1. 返回 DeepWorks 桌面端,在左侧我的工作区中找到 IM 频道选择的工作区。
  2. 在该工作区的会话列表中,点击与任务对应的会话。
  3. 在会话正文中查看发送的问题和 AI 回复,核对任务处理结果。页面还会显示处理状态和用时。

IM频道-V1.4-10-桌面端查看IM会话

示例中,钉钉聊天和 DeepWorks 桌面端会话均展示了同一问题及对应回复,可按需要在两端查看结果。

协作

协作用于集中管理任务、资料、AI 能力和交付成果。协作空间组织成员与工作内容,资产库存放文件及其版本,任务管理用于分工和跟踪进度;需要 AI 处理时,可选择本地执行或云端执行,并将成果提交回资产库。

协作空间列表

操作路径: 左侧导航协作。

页面顶部提供空间搜索框和新建协作空间入口,下方按最近使用``我创建的``我参与的``待我处理``已归档五类筛选查看空间。搜索按空间名称包含匹配,可与筛选条件叠加使用。

列表中的每个空间展示名称、描述、状态标签、文件与成员数量、创建人及创建时间。点击空间主信息进入工作台,点击待处理数量进入该空间的待处理列表。

点击行末…打开空间操作菜单,菜单项按当前角色和空间状态显示:

操作说明
标记完成将进行中的空间置为已完成;已完成空间以只读方式进入
归档将空间移入已归档列表,不再出现在其他筛选结果中
编辑修改空间名称和描述,仅进行中的空间可编辑
删除永久删除空间及其内容,不可恢复

协作-V1.4-17-协作空间列表

创建与进入协作空间

操作路径: 左侧导航协作→新建协作空间。

点击新建协作空间,填写必填的空间名称,按需填写描述,点击创建。创建成功后进入空间,可使用任务管理``云端执行``空间设置及左侧资产库。

协作-V1.4-01-新建协作空间

空间设置

成员管理

进入空间设置→成员管理,查看空间成员及角色,支持按成员搜索或按角色筛选。页面提供管理员、协作者、访客等角色信息。

点击邀请成员发起邀请,通过邀请记录查看邀请情况。具体可执行操作以当前账号权限及页面选项为准。

协作-V1.4-02-成员管理

Pasted image 20261030101756

添加 AI 同事

进入空间设置→AI同事→添加 AI 同事,搜索或按类型、分类筛选能力,勾选需要的 AI 同事并确认添加。添加后可在当前空间的执行会话中选择使用。

协作-V1.4-03-添加AI同事

技能与扩展

空间设置提供技能和扩展页签,用于查看和管理空间内的相应能力。

Pasted image 20261030101825

Pasted image 20261030101843

资产库与文件管理

新建资产库

点击空间左侧资产库旁的+,填写资产库名称,按需填写描述,点击保存。创建后可从左侧目录进入资产库,集中管理相关材料和成果。

协作-V1.4-04-新建资产库

上传文件

进入目标资产库的文件页签,点击上传文件,选择本地文件或将文件拖入上传区域,核对目标位置后点击开始上传。上传后可在列表查看文件、版本及更新信息。

协作-V1.4-05-上传文件

预览、下载与版本管理

点击文件名称打开预览,可使用全屏按钮放大查看,或点击下载保存文件。右侧版本管理保留文件的版本记录,可查看最新版本与历史版本;历史版本为只读。

向同一路径提交更新后的文件时,会更新文件版本;内容相同则跳过,不生成新版本。

协作-V1.4-06-预览与版本管理

文档标注

打开文档预览,切换右侧标注页签,选中需要讨论或修改的正文片段,输入意见并发送。标注保存引用片段与意见,便于定位问题,也可随文件一起提供给 AI 处理。

添加标注不会直接修改正文;完成修改后,需另行提交修订文件。

协作-V1.4-07-添加文档标注

文件操作

在资产库文件列表中,点击目标文件右侧…打开操作菜单:

操作说明
标记为关键产物将文件加入当前资产库的关键产物视图
移动将文件移动到其他资产库或文件夹,同步更新归属与路径
下载下载所选文件到本地
删除二次确认后永久删除文件

列表支持多选,选中多个文件后可执行批量移动或批量删除;筛选条件变化时已选内容会清空,避免对未显示的文件误操作。

协作-V1.4-18-文件操作菜单

资产库讨论与关键产物

资产库右侧面板提供讨论与产物两个页签。

讨论用于围绕当前资产库的资料、问题与结论沟通,可按全部讨论或@我的筛选。在输入框发起讨论,可提及空间成员或 @DeepWorks,引用资产库文件的明确版本,使讨论与资料保持关联。

讨论中提及 @DeepWorks 时,会先保存你的讨论,再生成独立的 AI 回复。AI 回复基于你有权访问的资产库文件和关联任务,不会自动修改文件、任务或关键产物。发布讨论本身也不创建执行任务。

产物集中展示当前资产库中被标记为关键产物的文件及其版本,便于快速定位主要交付成果。

协作-V1.4-19-资产库产物面板

网址管理

资产库除文件外,还可统一收纳项目相关的网页地址。切换到网址页签,列表展示网页地址、用途、更新时间和操作。

点击添加网页地址,填写必填的网页地址和可选的用途说明,点击添加。地址需为有效的 HTTP 或 HTTPS 地址,用途说明用于提示该链接对应的内容。

协作-V1.4-27-网址列表

协作-V1.4-28-添加网页地址

代码分支关联

分支页签用于把资产库与团队共用的代码仓库及分支关联起来,便于在执行任务时明确代码上下文。

点击添加仓库及分支,填写代码分支、所属仓库,按需填写说明,点击添加。同一资产库可关联该仓库的多个分支,后续继续添加时仓库信息自动带入。

此处只登记关联关系,供团队识别和引用,不会在远程仓库中创建或修改分支。需要调整时可修改或删除关联记录,同样不影响远程仓库。

协作-V1.4-29-添加仓库及分支

任务管理

工作流管理

工作流定义任务的处理状态、状态间允许的流转路径,以及流转时需要填写的字段。新建任务时通过关联任务类型选择适用流程。

进入任务管理→工作流管理,右侧打开管理抽屉。点击新增工作流创建流程,点击已有工作流卡片查看或编辑配置;卡片…菜单提供设为默认、复制和删除。系统内置工作流可编辑和复制,不可删除。

协作-V1.4-23-工作流管理

工作流配置分为基本信息``状态设置``流转设置三个页签,依次完成后保存。

基本信息:填写工作流名称、关联任务类型和工作流说明,可勾选设为默认。保存后该工作流出现在新建任务的任务类型候选中。

协作-V1.4-24-工作流基本信息

状态设置:列出当前工作流的全部状态,支持添加和编辑状态。起始状态单选且只能有一个,结束状态可多选;至少保留两个状态。删除某个状态时,会一并移除以该状态为起点或终点的流转配置。

协作-V1.4-25-工作流状态设置

流转设置:上方流程图直观展示状态类型和流转方向,下方矩阵用于配置路径——行是起始状态,列是目标状态,勾选交叉项即允许该方向流转。正向和反向路径分别设置,可覆盖验收退回等场景。

协作-V1.4-26-工作流流转设置

创建任务

进入任务管理→添加任务,填写任务标题与描述,选择任务类型和工作流,设置优先级、处理人,并按需填写截止日期、选择依赖任务,点击创建。

协作-V1.4-08-创建任务

更新状态与验收

点击任务的当前状态,打开修改状态,选择目标状态,核对处理人,按需填写说明并点击确认。可通过查看流程图了解流转路径。

状态用途
待开始已创建,尚未开始处理
进行中正在执行或修订成果
待验收成果已准备好,等待检查
已完成验收通过,任务结束
已关闭流程结束,不再继续处理

以上为系统内置工作流的默认状态,实际可选状态和流转路径由任务所选工作流决定。验收发现问题时,可按允许的路径退回处理。文件入库或标记关键产物不会代替任务验收。

协作-V1.4-09-修改任务状态

评论与附件

打开任务详情,在评论区填写进展或反馈。需要附上材料时,点击附件图标,选择资产库并勾选文件,点击发表评论,将文字与附件一并保存到评论记录中。

协作-V1.4-10-任务评论与附件

本地执行与云端执行

引用文件和标注

在执行输入区点击附件图标,选择资产库中的文件并核对版本;需要结合评审意见处理时,勾选携带标注。关闭选择窗口后,确认输入区已带入所需附件。

执行附件引用固定版本。文件更新后,应重新选择附件并核对版本。

协作-V1.4-11-引用文件与标注

本地执行

在资产库的对话输入区选择本地执行,指定本地工作区,添加材料并输入处理要求后发送。随后在对应工作区的会话中查看执行过程、预览和检查产物。

协作-V1.4-12-本地执行

云端执行

进入空间的云端执行,或点击任务行的处理进入带有任务上下文的云端会话。选择目标资产库和文件附件;需要专业能力时,打开添加扩展→AI同事,勾选所需同事。输入要求并发送后,在会话中查看执行过程和产物。

点击处理仅进入执行会话,仍需发送要求才会开始本次执行。

协作-V1.4-13-云端调用AI同事

成果提交与关键产物

提交本地产物

在本地会话右侧文件面板切换到产物,勾选文件,点击提交到协作空间。在提交弹窗中选择提交方式、目标协作空间和资产库,核对目标路径后提交。

选择仅提交文件可将文件放入目标资产库根目录。需要更新已有文件时,应保持文件名和目标路径一致;提交后返回资产库核对版本。

协作-V1.4-14-提交本地产物

提交云端产物

在云端会话右侧产物面板勾选需要保存的文件,点击提交,核对产物数量和目标资产库后确认。提交后生成不可变版本,可在资产库中预览与下载。

协作-V1.4-15-提交云端产物

弹出提交产物到资产库确认框后,确认提交目标资产库无误再点击提交;提交成功后,右侧文件树中对应文件标记为已入库,其余未入库文件保持未入库状态,便于核对提交范围。

协作-V1.4-21-提交产物确认

协作-V1.4-22-提交结果已入库

标记关键产物

在资产库文件列表中,点击目标文件右侧…→标记为关键产物。标记后文件显示关键产物标签,可在右侧产物页签集中查看,便于查找主要交付成果。

协作-V1.4-16-标记关键产物

账号与系统设置

积分余额

点击头像菜单,可查看用户当前积分,点击可跳转至官网查看积分具体消耗情况。 Pasted image 20260814091737

Pasted image 20260814092953

帮助文档

点击头像菜单-帮助文档,可跳转至官网查看帮助文档。 Pasted image 20260814093046 Pasted image 20260814093103

进入设置

点击左下角用户菜单中的设置,进入设置页面。设置项包括账号、模型、高级、外观、宠物、Git、更新、环境变量、意见反馈和已归档的聊天等。 Pasted image 20260813170814

账号设置

点击账号,查看当前用户帐号。 Pasted image 20260813170839

可执行的操作包括:

  • 查看或编辑个人资料;

  • 在个人空间和企业空间之间切换;

  • 退出登录。

切换账号空间会影响可见的模型、专家、Skill、数据和权限。切换后应重新确认当前任务所处空间。

高级设置

在设置 > 高级页面中,可以对 DeepWorks 的隐私、界面辅助功能及开发者功能进行配置。 Pasted image 20260813170923

帮助改进 DeepWorks

在隐私区域,可通过帮助改进 DeepWorks开关控制是否发送匿名诊断和功能使用事件。

开启后,DeepWorks 会收集必要的匿名诊断信息和功能使用情况,用于产品体验和稳定性改进。

该功能不会上传对话内容、提示词、文件内容等隐私数据。

如不希望发送相关诊断信息,可关闭该开关。

显示任务建议

在布局区域,可通过显示任务建议开关控制是否在相关页面展示任务建议。

开启后,DeepWorks 会根据当前使用场景展示任务建议,帮助用户快速了解可以交给 AI 完成的工作,并开始使用相关能力。

关闭后,界面将不再显示任务建议,不影响其他功能正常使用。

开发者模式

在开发者区域,可通过开发者模式开关启用面向开发和调试场景的高级功能。

开启开发者模式后,可使用:

  • 调试工具;

  • 诊断信息;

  • 开发者相关标签页。

开发者模式主要用于问题排查、功能调试和开发测试。普通用户通常无需开启。

如需进行调试或配合技术人员定位问题,可开启该功能;使用完成后,可根据需要再次关闭。

操作说明

页面中的配置均通过右侧开关进行控制:

  • 蓝色表示当前功能已开启;

  • 灰色表示当前功能已关闭。

点击对应开关即可直接修改设置,设置生效后无需额外保存。

外观设置

DeepWorks 支持根据个人使用习惯调整界面主题、显示语言以及对话和代码的字体大小。用户可以通过快捷入口快速切换明暗主题,也可以进入外观设置页面进行完整配置。

快速切换界面主题

点击左下角的用户头像,展开个人菜单。 Pasted image 20260813172048

在外观一栏中,可直接通过右侧图标快速切换界面主题:

  • 浅色模式:使用亮色背景显示界面,适合日间或光线较亮的环境。

  • 深色模式:使用深色背景显示界面,适合夜间或弱光环境。

选择后,界面主题会立即切换,无需重新启动 DeepWorks。

设置界面主题

如需使用更完整的主题设置,可进入:设置 > 外观 Pasted image 20260813172150 在主题区域选择需要的显示模式。

主题说明
浅色始终使用浅色界面
深色始终使用深色界面
系统自动跟随当前操作系统的外观设置

选择系统后,当电脑系统在浅色模式和深色模式之间切换时,DeepWorks 会同步调整界面显示效果。

点击对应主题卡片即可完成切换,当前已选中的主题会以选中状态显示。

设置界面语言

在语言区域,可设置 DeepWorks 的界面显示语言。 Pasted image 20260813172325

点击右侧的语言下拉框,选择需要使用的语言,例如简体中文。

设置完成后,DeepWorks 将按照所选语言显示菜单、按钮及相关界面内容。

设置字体大小

在偏好设置区域,可分别调整对话内容和代码内容的字体大小。 外观设置-字体大小

  • 对话字体大小:用于调整对话内容的字体大小。可设置范围为12–20 px,默认值为14 px。

  • 代码字体大小:用于调整代码块、行内代码、差异视图、文件预览及终端日志的字体大小。可设置范围为10–24 px,默认值为12 px。

点击对应的数值输入框,输入允许范围内的字号即可完成调整。设置后,可通过对话内容、代码块或终端日志检查显示效果,并根据阅读习惯继续调整。

操作说明

外观设置修改后会直接生效,无需额外点击保存。

如果只是临时需要切换浅色或深色模式,可直接使用用户菜单中的外观快捷入口;如需设置跟随系统、调整界面语言或修改字体大小,可进入设置 > 外观进行配置。

模型设置

在设置 > 模型页面中,可以管理 DeepWorks 使用的模型提供商、模型连接方式及默认模型等相关偏好。用户既可以连接平台预置的模型提供商,也可以添加兼容 OpenAI API 的自定义模型服务。 Pasted image 20260813173442

管理模型提供商

提供商区域展示当前已经配置的模型提供商,以及每个提供商已获取的模型数量。

每个提供商可根据当前状态执行以下操作:

操作说明
代理控制该提供商访问模型服务时是否使用已配置的全局代理
刷新重新获取该提供商的模型及连接信息
编辑修改已经配置的提供商连接信息
测试测试当前配置是否可以正常连接模型服务
断开连接移除当前提供商的连接配置

建议首次配置完成后点击测试,确认模型服务能够正常访问。

连接模型提供商

点击页面右上角的连接提供商,打开提供商列表。 Pasted image 20260813173513

可以通过顶部搜索框,按照提供商名称或 ID 快速查找需要连接的模型服务。

选择目标提供商后,点击右侧的连接,按照页面提示完成认证配置。

当前已经完成配置的提供商会显示已连接状态,无需重复连接。

不同提供商可能采用不同的认证方式,例如 API 密钥等,具体填写内容以对应模型服务提供方要求为准。

连接成功后,DeepWorks 会获取该提供商可用的模型,并在模型设置页面显示已获取的模型数量。

添加自定义提供商

如果需要连接列表中未预置的模型服务,可以点击添加自定义提供商。DeepWorks 支持接入兼容 OpenAI API 格式的模型网关或模型服务。

Pasted image 20260813173539

根据实际模型服务填写以下信息:

配置项说明
显示名称自定义提供商在 DeepWorks 中显示的名称
供应商 ID提供商的唯一标识,可由显示名称自动生成,也可自行修改
Base URLOpenAI 兼容接口的 API 根地址,通常以 /v1 结尾
API 密钥用于访问模型服务的 API Key
模型配置需要使用的模型 ID,每行填写一个模型

其中,模型为可选配置。如果留空,DeepWorks 将尝试通过模型服务的 /models 接口自动发现可用模型。

例如,可以按照以下形式填写模型:

gpt-4o gpt-4o-mini

根据自定义模型的实际能力,还可以选择:

  • 支持图片输入(多模态):模型能够接收图片等视觉内容时启用。

  • 支持推理:模型具有推理能力时启用。

填写完成后,点击添加供应商完成配置。

添加成功后,自定义提供商将出现在模型提供商列表中,可以继续进行测试、编辑等操作。

配置代理

如当前网络环境需要通过代理访问模型服务,可展开更多设置,配置全局代理地址。 Pasted image 20260813173716

在全局代理地址中填写代理服务地址。例如:

http://127.0.0.1:7890

留空表示不使用代理。

完成全局代理配置后,还需要在对应模型提供商右侧开启代理开关,指定该提供商通过代理访问。

如果模型无法正常连接,可以检查代理地址是否正确,并通过提供商右侧的测试功能验证连接状态。

设置默认模型

在偏好设置区域,可以设置 DeepWorks 默认使用的模型。 Pasted image 20260813173855

点击默认模型右侧的更改,从当前已经连接并可用的模型中选择一个模型作为默认模型。

设置后,新建任务或对话时,DeepWorks 将优先使用该模型;在支持模型切换的场景中,仍可以根据需要选择其他模型。

显示模型推理

通过显示模型推理开关,可以控制模型提供推理过程时,是否在界面中展开显示相应的推理轨迹。

  • 开启:在模型支持的情况下显示推理相关内容。
  • 关闭:不在界面中展开显示推理轨迹。

该设置只在所使用的模型提供对应能力时生效。

设置回复过程中发送新消息

回复过程中发送新消息用于设置 DeepWorks 尚未完成当前回复时,再次发送消息的处理方式。

点击右侧下拉框,可以选择对应的消息处理方式。

例如选择排队发送后,在当前回复尚未结束时发送的新消息将进入等待队列,在适当时机继续处理。可根据实际使用习惯选择对应方式。

设置结构化提问

结构化提问用于控制助手在需要用户进一步确认或进行选择时,是否使用带选项的确认卡片。

点击右侧下拉框可以调整该功能的使用方式。

例如选择自动后,DeepWorks 会根据当前任务情况判断是否使用结构化选项辅助用户进行确认。

涉及权限审批的操作仍由相应的权限机制处理,不受该设置影响。

自动上下文压缩

开启自动上下文压缩后,DeepWorks 可以在长对话、长任务等上下文持续增加的场景中,对工作区上下文进行自动压缩,以便后续任务继续执行。

该功能适合持续时间较长、会话内容较多或需要多轮处理的工作场景。

修改该设置后,应按照页面提示重新载入相关引擎,使新的配置生效。

使用建议

首次使用模型功能时,建议按照以下顺序完成配置:

  1. 点击连接提供商,连接需要使用的模型服务;

  2. 使用测试确认模型连接正常;

  3. 在默认模型中选择日常使用的模型;

  4. 如网络环境需要代理,再配置全局代理并为对应提供商开启代理;

  5. 只有在需要接入私有模型、模型网关或其他 OpenAI 兼容服务时,再使用添加自定义提供商。

完成以上配置后,即可在 DeepWorks 的对话、任务和智能体等相关场景中使用已连接的模型。

环境变量

在设置 > 环境变量页面中,可以统一配置 DeepWorks 运行过程中使用的环境变量,例如模型服务 API Key、第三方工具密钥或其他外部服务参数。

通过环境变量保存的配置信息,可以供相关模型、技能、MCP 或其他工具在运行时调用,避免在每次使用时重复填写。

查看环境变量

进入:设置 > 环境变量,页面显示当前已经保存的环境变量。 Pasted image 20260813174447

每条环境变量主要包括:

内容说明
变量名称环境变量的名称,例如 DTS_API_KEY
变量值对应的环境变量内容,默认以隐藏形式显示
更新时间最近一次修改该环境变量的时间
操作支持查看、编辑和删除变量

对于 API Key、Token 等敏感信息,变量值默认隐藏,避免敏感信息直接暴露。

新增环境变量

点击页面右上角的新增变量,根据页面提示填写环境变量名称和对应值。

例如,某个模型服务要求配置:

DTS_API_KEY

则可以将服务提供方提供的 API Key 保存为该变量的值。

填写完成后保存,新增变量将出现在环境变量列表中。 Pasted image 20260813174643

环境变量的具体名称和内容应以对应模型、Skill、MCP 或第三方服务提供的配置要求为准。

查看变量值

环境变量中的密钥、Token 等内容默认以隐藏形式显示。

如需核对已经保存的内容,可点击变量右侧的显示/隐藏按钮查看变量值,再次点击可恢复隐藏状态。

建议仅在必要时查看敏感变量,并避免在共享屏幕、截图等场景中暴露相关信息。

编辑环境变量

如需修改已经保存的环境变量,点击对应变量右侧的编辑按钮。

修改变量名称或变量值后保存,即可更新当前配置。

当 API Key、Token 等认证信息发生变化时,可以直接通过该方式更新,无需删除后重新创建。

删除环境变量

对于已经不再使用的环境变量,点击对应变量右侧的删除按钮即可移除。

删除前请确认相关模型、Skill、MCP 或其他功能已经不再依赖该变量,否则可能导致对应服务无法正常调用。

使用建议

环境变量通常用于保存 API Key、Token 等敏感配置。建议仅添加实际需要使用的变量,并妥善管理相关密钥;当密钥失效、轮换或相关服务不再使用时,应及时更新或删除对应变量。

Git 设置

在设置 > Git页面中,可以配置 DeepWorks 创建 Git 分支、合并 Pull Request、推送分支和管理工作树时的默认行为,还可以为 AI 生成提交信息和 Pull Request 描述提供额外指令。

Git 设置

设置分支前缀

分支前缀用于设置新建分支时自动添加的名称前缀。例如填写 deepworks/ 后,DeepWorks 创建的分支名称将自动以 deepworks/ 开头。

建议使用简短、易识别的前缀,并以 / 结尾,以便区分由 DeepWorks 创建的分支。

设置 PR 合并方法

PR 合并方法用于设置合并 Pull Request 时默认采用的策略。点击右侧下拉框,可选择当前代码托管平台支持的合并方式。

若选择合并提交。使用该方式时,系统会通过一个合并提交将 Pull Request 的变更合入目标分支,并保留分支上的提交记录。

具体可选项可能因代码托管平台及仓库配置而不同。如企业或项目已有统一规范,应按照仓库要求选择。

显示 PR 图标

开启显示 PR 图标后,Git 评审面板中的 Pull Request 操作按钮会显示相应图标;关闭后则不显示图标。

该设置仅影响界面显示,不影响 Pull Request 功能。

始终强制推送

开启始终强制推送后,DeepWorks 推送已经发布过的分支时会使用 --force-with-lease。

该方式常用于变基、整理或改写提交历史后的分支更新。虽然 --force-with-lease 会在远端分支发生非预期变化时阻止覆盖,但强制推送仍可能影响其他协作者,建议仅在明确了解分支协作情况并符合项目规范时开启。

创建草稿 PR

开启创建草稿 PR后,DeepWorks 新建的 Pull Request 会自动标记为草稿状态,表示相关变更尚未准备好正式评审或合并。

如果希望新建 Pull Request 后立即进入正式评审流程,可关闭该开关。

自动删除旧工作树

开启自动删除旧工作树后,DeepWorks 会自动清理数量超出保留上限的旧工作树(worktree),减少长期使用后遗留的工作树占用本地空间。

系统只会根据设置的保留数量清理超出部分。清理前,请确保旧工作树中的重要修改已经提交或妥善保存。

设置保留工作树数量

保留工作树数量用于指定自动清理时需要保留的最近工作树数量,默认值为 15。

该设置与自动删除旧工作树配合使用。开启自动删除后,当工作树数量超过设定值时,系统会清理较旧的工作树;关闭自动删除后,该数量设置不会触发自动清理。

设置提交指令

提交指令用于在 AI 生成 Git 提交信息时提供额外要求。例如,可以要求使用 Conventional Commits 格式、限制标题长度,或指定提交信息使用的语言。

示例:

使用 Conventional Commits 格式,首行不超过 72 个字符,并使用中文说明变更内容。

留空时,AI 将按照默认规则生成提交信息。

设置 MR / PR 指令

MR / PR 指令用于在 AI 生成 Merge Request 或 Pull Request 描述时提供额外要求。例如,可以要求描述中包含变更摘要、测试步骤、影响范围和注意事项。

示例:

在 PR 描述中列出变更摘要、测试步骤、影响范围和注意事项。

留空时,AI 将按照默认规则生成 MR 或 PR 描述。

Git 设置修改后会直接生效,无需额外点击保存。涉及分支命名、合并策略、强制推送和工作树清理的设置,建议与所在项目的 Git 协作规范保持一致。

更新

DeepWorks 支持手动检查和后台自动检查更新。用户可以在设置 > 更新页面查看当前版本、下载新版本并完成安装,也可以通过左下角用户菜单快速检查更新。

查看当前版本

进入设置 > 更新,在当前版本区域可以查看 DeepWorks 的应用名称和当前安装版本。

更新设置

反馈问题或联系技术支持时,建议同时提供此处显示的版本号,以便确认功能范围并排查问题。

在设置页面检查更新

点击右侧的检查按钮,DeepWorks 会立即检查是否存在可用的新版本。

  • 显示已是最新,表示当前安装版本已经是可获取的最新版本;

  • 显示准备安装:vX.X.X,表示新版本安装包已经下载完成,可以安装;

  • 如果检查失败,可确认当前网络连接是否正常后再次尝试。

通过用户菜单检查更新

除设置页面外,还可以点击左下角的用户头像打开用户菜单,然后点击检查更新,快速发起版本检查。

用户菜单检查更新

如果检测到新版本,页面右上角会显示新版本就绪提示。用户可以点击更新日志查看版本变更内容,或点击下载更新开始下载。

发现新版本

下载更新

点击下载更新后,进入设置 > 更新页面。下载期间,页面会显示当前下载量、安装包总大小、下载进度条和进度百分比。请保持网络连接正常,并等待下载完成。

下载更新

下载过程中,检查按钮可能暂时不可用。请勿反复点击检查或关闭应用,以免中断下载。

安装并重启

下载完成后,更新状态会显示准备安装:vX.X.X,右侧出现安装并重启按钮。

安装并重启

安装前请保存正在编辑的文件,并确认当前任务已经完成或可以中断。点击安装并重启后,DeepWorks 将退出当前应用、安装新版本并重新启动。重启完成后,可再次进入设置 > 更新,核对当前版本是否已更新为目标版本。

设置后台检查

开启后台检查后,DeepWorks 会在应用启动时检查更新,并在应用运行期间每天检查一次。

后台检查仅负责自动获取版本更新状态;发现新版本时,应根据界面提示完成后续操作。关闭该开关后,DeepWorks 不再按照上述频率自动检查,仍可通过检查按钮或用户菜单中的检查更新手动检查。

页面中的开关修改后会直接生效,无需额外点击保存。企业统一管理的客户端应按照企业发布安排进行升级;如组织对版本或升级时间有统一要求,请以管理员通知为准。

更新异常处理

  • 检查失败:确认网络连接正常后,再次点击检查;如仍失败,请联系企业管理员或技术支持。

  • 下载长时间无进展:检查网络状态,稍后重新发起下载;不要连续重复操作。

  • 安装后版本未变化:退出并重新启动 DeepWorks 后再次核对版本;如仍未更新,请保留当前版本号、目标版本号和页面截图,并联系技术支持。

意见反馈

DeepWorks 提供意见反馈功能,用于提交使用过程中遇到的功能异常、产品建议或其他问题。用户可以从左下角用户菜单快速提交反馈,也可以在设置 > 意见反馈页面提交并查看历史反馈的处理状态。

打开意见反馈

点击左下角的用户头像打开用户菜单,然后点击意见反馈,即可打开反馈窗口。

用户菜单意见反馈入口

也可以进入设置 > 意见反馈,在反馈记录页面点击右上角的提交反馈。

选择反馈分类

打开反馈窗口后,先根据实际情况选择反馈分类。

提交意见反馈

分类适用场景
功能异常功能不可用、运行时报错,或实际结果与预期不一致
产品建议希望增加新功能,或对现有功能和使用体验提出改进建议
其他不属于上述两类的其他反馈

选择最符合问题的分类,有助于相关人员更快地判断反馈内容并进行处理。

填写反馈内容

在反馈输入框中描述遇到的问题、期望结果或改进建议。为便于定位和处理,建议尽量包含以下信息:

  • 问题发生的时间、所在页面及使用的功能;

  • 执行过的操作步骤;

  • 期望结果与实际结果;

  • 问题是否可以稳定复现;

填写完成并选择反馈分类后,点击提交反馈完成提交。

添加图片

如需通过图片说明问题,可以使用以下方式添加附件:

  • 点击上传图片,选择本地已有的截图或图片;

  • 点击截取当前页面,直接截取当前 DeepWorks 页面;

  • 在反馈输入框中使用 Ctrl+V(macOS 可使用 Command+V)粘贴剪贴板中的图片。

提交前请检查图片内容,避免包含账号凭据、API Key、Token、客户数据或其他敏感信息。

查看反馈记录

进入设置 > 意见反馈,可以查看已经提交的反馈记录。

意见反馈记录

反馈列表主要显示以下信息:

内容说明
时间反馈的提交时间
状态当前处理状态,例如已解决
分类提交时选择的反馈分类
描述反馈内容摘要及最新回复摘要
图片提交反馈时附带的图片

点击右上角的刷新,可以重新获取最新的反馈记录和处理状态。点击列表中的反馈,可打开对应的反馈对话并查看处理详情。

查看回复并补充信息

在反馈对话中,可以查看反馈分类、处理状态、提交时间、原始反馈内容,以及 DeepWorks 支持人员的回复。

意见反馈对话

如果需要继续提供复现步骤、截图或其他信息,可以在底部输入框中填写补充内容,也可以点击图片按钮添加图片,然后点击发送补充。

对于已经标记为已解决、但仍需继续沟通的反馈,可以点击回复并再次打开,补充信息并重新进入处理流程。

提交反馈时应只提供定位问题所需的信息。上传截图或日志前,请对客户名称、账号、联系方式、业务数据、密钥及其他敏感内容进行脱敏处理。

宠物

宠物用于陪伴工作,并提示需要关注的任务状态。点击左下角用户菜单中的设置,再点击宠物,即可选择宠物并调整显示方式。

宠物-01-设置

选择或切换宠物

  1. 在选择宠物区域,点击熊小D或熊小D·2d对应的卡片。
  2. 在预览区域确认切换后的形象;宠物处于显示状态时,桌面上的宠物也会同步切换。

同一时间只能选择一个宠物。切换时会保留当前的显示状态和大小设置,相关设置自动保存,无需额外点击保存。

隐藏或重新显示宠物

暂时不需要宠物陪伴时,点击设置页右上角的隐藏宠物。需要再次显示时,返回设置 > 宠物,使用右上角的显示按钮恢复展示。或点击头像-隐藏宠物。 Pasted image 20261008104132

隐藏后,宠物及其任务提示框一并隐藏,但不会停止正在执行的任务,也不会清空已选宠物和大小设置。重新显示时,将按已保存的配置恢复。

调整宠物大小

  1. 在预览区域拖动调整大小滑杆:向左缩小,向右放大。
  2. 观察预览效果,调整到合适大小后松开滑块。
  3. 如需恢复默认大小,点击重置。

大小调整会自动保存。若宠物影响内容阅读或操作,可缩小尺寸,或通过隐藏宠物暂时隐藏。

上传宠物

如需使用自定义宠物,点击上传宠物,按随后打开的上传界面提示选择素材并完成上传。素材格式和大小要求以上传界面的提示为准。 Pasted image 20261008104219

查看任务提醒

宠物显示时,可通过其上方的任务提示框关注关联对话的状态。使用宠物下方的箭头按钮,可以展开或收起任务信息;收起任务信息不会隐藏宠物,也不会停止任务。

宠物-02-任务提醒

当提示等待回应时,进入对应对话,找到尚未处理的提问、确认或权限请求,并按提示完成操作。完成回应后,继续在对话中查看后续处理结果。宠物的动作会随任务状态变化,无需手动切换;具体待办内容和执行结果以关联对话为准。

已归档的聊天

已归档的聊天用于集中查找、取消归档或删除已归档的对话。

操作路径: 左下角用户菜单→设置→已归档的聊天。

归档聊天-02-已归档的聊天

查找已归档的聊天

  1. 在顶部搜索框输入目录名称或会话标题关键词,查找目标对话。
  2. 需要缩小范围时,点击所有项目下拉框,选择目标项目。
  3. 需要调整排列方式时,点击排序下拉框,选择所需排序方式。

取消归档

  1. 找到需要恢复的对话,点击右侧取消归档。
  2. 点击左上角返回应用,在对应工作区中找到该对话,即可继续使用。

删除已归档的聊天

  • 删除单个聊天:找到目标对话,点击该行右侧的删除图标。
  • 删除某个项目下的全部已归档聊天:核对项目名称,点击该项目分组右上角的全部删除。该操作针对所选项目分组内的已归档聊天。

如需保留对话并继续使用,应选择取消归档。