如何让 Agent 更准确地操作 Studio
本文面向已经开始在 Studio 中使用 Agent 的用户，重点回答一个非常实际的问题：怎样描述需求，才能让 Agent 更容易理解目标、减少误操作，并把结果落到更合适的位置。
这篇文档不讨论某个具体功能怎么点，而是总结在 Studio 中与 Agent 协作时常见的表达方式和复核重点。
为什么需要这篇文档
Studio 中很多问题并不是出在执行动作本身，而是出在目标、对象边界或期望状态没有提前说明。常见情况包括：任务创建到了不希望的目录、创建了草稿但用户期待的是已经发布、组合任务对象创建了但 DAG 还没有补完整、规则已经创建但用户以为已经执行、Agent 返回"已完成"但用户关心的其实是对象 ID、路径、依赖或发布状态。这些信息如果在一开始就说明清楚，后续协作通常会更顺畅。
先把目标描述成"对象 + 动作 + 边界"
和 Agent 协作时，比较常见的一种表达方式是说清楚对象是什么、想做什么动作、不要做什么、做完后返回什么。可以参考下面这种结构：
例如：
这种写法通常更容易减少歧义，因为它把对象、动作、边界和返回结果放在了一起。
哪些信息适合在一开始就说明
目标工作区。 如果会在多个工作区之间切换，通常会先说明当前要操作的工作区，例如"请在当前工作区检查……"或"请先确认当前工作区是否是
{工作区名称}任务目录。 在 Studio 里，很多任务对象都属于任务树的一部分，因此目录信息通常比较关键。如果要创建任务、组合任务或测试对象，通常会直接说明目标目录、目录是否已经存在、是否允许新建目录，例如"请在
测试任务/临时开发对象名称或 ID。 如果对象已经存在，通常优先提供任务 ID、任务组 ID、规则 ID 或明确的任务名称。名称相近时，ID 往往更可靠。如果暂时只有名称，也可以先让 Agent 做一次只读确认，例如"请先只读确认任务
{任务名}当前想要的是草稿、配置还是发布态。 Studio 中最容易混淆的是创建草稿、保存调度配置、发布到调度系统、手动执行或重跑补数这几个阶段。如果不特别说明，用户和 Agent 很容易对"完成"的含义理解不同。通常会把期望状态直接说出来，例如"只创建草稿""只保存配置""先不要发布""不要立即执行""只做只读检查"。
对不同类型对象，可以怎么描述
普通任务。 通常会说清任务类型、目录、是否只创建草稿、是否写代码、是否执行、是否发布，例如：
组合任务。 组合任务比普通任务多一层，除了对象本身，还要关注节点和依赖。常见做法是把几件事分开说明：先创建组合任务对象，再创建哪些节点，再配置哪些依赖，最后返回 DAG 结构，例如：
任务组。 任务组和组合任务不是同一个对象。如果要的是任务组，通常会直接说：
DQC 规则。 对 DQC 规则，通常会明确检查对象、规则类型、触发方式、是否只是测试规则、是否执行，例如：
比较值得提前说清的四条边界
不执行： 如果当前只需要 Agent 协助准备对象或检查配置，通常会直接写"不执行""不手动运行""不补数""不重跑"。
不发布： 如果当前只是做草稿或调试，通常会明确写"不发布""不进入调度系统"。
不修改生产对象： 如果是在测试环境、测试目录或测试对象上操作，通常也会写出来"仅测试""不关联生产链路""不影响其他任务"。
先确认，再执行： 高影响操作里，这样的表述比较常见："操作前请先说明将修改哪些对象、影响范围是什么，并请求我确认。"这类动作包括发布、取消发布、删除任务、删除依赖、补数、重跑、修改调度周期。
做完后，通常会让 Agent 返回什么
很多时候，真正有助于判断结果是否正确的并不是"已完成"三个字，而是结构化信息，常见的有对象 ID、对象名称、所在目录或路径、当前状态、是否已发布、节点清单、依赖边、规则 ID、触发方式、是否产生运行实例，例如：
或者：
为什么还需要一次复核
在 Studio 中，"对象创建成功"通常只是第一步。很多场景下，还会再加一次只读复核：任务是否真的在正确目录下、组合任务的 DAG 是否为空、子任务内容是否已经写入、依赖边是否存在、规则是否真的创建成功、监控为空到底是正常还是异常，例如：
高影响操作，常见的是分两轮处理
第一轮只做影响分析，例如：
第二轮确认执行，例如：
这种分法通常把理解和执行分开，更容易及时纠正误解，在生产环境里也更容易复核。
遇到不确定时，可以先让 Agent 先查
如果对象当前状态还不清楚，通常会先让 Agent 做只读探查，而不是直接做变更，例如先查任务是否已发布、先查当前目录下是否已有同名任务、先查是否已有 DQC 规则、先查最近是否有运行实例、先查任务组里现在有什么内容。这类前置确认，往往能减少后续返工。
一组常见的提问习惯
如果希望 Agent 更稳定地操作 Studio，以下这组信息通常比较有帮助：先说明工作区，再说明对象名称或 ID，明确目标目录，明确这是草稿、配置、发布还是运行，明确不要做什么，要求返回结构化结果，必要时要求二次复核。
参考模板
创建任务草稿：
创建组合任务并补 DAG：
保存配置但不发布：
高影响操作前先确认：
创建 DQC 测试规则：