规则规则是手动定义的约束,供代理在本地和全局级别遵循。规则允许用户指导代理遵循特定于他们自己的用例和风格的行为。开始使用规则:

  1. 通过编辑器代理面板顶部的“...”下拉菜单打开“自定义”面板。
  2. 导航至“规则”面板。
  3. 单击 + 全局 创建新的全局规则,或单击 + 工作空间 创建新的特定于工作空间的规则。规则本身只是一个 Markdown 文件,您可以在其中输入约束来指导代理执行您的任务、堆栈和样式。每个规则文件的长度限制为 12,000 个字符。

全球规则全局规则位于 ~/.gemini/GEMINI.md 中,并应用于所有工作区。

工作区规则工作区规则位于工作区或 git 根目录的 .agents/rules 文件夹中。在规则级别,您可以定义如何激活规则:

  • 手动:通过代理输入框中的提及手动激活规则。
  • 始终开启:始终应用规则。
  • 模型决策:基于规则的自然语言描述,模型决定是否应用该规则。
  • Glob:根据您定义的 glob 模式(例如 .js、src//.ts),该规则将应用于与该模式匹配的所有文件。注意:反重力现在默认为 .agents/rules,但仍保持对 .agent/rules 的向后支持。

@提及您可以在规则文件中使用@filename 引用其他文件。如果文件名是相对路径,它将相对于规则文件的位置进行解释。如果 filename 是绝对路径,它将被解析为真正的绝对路径,否则它将被解析为相对于存储库。例如,@/path/to/file.md将首先尝试解析为/path/to/file.md,如果该文件不存在,它将解析为workspace/path/to/file.md。

工作流程工作流使您能够定义一系列步骤来指导代理完成一组重复的任务,例如部署服务或响应 PR 评论。这些工作流程保存为降价文件,使您可以轻松重复地运行关键流程。保存后,可以通过格式为 /workflow-name 的斜杠命令在 Agent 中调用工作流。规则通过在提示级别提供持久的、可重用的上下文来为模型提供指导,而工作流则在轨迹级别提供结构化的步骤或提示序列,指导模型完成一系列相互关联的任务或操作。要创建工作流程:

  1. 通过编辑器代理面板顶部的“...”下拉菜单打开“自定义”面板。
  2. 导航到“工作流程”面板。
  3. 单击 + 全局 按钮创建可在所有工作区中访问的新全局工作流,或单击 + 工作区 按钮创建特定于当前工作区的工作流。要执行工作流,只需使用 /workflow-name 命令在代理中调用它即可。您可以从工作流程中调用其他工作流程!例如,/workflow-1 可以包括“Call /workflow-2”和“Call /workflow-3”等指令。调用时,代理会按顺序处理工作流中定义的每个步骤,执行指定的操作或生成响应。工作流程保存为 Markdown 文件,包含标题、描述和一系列步骤,以及代理需要遵循的具体说明。每个工作流程文件的长度限制为 12,000 个字符。

代理生成的工作流程您还可以要求代理为您生成工作流程!在通过一系列步骤手动使用代理之后,这种方法尤其有效,因为它可以使用对话历史记录来创建工作流。