开始之前
- 为你正在使用的智能体打开代码运行器。
- 聊天中的 权限 标签决定智能体何时先征求你的同意。请求批准 会在运行命令前询问,替我批准 只在操作看起来不安全时询问。参阅批准操作。
- 要将智能体的命令限制在工作文件夹内,避免接触你的密钥和其他应用,请在同一标签中开启 沙盒。参见智能体沙盒。
运行命令
给智能体一个文件夹和一个具体的任务:在我的示例项目里运行现有的测试命令并报告结果。不要修改文件。智能体会显示命令的输出,并告诉你它已经结束还是仍在运行。要阅读、编辑和搜索文件,智能体会改用文件工具。
命令如何运行
每个命令都在伪终端中运行,因此需要输入的命令可以直接得到回应,无需启动新进程。
如果结果中有
status: running 和一个 session_id,说明进程仍在运行。智能体可以 read 它的输出、向它 write 输入,或 stop 它。要回应提示,智能体需要向该会话写入;启动另一个命令并不能回应它。
等待任务完成
当任务需要等待时(例如等待构建写入输出或服务器启动),智能体会使用 Wait For 工具,而不是在 shell 中循环等待。它会在不运行命令的情况下等待以下任一条件:- 出现指定文件
- 日志文件中出现某一行
- 某个进程或命令会话结束
- 某个端口开放,或某个地址响应
工作文件夹与时间限制
如果智能体设置了workDir,命令就在其中运行,否则在聊天的工作文件夹中运行。它们使用你的 shell,并已配置好你的项目和 Python 虚拟环境。除非在同一会话中运行,不同的命令不会共享临时的 shell 变量。
首次等待时间与命令的硬性时间限制是分开的。oneshot 命令最多等待 30 秒获取结果;如果到时仍在运行,智能体会拿到目前为止的输出,而任务会继续执行。命令默认在 30 分钟后被停止。对于服务器或监视进程,请使用 long_running 模式,而不要把它当作失败了的 oneshot 命令。
设置
打开 设置 → 插件 → Code Runner。
如果压缩后的输出中缺少你需要的细节,请要求运行更有针对性的命令,或查看日志中的相关部分。输出被截断并不能证明命令执行成功。
故障排除
相关内容
文件与文件夹
让智能体查找、阅读和编辑文件。
智能体
设置智能体的工具,以及它何时先征求同意。