Skip to content

3.1 新建会话与第一条指令

本节目标

新建一个会话,向 agent 发出第一条指令,亲眼看着它在你的工作区里读文件、跑命令、给你交差。

第一步:新建会话

主界面左上角是新会话按钮,点它创建一个全新会话。每点一次就是一个独立对话,各自的上下文互不干扰。

新建后,对话区显示欢迎页,底部输入框已经解锁(工作区选好后输入框就可用)。输入框里有句提示:描述你想要构建的内容

会话输入框

第二步:输入第一条指令

在输入框里输入你的第一句话。第一次用,推荐这种"总结式"的指令,只读、安全、立刻见效:

列出当前工作区目录下的文件,并简要说明这个项目是做什么的

也可以换成任何你想让它干的事,比如:

类型示例指令
读懂项目"总结这个仓库的模块结构"
找东西"找出所有写着 TODO 的地方"
改东西"把登录页的标题改成 欢迎回来"
跑任务"运行测试并汇报结果"

指令写得越具体越好

agent 是按指令干活的,指令含糊它就只能猜。想要它干什么、范围在哪、产出什么格式,一次性说清楚,后面省很多来回。

第三步:发送并观察

输入好后按 Enter 发送(或者点发送按钮)。消息发出后,你会看到两件事同时发生:

  1. 你的消息出现在对话区
  2. 消息下方开始滚动出现一串工具行,这是 agent 干活的轨迹

指令发出后,agent 开始运行

第一次跑会花一点时间。它要先思考你的指令,再调用工具去看工作区里的文件,最后汇总成回答。短任务十几秒,长任务几分钟都正常。

第四步:等它交差

agent 完成后,对话区会留下完整的记录:你的问题、它调用工具的每一步、最后的回答。底部还有一行统计信息,告诉你这次任务用了多久、调了多少轮工具、消耗了多少 token。

你的第一条指令,通常会让 agent 列出工作区并介绍项目。它的回答可能超出预期地详细,这正是它"真在干活"的证据。

常见问题

问:发送后没有反应?

先确认底部状态区显示的是你的模型(比如 DeepSeek-V4-Flash),不是"未配置"。如果模型没配置好,回到 1.1 节检查密钥。

问:agent 运行了很久还没停?

任务复杂时它会在多个工具间来回,属正常。想让它停下来,界面有停止按钮,点一下即可。也可以在指令里限定范围,比如"只看 README 就行"。

问:能让它别乱改文件吗?

能。权限设置控制 agent 能做什么,4.4 节讲审批,7.2 节讲权限预设。初期建议先用只读类指令(读、查、总结),熟悉了再放开。

小结

  • 新会话建对话,输入框解锁后就能发指令
  • 指令越具体,结果越可控;首次建议用只读的总结类指令
  • 发送后注意观察工具行,那是 agent 干活的轨迹,下一节细讲

第一条指令已经跑通,下一节我们仔细看看那些工具行到底在干什么。

发现错误?提交反馈 · 欢迎 提 PR 改进本书