与 Agent 对话

除了把 任务 指派给 Agent,你也可以直接和 Agent 对话。

对话有两条入口,不要混成一件事:

  • 独立会话:从对话入口或 Agent 详情页发起,适合还没有形成明确任务时询问、调研、整理思路。
  • 任务详情里的对话:从某个任务打开,记录挂在这个任务上,但不是任务评论。

独立会话适合还没有形成明确任务时使用。你可以先让 Agent 帮你理解问题、整理资料、拆解方案,等出现明确行动项后,再把结论写进任务或创建新任务。

在 HiFox 中与 Agent 对话

什么时候使用对话?

适合使用对话的场景包括:

  • 你想先问一个问题,还不确定要不要创建任务;
  • 你想让 Agent 帮你整理思路或拆解需求;
  • 你想快速了解某个模块、项目或问题背景;
  • 你想让 Agent 先做调研,再决定是否进入执行;
  • 你想和某个 Agent 保持一段持续的讨论上下文。

如果一件事已经需要被跟踪、分配、执行或验收,建议创建任务,而不是只停留在对话里。

开始一个 Agent 对话

你可以从对话入口新建会话,也可以从 Agent 详情页发起会话。

一般流程是:

  1. 选择要对话的 Agent;
  2. 说明背景和你想得到的结果;
  3. 如有需要,补充链接、截图、错误信息或相关上下文;
  4. 根据 Agent 的回复继续追问、澄清或要求整理结论;
  5. 如果讨论出了明确工作,把它转成任务。

选择 Agent 时,尽量选择和问题匹配的 Agent。例如前端问题找前端 Agent,文档问题找文档 Agent,项目总结找项目助理 Agent。

侧栏对话导航可以在 多会话模式 和其他会话列表模式之间切换。多会话模式下用 新建会话 开新对话,历史会话可以再打开、重命名或归档。归档后出现轻提示,可以当场撤销,不会弹出对话库做二次确认。归档后的会话仍只读,不能再发新消息。侧栏中不可用的 Agent 可以移除,不影响历史会话是否仍可打开。具体菜单以线上为准。

任务里发起的对话也会出现在「对话」列表中,但只显示由你发起的那些。点某一行会打开那一行自己的任务和对应会话,不会跳到列表里的第一条。

小助手对话会标明当前是 本机 还是 远程。本机时,助手可以按本机路径打开文件;远程时,需要的文件以附件等方式提供。普通 Agent 对话没有这个标识。

侧栏布局可以在 任务优先 和 聊天优先 之间切换。入口在导航的 自定义导航 / 布局模式。改完会同步到账号。聊天优先时,「对话」在更靠前的位置;原来的首页会显示为「任务」。

主侧栏的「对话」模块

主侧栏有一个 对话 模块,把你的对话集中在一处:你在任务里发起的对话(指派给 Agent / 小队的任务、快捷指令、在评论里 @ Agent 发起的对话),以及和 Agent / 小队的直接对话,都按最近活跃排列在这里。相当于一个对话指挥台,不必逐个任务去翻进展。

每一行分两行显示:

  • 第一行是标题:任务对话行带任务状态和任务类型图标,标题就是任务名;直接对话行显示会话标题(没有标题时显示对方的 Agent 名)。行尾是负责的 Agent / 小队头像;
  • 第二行是当前状态(工作中 / 排队中 / 等你回复 / 等你审阅 / 执行异常 / 已完成)、最新一条消息的摘要和活跃时间。交接状态只对需要处理的人显示「等你…」,其他人看到的是「等待人工…」。

行为规则:

  • Agent 有新进展的对话(开始工作、排队、等你处理、执行异常)会排到列表顶部;只是有新消息、不需要你处理时,头像下角显示绿色未读点;
  • 悬停一行,行尾的时间会变成 ✓ 完成 按钮。点击后这条对话标记为已完成,从列表中消失(任务对话同时会在任务侧标记为已完成);
  • 长时间不活跃的对话(没有进行中的状态、没有未读)会自动收进末尾的 更多 (N),点开可以回看、继续对话或标记完成;被收起的对话一旦有新进展,会自动回到列表;
  • 点模块标题可以把整个模块折叠,折叠后标题旁按状态汇总显示图标;标题行尾的 + 可以直接新建对话。

任务对话行点击后直接打开该任务的详情和对应对话;直接对话行则在首页右侧打开聊天面板。Agent 在任务对话里的消息和交接状态不再进入收件箱,这个模块就是查看它们的日常入口。

对话工作目录

对话输入区可以用文件夹入口打开 设置工作目录,为这一次对话选择目录,而不改 Agent 的默认工作目录。

  • 跟随 Agent 默认设置:使用 Agent 运行设置里的默认工作目录。未指定时,入口只显示文件夹图标。
  • 指定工作目录:在 选择工作目录 弹窗里从 Agent 运行的那台电脑上选择文件夹。指定后,入口会显示目录名。目录输入框下方可以用单选切换 Worktree 隔离运行(并行) 或 直接该目录运行(串行),也可以继续跟随 Agent 默认。

在 Web 端,或在别人的电脑上和 Agent 对话时,弹窗通过那台电脑的本地服务逐级列出文件夹,只显示文件夹;可以用面包屑回到上级,也可以直接粘贴绝对路径跳转。本机桌面端仍使用系统自带的目录选择框。只有这台电脑的所有者,或电脑共享给了当前组织、当前用户所在空间时,才能浏览和指定目录;没有权限时不会出现这个入口。主目录、系统根目录这类受保护目录可以进入,但不能直接作为工作目录。

电脑离线、本地服务没有响应,或本地服务版本过旧、不支持浏览目录时,弹窗会按具体原因提示(目录不存在、不是文件夹、本地服务没有读写权限等),并保留 手动输入路径 作为兜底。Agent 的默认工作目录仍在 Agent 工作目录 中配置。

对话发出第一条消息后,工作目录不能再中途切换:入口会置灰,悬停提示「已开始的对话不能中途切换工作目录,请新开会话后切换」。需要换目录时,请新开一个会话。

Slash 命令

对话输入框输入 / 会打开命令菜单,按分组列出当前 Runtime 可用的技能和命令:

  • 技能:选择已安装的技能,插入后随消息一起发送;
  • Agent 命令:该 Runtime 提供的命令(例如 /new),选中后插入输入框,发送即执行。

菜单按名称匹配排序,Tab 选中,Esc 关闭。电脑离线或读不到命令列表时,菜单会说明原因,恢复后可以重试。具体命令清单取决于所连 Runtime,以线上为准。任务详情里的对话同样可以使用 Slash 命令。

从任务详情开始

任务详情里也可以和 Agent 对话,不必先把任务指派给 Agent 或小队。

对话在任务详情右侧面板里打开,不在「动态 / 对话记录」这两个 Tab 里。对话记录 Tab 会列出这个任务下的所有 Agent 对话,包括在评论里 @ 触发的那条。面板顶部是 召唤 Agent 的入口和历史对话列表:

  • 历史对话默认列出最近几条,更多记录收在更多 (N) 里;这个任务还没有历史对话时,这块不显示;
  • 新对话 可以搜索当前空间内的 Agent 或小队,在当前任务上再开一条对话;召唤 Agent 菜单里的 选择 Agent 新开对话 是同一个用途。同一个 Agent 在同一个任务上可以有多条对话,互不覆盖;名单上会显示对方在这个任务上已有几个对话。

列表里每行的会话状态就是这条对话现在需要你做什么。点它会打开操作菜单,例如打开会话、标记为「已完成」、查看执行日志、重试、停止执行、直接移除该标识;具体有哪些动作取决于这条对话当前的状态。「标记为『已完成』」会直接把状态改为已完成,不再发送消息;把任务对话标记为完成时,对应任务也会一并标记为已完成。菜单里还可以用快捷回复,把一条常用回复直接发到这条会话。任务标题栏不再重复显示同一状态。

具体面板标题、按钮文案和列出的条数以线上为准。

打开一条对话时默认直接落到最新消息,不用每次手动往下滚;更早的内容会在往上翻时按需加载。

对话列表每一行会显示这条对话当前的状态(工作中 / 排队中 / 等你回复 / 等你审阅 / 执行异常 / 已完成);回复消息时也可以同时带上新状态,只要有新消息发出,旧状态会自动清除。由快捷指令产生的对话显示指令名,而不是 Agent 名。

当前空间里还没有可用的 Agent 或小队时,召唤 Agent 菜单仍然会出现,展开后说明暂无可用的 Agent 或小队,并给出 新建 Agent;还没有快捷指令时显示「没有可用的快捷指令」,而不是只剩管理入口。

通常不需要自己找入口:

  • 把任务指派给 Agent 或小队后,它开始执行时会自动展开右侧对话面板;
  • 打开任务时,如果这个任务上有需要你处理的对话(例如 Agent 在等你回复或审阅、你有未读回复、在对话里被 @),也会自动展开。

自动展开的触发条件可能随版本调整,这里不逐一列举;以线上实际行为为准。

容器宽度足够时,任务和对话默认按 5:5 分栏,中间的分隔条可以拖拽调整。容器宽度小于 700px 时,对话改为抽屉从右侧打开,任务标题上方的入口和提醒仍然可用;移动端抽屉里还提供 返回任务,返回后仍停留在同一个任务详情,不会丢掉上下文。

这条对话和独立会话一样,可以在输入区切换 Runtime 和模型;模型选择器里也能设置思考深度(模型公布思考深度时)。「选择 Agent 新开对话」和快捷指令也支持切换。

这条对话和动态里的评论是两套数据:

  • 对话记录不会出现在任务评论里;需要团队都看到的结论,仍要写进评论或任务描述。
  • 被指派的 Agent 干活时,默认走这条对话;换处理人后,旧对话仍留在对话面板的历史对话列表里,可以再打开。
  • 这条对话中的 Agent 回复,以及等人回复、等待审阅或执行失败等对话相关提醒,优先通知该对话的发起人;如果对话由任务处理人发起,收件人就是 Assignee。不会因为关注任务而广播给其他关注者或曾参与者。在任务评论里 @ Agent 也会打开或继续这条任务对话,而不是只在评论区等待回复。

离线 Agent 会直接提示已离线,不会显示「正在思考」或「排队中」。离线、启动中,或输入区上方出现「状态异常」时,提示会带 去查看,用来打开对应电脑或 Runtime 详情。任务对话、侧栏、普通 Agent、助手和小队入口的展示一致。如果电脑在线,但所选 Runtime 的 CLI 不在这台电脑上,输入区会提示该电脑上没有对应 CLI,而不是「该 Agent 已离线」。已归档 Agent 不能发新消息,输入框会禁用;历史仍可看。小助手 的对话仍属于助手;即使组织里已经没有其他自定义 Agent,助手会话也不会变成「该 Agent 已归档」。

Agent 开始执行前,对话里会显示一个「准备环境」进度分组,把等待、准备、当前步骤和耗时分开展示,例如克隆仓库、创建 worktree、检出代码;完成后可以展开回看。这些步骤不必再到电脑终端里确认。

把鼠标移到对话或任务里的 Agent 头像上,悬停卡片里可以选择打开设置。内置小助手没有这项入口。

执行过程和工具调用

Agent 回复里会带上这次执行的过程,例如它读了哪些文件、搜了什么、跑了什么命令。

  • 执行过程中,过程默认折叠成一行摘要,只有当前正在进行的步骤展开;这一轮结束后整段收成一行摘要,摘要上会显示这一轮跑了多久,可以点开看完整步骤。
  • 读取文件、搜索文件、打开网页、运行命令等工具各有对应的卡片,结果显示在卡片里,不必展开原始报文。
  • 需要看工具调用的原始参数或原始返回时,从卡片上的原始数据入口查看;默认不会直接铺开在对话里。

如果这一轮异常结束(运行失败或被中断),回复里已经产生的过程输出仍会保留,而且这段过程会保持展开、不会自动收起,直接就能看到做到哪一步;失败说明显示在过程下方,不会只剩一段空白。Agent 调用工具时报错不算异常结束,那一轮仍会照常收起。

快捷指令

任务详情头部工具条还有 快捷指令(星标、复制 ID 附近;具体图标以线上为准)。它会带着当前任务上下文,运行指定的 Agent 或小队;和独立会话、任务里的普通对话不是同一入口。

菜单按收藏分组:主列表只列出你收藏的快捷指令,其余(包括同事共享的和你自己未收藏的)收在 … 更多快捷指令 里,悬停展开后同样可以直接点用。收藏是个人视角:你收藏哪几条、按什么顺序排,只影响你自己的菜单;同一条共享快捷指令被不同人收藏互不影响。还没有任何收藏时,主列表为空,所有指令都在「更多快捷指令」里;新建的快捷指令会自动出现在收藏列表最前面。底部是 管理快捷指令。

每条快捷指令包含:

  • 功能名
  • 提示词(可留空,留空则只发送任务上下文)
  • Agent / 小队
  • 可见性:私有(仅本人可见、可触发、可编辑)或共享(本空间所有人能看到并触发;只有创建者能改)

点某一条后,任务详情会变成左任务、右对话。系统会把该条的提示词、指定 Agent 或小队、以及当前任务上下文发给对方。右侧可以继续追问,也可以换一个快捷指令。

每次触发快捷指令,都会通过当前任务的对话流程创建一条任务级独立会话。它会在该任务的对话记录中保留,不会复用被指派 Agent 的对话,也不会复用通过 选择 Agent 新开对话 手工开的对话。需要继续查看或追问时,请从当前任务重新打开相应记录。

刷新后会恢复上次选中的快捷指令,但不会重发。已经产生的对话可以再打开。Agent 离线时不能发送,输入框会提示离线。删除某条快捷指令,不会删掉已经产生的对话。

在 管理快捷指令 里,收藏的指令排在上面一组,可以拖动调整顺序,顺序就是任务菜单里的先后;未收藏的排在下面一组,悬停某条会出现 +收藏,点一下即加入上面的分组,已收藏的悬停可以 取消收藏。升级后,你自己创建过的快捷指令会自动进入收藏,顺序保持不变。

分享已完成的对话内容

可以从一条已完成回复的分享入口进入选择模式,选择一条或多条要分享的对话内容。界面显示与所选回复关联的提问、图片或附件时,它们会按界面所示随所选内容加入分享。正在生成、已停止或未完成的回复不能分享。

创建分享时,选择链接可见范围:

  • 获得链接的任何人:任何拿到链接的人都可以访问;
  • 仅组织成员:只有已登录的当前组织成员可以访问。

随后可以复制链接,或创建分享图片。分享是创建时的快照,后续对话、编辑或新增内容不会改变已生成的分享页。选择取消分享会使该内容当前所有有效分享链接失效。

分享前请检查内容。不要公开密码、Token、API Key、私钥、个人信息、内部日志或未经脱敏的截图;「获得链接的任何人」的链接应视为可能被外部人员访问。

发送附件时,如果附件无法直接预览,请使用下载而不是打开。点击后会显示下载反馈;下载完成后,桌面端会自动打开下载目录并定位或选中文件。下载目录行为取决于操作系统权限和桌面端能力;如果没有自动定位,请到系统下载目录查找。

Agent 也可以在对话里发送文件。你收到后,无法直接预览的附件同样使用下载。从飞书、钉钉、企业微信、Slack 或微信触发的对话中,Agent 发出的文件会回到原来的会话。Slack 若使用较旧的机器人,可能需要在集成页重新连接或新建 App 后才能发文件,以线上提示为准。

快捷回复

独立会话(小助手、Agent 私聊、小队聊天)和任务详情对话的输入区都可以使用快捷回复,规则和评论里相同:

  • 点条目文字:直接发送;
  • 把鼠标移到条目上会出现「插入」,提示是「仅将内容插入到输入框,不直接发送」;
  • 点插入:内容写入输入框并聚焦,不会发送,改完后再手动发出。

快捷回复有两个归属。个人全局按个人保存,在任何输入区都能用;当前 Agent 归属于对话中的 Agent,所有能使用这个 Agent 的人共享,可以一起新增、编辑、删除和排序。打开「管理」后可以在两个标签页之间切换。使用时,如果当前 Agent 和个人都有快捷回复,会分成「来自 Agent」和「来自个人」两组展示,Agent 组在前;只有一方的快捷回复时不分组直接展示。评论、回复和小队聊天里的快捷回复始终是个人全局。任务详情头部的 快捷指令 是另一件事,见上文。

对话和任务的区别

对话和任务都可以让你和 Agent 协作,但用途不同。

  • 对话:适合临时询问、探索、讨论方案和整理思路;
  • 任务:适合需要跟踪、分配、执行、验收和长期留痕的工作。

对话更像“先聊清楚”;任务更像“正式推进”。

如果你希望 Agent 修改代码、运行测试、交付结果,最好把要求写进任务,并把任务指派给 Agent。这样状态、对话记录、结果和后续 review 都会留在任务里。

把对话结论转成任务

对话不会自动变成任务。

当对话中出现明确行动项时,建议手动创建任务,或把结论复制到已有任务中。

创建任务时,可以把这些内容带过去:

  • 背景:为什么要做;
  • 目标:要完成什么;
  • 范围:哪些内容在范围内,哪些不在;
  • Agent 已经调研出的结论;
  • 建议方案或下一步;
  • 验收标准。

例如,你可以先在对话里问:

帮我看一下为什么任务列表加载慢,先不要改代码,只整理可能原因和建议排查路径。

如果 Agent 给出了清晰结论,再创建任务:

根据刚才的调研,排查任务列表加载慢的问题。优先检查任务查询和筛选条件,整理影响范围,并提出修复方案。先不要直接改代码。

对话中的 Agent 能做什么?

在对话中,Agent 可以帮你:

  • 解释概念或代码背景;
  • 拆解需求;
  • 总结资料;
  • 生成任务草稿;
  • 制定排查计划;
  • 对比几种方案;
  • 产出可以复制到任务里的描述、验收标准或评论。

对话更适合思考和整理,不适合作为正式交付记录。正式执行和验收仍建议回到任务。

常见问题

对话里的内容团队都能看到吗?

跟 Agent 的对话仅你可见。需要团队了解的上下文,你可以让 Agent 创建为任务。

对话可以直接触发 Agent 执行任务吗?

对话可以让 Agent 协助分析和整理,但需要被跟踪、验收的执行工作,建议创建任务并指派给 Agent。

什么时候应该从对话切到任务?

当你已经知道要做什么、需要谁负责、希望有状态和结果记录时,就应该切到任务。

对话里的结论会自动保存到任务吗?

不会。你需要手动创建任务,或把关键结论复制到已有任务中。

没指派 Agent 的任务能不能聊?

可以。任务详情里可以直接找空间内的 Agent 开始聊,不必先指派。

任务里的对话和评论有什么区别?

对话记录不是任务评论。评论会出现在任务动态里,给团队看;任务上的 Agent 对话及相关交接提醒定向通知该对话的发起人,如果由任务处理人发起,通常就是 Assignee,不会因为关注任务或曾参与对话而广播给其他人。需要全员看到的结论,写进评论或任务描述。

离线或已归档的 Agent 会怎样?

离线 Agent 会提示已离线,而不是显示正在思考或排队中。离线或启动中的提示里可以打开对应电脑。如果电脑在线但缺少对应 CLI,会提示该电脑上没有该 CLI,而不是 Agent 已离线。已归档 Agent 不能发新消息,输入会被禁用;历史对话仍可查看。侧栏中不可用的 Agent 可以移除,历史会话仍可打开。归档组织里最后一个自定义 Agent 后,小助手 的会话仍可继续,不会被当成已归档 Agent。

别人能看到我的私有快捷指令吗?

不能。私有快捷指令只有创建者能看到、触发和编辑。共享快捷指令对本空间成员可见,但只有创建者能改。

删掉快捷指令后,历史对话还在吗?

还在。删除的是这条快捷指令的配置,已经产生的对话不会一起删掉。