使用 Agents

使用自然语言在终端中完成任何任务。

什么是 Agent Mode?

Agent Mode 是 Warp 中的一种模式,它允许你用自然语言执行任何终端任务。你只需在终端输入栏输入任务内容,按下 ENTER,Warp AI 就会根据你的环境生成高度准确的命令并执行。

Agent Mode 可以:

  1. 理解纯英文描述(不仅仅是命令)
  2. 执行命令并根据输出结果指导下一步
  3. 在遇到错误时自动修正
  4. 学习并整合任何有公共文档或 --help 的服务
  5. 利用已保存的工作流回答你的问题

访问示例库查看 Agent Mode 的演示视频


如何进入 Agent Mode

你可以通过以下几种方式进入 Agent Mode:

  • 在终端输入栏输入任何自然语言(任务或问题),Warp 会通过本地自动检测功能识别自然语言,并准备将你的查询发送给 Warp AI。
  • 使用快捷键 CMD-I 或输入 * + 空格 进入 Agent Mode。
  • 点击菜单栏的 “AI” ✨ 图标,会打开一个从 Agent Mode 启动的新终端面板。
  • 从某个 Block 发起 AI 查询:你可以点击工具栏中的 ✨ 图标,或在该 Block 的上下文菜单中选择 “Attach block(s) to AI query”。

默认会进入 Pair 模式。在该模式下,你可以与 Warp 进行持续的对话,描述问题和任务。 当进入 Agent Mode 时,终端输入行旁会显示一个 ✨ 图标。

使用 Agents - 图2

自动检测自然语言与配置设置

Warp 用于检测自然语言的功能完全是 本地运行的,只有在你按下 ENTER 执行 Agent Mode 时,输入才会发送给 AI。

如果发现某些 shell 命令被误识别为自然语言,可以在 Settings > AI > Auto-detection denylist 中将这些命令添加到 denylist。 你也可以在 Settings > AI > Input Auto-detection 中关闭自动检测功能。

第一次进入 Agent Mode 时,Warp 会显示一个提示横幅,让你选择是否关闭自然语言检测。

使用 Agents - 图3

输入提示(Input Hints)

Warp 的输入编辑器有时会显示浅灰色的提示文本,帮助你学习功能。该功能默认启用。

  • 可通过 Settings > AI > Show input hint text 切换,或在 Command Palette 中搜索 “Input hint text”,也可右键点击输入编辑器调整。

如何退出 Agent Mode

  • macOS:按 ESCCTRL-C 退出,或用 CMD-I 切换回普通模式。
  • Windows / Linux:按 ESCCTRL-C 退出,或用 CTRL-I 切换回普通模式。

如何在 Agent Mode 下执行命令

输入你的问题或任务后,按 ENTER 执行 AI 查询。Agent Mode 会将请求发送给 Warp AI,并以 AI Block 的形式开始流式输出。 不同于聊天面板,Agent Mode 可以直接在当前会话中运行命令。

Agent Mode 命令建议

如果 Agent Mode 找到可完成任务的命令,它会在 AI Block 中描述该命令,同时填充到终端输入中,你只需按 ENTER 运行该命令。 运行建议的命令时,它会像你在终端中输入的普通命令一样执行,不会再将数据回传给 AI。 如果命令失败,你可以重新发起新的 AI 查询来解决问题。

使用 Agents - 图4

Agent Mode 请求命令

如果 Agent Mode 缺乏上下文来完成任务,它会请求你授权运行某个命令并读取输出。 你必须明确同意并按 ENTER 执行该命令;此时命令输入和输出都会发送给 Warp AI。 如果不希望发送,可以点击 Cancel 或按 CTRL-C 退出 Agent Mode。

一旦请求命令执行完成,你可以展开输出查看命令详情。 如果命令失败,Warp AI 会检测到并重新尝试,直到完成任务。

使用 Agents - 图5

Agent Mode 支持的 LLM 模型

Warp 允许你选择 Agent Mode 使用的 LLM 模型,默认是 Claude 4 Sonnet,但你可以切换到其他支持的模型,包括:

  • OpenAI (General Purpose):GPT-4o, GPT-4.1
  • OpenAI (Reasoning Models):o3-mini, o3, o4-mini
  • Anthropic:Claude 4 Sonnet, Claude 3.7 Sonnet, Claude 3.5 Sonnet, Claude 3.5 Haiku
  • Google:Gemini 2.0 Flash, Gemini 2.5 Pro
  • DeepSeek:R1, V3(由 Fireworks AI 托管于美国)

Codebase Context 数据库

Warp 会将 Codebase Context 数据保存到你电脑的本地 JSON 文件中,你可以直接查看这些文件,路径如下:

macOS:

  1. cd "$HOME/Library/Application Support/dev.warp.Warp-Stable/codebase_index_snapshots"