AI Agent模式使用指南：从入门到精通的完整教程

要激活Trae的AI Agent模式，你需要完成几个关键配置。这个功能的核心在于将复杂任务自动化分解与执行，但前提是系统环境与参数必须正确设定。

一、检查Trae版本兼容性

首先，确保你的Trae应用版本不低于2.4.0。AI Agent模块自该版本起引入，旧版本内核不支持其调度与执行框架。

验证路径：打开Trae，进入“设置”>“关于Trae”，查看当前版本号。若版本低于2.4.0，请前往官网下载最新安装包进行覆盖升级，以确保底层API支持。

二、启用AI Agent开关

版本确认后，需在系统内激活Agent功能开关。此操作将加载AI任务规划与工具调用引擎。

启用步骤：在设置界面，导航至“AI实验室”选项卡，找到“AI Agent模式”选项。将其切换为开启状态。根据提示重启应用，以完整加载Agent运行时环境。

三、配置默认Agent角色

开启功能后，需为AI Agent设定一个默认行为角色。角色模板定义了其任务处理逻辑、工具使用权限与交互风格，是触发其自主工作流的基础。

配置方法：进入“AI Agent模式”设置页面，点击“角色模板”下拉菜单。根据你的核心场景，选择一个预设角色，如“数据分析师”或“流程自动化助手”，并点击“设为默认”。此配置将应用于你发起的后续所有会话。

四、通过自然语言触发Agent执行

配置完成后，即可通过自然语言指令驱动Agent。其内置的语义理解模块会自动解析复杂意图，并拆解为可执行的任务序列。

操作示例：在主输入框中直接描述多步骤任务，例如：“分析本月销售数据，生成趋势图表并同步至团队看板”。系统识别到复杂指令后，界面将显示“Agent任务规划中…”的提示，并在反馈面板中实时展示任务分解与执行进度。

五、手动调用Agent专用命令

对于需要精准控制的结构化任务，你可以绕过自然语言解析，直接使用专用命令进行调用。

调用流程：在输入框中键入“/”调出命令列表，选择“/agent-run”命令。随后，以JSON格式输入精确的任务指令，例如：{"tool":"calendar","action":"schedule_meeting","params":{"title":"项目复盘","duration":"60"}}。Agent将直接调用指定工具并执行定义好的操作。