ClavueClavue
CLI · TUI · models

第一次代理聊天会话

学习如何打开代理聊天,选择Clavue模型,使用@引用文件,并通过工具确认执行第一个安全任务。

入门Agent Workflows
agent-chataigetting-started

imux 中的代理聊天提供了一个对话式界面,用于通过 AI 模型处理编码、调试和系统管理任务。与标准终端不同,代理聊天可以自主规划和执行多步操作,同时在关键操作时让您参与审核。

在本教程中,您将通过连接 Clavue 模型、引用工作区中的特定文件以及运行低风险任务来设置您的第一个会话。您还将学习如何阅读和批准工具确认,确保代理执行的每一个操作都是有意且安全的。

通过本指南,您将了解 imux 代理聊天的基本工作流程,包括如何管理上下文、验证输出以及为更复杂的多代理工作流做准备。

准备条件

  • macOS 上已安装 imux
  • 拥有活跃会员资格的 Clavue 账户
  • 至少包含一个文本文件的本地项目目录

操作步骤

  1. 01

    打开代理聊天并选择模型

    启动 imux 并导航至代理聊天界面。点击右上角的模型选择器,选择一个适合您的任务的 Clavue 模型。对于一般的编码辅助,推荐使用标准模型如 clavue-3.5。确保您的会员资格有效以访问这些模型。

  2. 02

    设置工作区上下文

    代理聊天需要知道处理哪些文件。在 imux 的文件浏览器中打开您的项目目录。如果您尚未设置工作区,请参考 first-workspace-setup 指南。单击要引用特定文件,或在聊天输入框中使用 @ 符号显式添加文件到上下文(例如 @main.py)。

  3. 03

    编写安全任务

    在聊天输入框中输入清晰、简洁的指令。对于您的第一次会话,选择一个低风险的任务。例如:“读取 main.py 的内容并总结关键函数。” 避免修改系统配置或删除文件的命令。这可以确保您可以在不冒数据丢失风险的情况下观察代理的行为。

  4. 04

    审查工具确认

    发送提示后,imux 将显示代理的计划及其打算执行的任何工具调用。您将看到每个工具执行的确认对话框(例如 Read FileWrite File)。仔细阅读操作的详细信息。如果操作看起来正确,点击“批准”。如果看起来不安全,点击“拒绝”。

  5. 05

    验证并迭代

    批准后,代理执行工具并返回结果。在聊天窗口中查看输出。如果结果不符合预期,您可以通过后续问题或更正进行回复。代理将使用新上下文优化其响应。这种迭代过程是有效代理辅助开发的关键。

  6. 06

    探索高级上下文

    既然您已经完成了基本会话,尝试通过 @ 或通过侧边栏选择多个文件添加到上下文。您还可以使用 /help 等斜杠命令查看可用选项。对于更复杂的任务,请考虑探索 multi-agent-workspace 指南,了解不同代理如何协作。

了解工具确认

工具确认是 imux 中的一个关键安全功能。它防止代理在您明确同意之前执行破坏性操作。始终在批准之前审查文件路径和内容修改。如果您对某个工具调用不确定,可以在继续之前要求代理澄清。

使用 @ 进行文件上下文

@ 符号是一种向代理提供上下文的强大方式。通过引用特定文件,您可以帮助代理了解您的请求范围。您可以通过用空格或逗号分隔来引用多个文件。这在调试或重构任务中特别有用,因为代理需要查看相关代码。

安全最佳实践

使用代理聊天时,始终从低风险任务开始。避免授予代理访问敏感系统目录或生产数据库的权限。使用 diff-application-workflow 在应用更改之前审查更改。经常检查终端日志中的代理操作,以确保它们与您的意图一致。

实用提示

  • 使用 `@` 符号快速将文件添加到聊天上下文,无需离开当前页面。
  • 始终在点击“批准”之前阅读工具确认的详细信息。
  • 从简单的只读任务开始,以熟悉代理的行为。
  • 使用 `/help` 命令查看可用的斜杠命令和选项。

常见问题

如何将多个文件添加到聊天上下文?

您可以通过键入 @ 后跟文件名(用空格或逗号分隔)来添加多个文件。例如:@main.py @utils.py。您还可以在文件浏览器中选择多个文件,然后右键单击以将它们添加到聊天中。

代理可以在没有确认的情况下删除文件吗?

不可以。imux 要求对所有工具调用进行明确确认,包括文件删除。在执行任何破坏性操作之前,您将看到确认对话框。如果操作看起来不安全,您可以拒绝该操作。

代理聊天中有哪些可用模型?

代理聊天支持各种 Clavue 模型。您可以从右上角的下拉菜单中选择模型。特定模型的可用性可能取决于您的会员级别。

如何停止代理执行任务?

您可以通过点击“停止”按钮来停止代理。这将立即终止当前正在进行的工具调用和响应生成。

代理聊天对生产代码是否安全?

代理聊天旨在用于开发辅助。虽然它包括工具确认等安全功能,但不应用于直接修改生产系统,除非经过严格审查。始终先在开发环境中测试更改。