Agent 快速开始
配置模型并完成第一个 Agent 会话。
Agent 可以读取项目上下文、调用应用工具、运行命令并协助修改文件。它能做什么取决于当前模型、权限模式、MCP、Skills 和会话状态;开始前至少需要配置一个已启用的模型提供商。
第一次使用
配置提供商
打开“设置 → Agent”,在模型提供商区域添加 Provider。选择服务端实际支持的协议,填写 API 地址和凭据并保存。
Provider 只描述服务端连接;模型在单独的模型策略中选择。保存 Provider 后,再选择默认 Provider 和模型。
新建会话
点击会话列表上方的“新建”按钮,或者在输入框执行 /new。如果没有配置默认模型,仍可创建会话,但需要点击输入框旁的模型按钮或执行 /model 后才能发送消息。
应用会根据当前页面和已有实例确定可用的项目上下文,不需要在新建会话时选择任意工作目录。
发送任务
写明目标、允许修改的范围和验收方式,然后按 Enter 发送。需要换行时使用 Shift + Enter。也可以附加图片、引用文件或为本轮选择 Skill。
推荐的任务写法
请检查登录页面无法提交的问题。
只修改前端登录模块,不调整后端接口。
修复后运行相关单元测试,并说明修改了什么。一个容易验证的任务通常包含:目标、范围限制、需要保留的行为以及验证命令。涉及发布、删除、外部消息或账号操作时,还应写明准确目标。
执行过程中看什么
- Agent 的说明文字用于汇报当前判断和下一步动作。
- 工具卡片显示命令、文件操作、审批结果和输出;展开卡片可以查看详细内容。
- 输入框为空时,主按钮可停止当前回答;输入了新内容时,消息会先加入队列,不会自动打断正在进行的回答。
- 长时间命令可能转为后台终端。关闭 Agent 面板不代表进程已经停止,应使用
/ps检查、使用/stop清理。 - 最终回答和工具的终态共同说明任务是否完成;不要把“工具已经开始运行”当作成功。
权限不是正确性保证
更高权限只会减少审批步骤,不代表命令、文件修改或外部操作自动安全。允许操作前应核对目标、参数和风险提示,完成后仍需检查差异和测试结果。